To receive notifications about scheduled maintenance, please subscribe to the mailing-list gitlab-operations@sympa.ethz.ch. You can subscribe to the mailing-list at https://sympa.ethz.ch

Commit 6b4853f0 authored by Bengt Giger's avatar Bengt Giger
Browse files

More README changes

parent e62876e6
# laweb
# *Laweb*: LaTeX to Pressbooks Conversion
Publish LaTeX documents in Pressbooks, a Wordpress plugin.
Publish LaTeX documents in *Pressbooks*, a Wordpress plugin.
---
![Screenshot of Pressbooks publication created with Laweb](static/Screenshot_Pressbooks-01.png)
......@@ -30,15 +30,15 @@ It is important to note that the content imported to Pressbooks **may not be edi
# Overview
*Laweb* combines the unmatched presentation of scientific documents with the publication abilities of Wordpress.
## Why use Laweb?
## Why use *Laweb*?
While it is possible to simply convert a LaTeX document into HTML and put it on a static webserver, this approach
has some drawbacks:
has some drawbacks. Some features of *Laweb* are:
- Laweb uses MathML and Mathjax for the rendering of mathematical equiations, resulting in a near to optimum presentation in different browsers
- usually, a conversion to HTML ends up in a single HTML document. Think of a document consisting of hundreds of pages! Laweb splits parts and sections into single pages and creates the navigation structure for Pressbooks.
- *Laweb* uses MathML and Mathjax for the rendering of mathematical equiations, resulting in a near to optimum presentation in different browsers
- usually, a conversion to HTML ends up in a single HTML document. Think of a document consisting of hundreds of pages! *Laweb* splits parts and sections into single pages and creates the navigation structure for Pressbooks.
- Images are converted to inline data embedded in the HTML. Losing references to images is impossible.
- Laweb ensures that link references remain functional and consistent across split up pages.
- Laweb converts links to http://ggbm/at/MATERIAL_ID to interactive [Geogebra](https://www.geogebra.org/) applets
- *Laweb* ensures that link references remain functional and consistent across split up pages.
- *Laweb* converts links to http://ggbm/at/MATERIAL_ID to interactive [Geogebra](https://www.geogebra.org/) applets
## Components
*Laweb* consists of two components:
......@@ -51,5 +51,5 @@ The LaTeX styles add information required by the XML conversion. The resulting X
Additionally, a Pressbook template with the ability to disable the `wpautop` function in Wordpress is required. Otherwise, the rendering engine of Wordpress will eliminate vital parts of the HTML during rendering.
## Example
See ... for the result of a Laweb conversion.
See ... for the result of a *Laweb* conversion.
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment