22

I am trying to generate my static website with LaTeX to avoid tedious/verbose HTML and underpowered markdown languages.

I know of latex2html and htlatex/TeX4ht for generating documents in the HTML format from LaTeX but neither are working with TikZ.

Does anyone here know how to get the TikZ diagrams working? Any tips on using LaTeX for static websites is also much appreciated.

EDIT: I now generate SVGs from the TikZ diagrams by inserting this line into my latex source:

\def\pgfsysdriver{pgfsys-tex4ht.def}

I like the idea of using SVG because of the resolution independence but I worry about the browser support.

andreasw
  • 453
  • If I understand correctly you want to write an entire web page in LaTeX, not just graphics and equations. In that case htlatex is probably the best out there. Can you describe what's not working with this approach? – Matthew Leingang Apr 05 '11 at 17:13
  • Also, there's no need to hate on HTML and markdown. They have their uses. :-) – Matthew Leingang Apr 05 '11 at 17:14
  • Can you explain in more detail what's going wrong with the TikZ diagrams? An example might help. I've been merrily converting TikZ diagrams to SVG for months now with narry a problem. – Andrew Stacey Apr 05 '11 at 17:21
  • 1
    @andrew-stacey, matthew-leingang The TikZ diagrams are ignored by htlatex. I am trying to have the TikZ figures converted to another format like png and linked from within the html. – andreasw Apr 05 '11 at 19:58
  • Please can you include an example! As I said, I've not had any trouble with this at all so without an example to test, it's hard to know why your TikZ diagrams are being ignored. (Also, I think you need to write my name as I do for the notification system to work: @Andrew Stacey) – Andrew Stacey Apr 05 '11 at 20:49
  • I had a suspicion that there might be something missing like the \pgfsysdriver! If you do some fun stuff with .htaccess you can figure out a system whereby those browsers that can handle SVG get SVG and the rest get PNG. But that's definitely off-topic! – Andrew Stacey Apr 06 '11 at 08:46

2 Answers2

9

My solution is far from perfect, but it has been simple and good enough for my needs.

I wrote a handout for a programming course using Sphinx (a documentation generator that uses reST as a markup language), and the diagrams using TikZ. The TikZ figures are compiled automatically and converted to PNG when generating the website.

For example, take a look at this page to see how the result looks like.

You can also take a look at the Makefile I use to compile the TikZ figures into PNG (.tex → .pdf using rubber, .pdf → .png using convert)

Roberto Bonvallet
  • 1,703
7

There is QuickLaTeX which allows the simple inclusion of (La)TeX math and also TikZ pictures inside WordPress websites. However, this wont help you much if you don't use WordPress.

For normal websites you could use the standalone class to convert TikZ pictures to PNG images which can then be included. See Compile a LaTeX document into a PNG image that's as short as possible for further information.

Community
  • 1
Martin Scharrer
  • 262,582
  • I was just saying much the same thing :-) – Joseph Wright Apr 05 '11 at 16:10
  • @andreasw: There are several plugins for WordPress - the reason I've picked QuickLaTeX for my own blog is that the LaTeX stuff is done on their server, and returned as an image. So there is no installation or similar to do. – Joseph Wright Apr 05 '11 at 16:12
  • @Joseph, andreasw: Maybe the same interface could also be used to include TikZ pictures as images into normal websites. Maybe worth asking Pavel Holoborodko, the author of QuickLaTeX, about it. – Martin Scharrer Apr 05 '11 at 16:15
  • 1
    @Martin: Very true. Pavel is very responsive - he did a few bug fixes for me when I mentioned QuickLaTeX in my blog, and uncovered some issues! – Joseph Wright Apr 05 '11 at 16:16
  • @Joseph: Much as things like this are a useful stopgap, they are an awful solution to the problem. Above all else, they don't produce accessible webpages. – Andrew Stacey Apr 05 '11 at 20:51
  • 1
    @Andrew: Not sure I follow in the context of Tikz diagrams! (In the general case, conversion of arbitrary LaTeX to other formats is pretty tough, so it's not exactly an easy problem to solve anyway.) – Joseph Wright Apr 05 '11 at 21:07