The Emergent Properties of Meat
Blog
Software
Hardware
About me
Photography
 Logos
Bigger projects: emc2 & AXIS
Friends' pages:
Alex
Bill
Chris
Jon
Michael
Email me: jepler@unpy.net

« Onscreen Crosshairs in tcl/tk | Newest entries | Computers and minds »

Terrible HTML documentation
Having recently tried to write some documentation, I'm a bit struck by how much all the alternatives I'm aware of suck. All I want is to get a nice HTML and PDF output of a document with a few tables. Some signs pointed towards this thing called "openjade", which is a "document style semantics and specification language" (I guess).

Imagine how unimpressed was when I got a look at the documentation they had produced—If anybody is going to have good-looking documentation it should be the people making the "document style" software! At first I thought of blaming myself because I had a wide screen, but it's even bad on a maximized window on a 1024x768 monitor, with its black text over a terrible dithered dark blue background.

I guess I'll go back to writing HTML by hand and using "File > Print" to produce PDF. Or maybe I'll write LaTeX again and berate people who don't seem to know how to use xpdf.



Entry first conceived on 2 May 2006, 23:08 UTC, last modified on 3 May 2006, 14:05 UTC



Powered by the Emergent Properties of Meat. Copyright © 2004-2008 Jeff Epler
[æ]