Questions answered by this recipe
This section is optional; use it to indicate the types of questions (if any) this recipe is intended to answer.
Can I use LaTeX-marked documents as PmWiki pages?
I wanted to be able to use the same source document to serve my webpages and to print. It is known that LaTeX can generate excellent printout quality, while HTML printing is, to say it gently, poor. However, reading onscreen the output of a LaTeX document is painful because TeX produces paper-oriented documents.
This recipe, which I am still developing, makes it possible to use a limited subset of LaTeX as an alternative markup. The wikipage source, marked in LaTeX, can be copied and pasted into a LaTeX editor so that you can print it neatly.
Conventions shared by both LaTeX and PmWiki are supported natively: line breaks and paragraph separation.
So far I have implemented the conversion of the following LaTeX markup:
- some font formatting styles (
- sectioning commands (
- figure insertion (
pictureenvironment) is possible, but the paths used by both systems are different and I have not figured yet how to solve the issue.
- By version 0.3 it should be possible to use all font-formatting markup using html entities,
- By version 0.6 it should be possible to use
\marginparand insert CSS styles to produce specific effects. The
abstractenvironment could be used to generated a page summary in the header. All special chars correctly escaped so that they work both ways.
- By version 0.9 it should be possible to map all LaTeX character entities into HTML entities. Specific LaTeX markup rendered as comments or ignored by HTML output.
- Version 1.0 should allow the use of any arbitrary LaTeX document (minus formulae) as a wiki document. Preamble ignored.
If the recipe has multiple releases, then release notes can be placed here. Note that it's often easier for people to work with "release dates" instead of "version numbers".
Initial, pre-Alpha, testing release. Help wanted.
- JoseGeraldo -- author