The distribution contains the following files:

  • latex2wp.py: the conversion program
  • latex2wpstyle.py: specifies typesetting options, and environments and macros recognized during the conversion
  • readme.txt: some basic information on how to use LaTeX2WP
  • terrystyle.py: sets the typesetting options in the style of Terry Tao’s blog.
  • macrosblog.tex: defines LaTeX commands recognized by LaTeX2WP for typsetting colors, links to URLs, and images, so that LaTeX files containing such commands can be typeset and previewed offline
  • example.tex: a sample post showing how to use the main functionalities recognized by LaTeX2WP
  • post-template.tex: a starting point for writing a post in LaTeX; it imports various packages and macros so that pictures, hyperlinks etc. can be seen in the preview the same way they will appear in the post.
  • knuth.png: a picture (from xkcd, Copyright Randall Munroe) required to preview example.tex
  • gpl.txt: the text of the GNU General Public License
  • changelog.txt: a list of changes from previous versions.

By looking at example.tex, it should be easy to see how to get started. Indeed, just starting to write LaTeX, and seeing what happens with the conversion should be fine.

Your mathematical posts do not have to look like mine. A number of stylistic changes can be made by editing latex2wpstyle.py (make a copy before editing it); comparing it to terrystyle.py, and reading the comments in the code, should help understand how to make such changes.

It is possible to add your own LaTeX macros, if they do not involve passing of parameters. It wouldn’t be too hard to add support for arbitrary LaTeX macros and environments, but right now I have run out of energy (maybe during the Summer).

Another limitation is that there is no support for footnotes, and no support for bibliographic references. I will definitely work on this during the Summer.

When LaTeX2WP cannot do what you want, you can always put HTML code in the scope of a \ifblog . . . \fi. The conversion will output such HTML code verbatim, and it will be ignored in the LaTeX preview. Conversely, anything in the scope of \iftex . . . \fi is compiled in the LaTeX preview but skipped in the conversion.