You are not logged in.

#1 2005-08-30 15:12:17

cactus
Taco Eater
From: t͈̫̹ͨa͖͕͎̱͈ͨ͆ć̥̖̝o̫̫̼s͈̭̱̞͍̃!̰
Registered: 2004-05-25
Posts: 4,622
Website

Docbook alternatives

I hate docbook. With a passion. The markup sucks, and the toolchain blows.

I like LaTeX quit a bit, but for quick documentation, it might not be the best. Admittedly, not everyone knows LaTeX markup, so it might be a barrier to entry for new projects, seeking documentation help.
I have also tried AurigaDoc. It is more "html-like" in its syntax.

I found this the other day too.. Looks interesting. I believe the lighttpd project uses it.
http://www.methods.co.nz/asciidoc/index.html

Anyway, I was just wondering what the rest of you out there might be using. I would go with plain html for documentation, but the exportability of it leaves much to be desired. I really do like being able to create a pdf of documentation (whether it be for a more printable form, submitting a work to a publication, etc).


"Be conservative in what you send; be liberal in what you accept." -- Postel's Law
"tacos" -- Cactus' Law
"t̥͍͎̪̪͗a̴̻̩͈͚ͨc̠o̩̙͈ͫͅs͙͎̙͊ ͔͇̫̜t͎̳̀a̜̞̗ͩc̗͍͚o̲̯̿s̖̣̤̙͌ ̖̜̈ț̰̫͓ạ̪͖̳c̲͎͕̰̯̃̈o͉ͅs̪ͪ ̜̻̖̜͕" -- -̖͚̫̙̓-̺̠͇ͤ̃ ̜̪̜ͯZ͔̗̭̞ͪA̝͈̙͖̩L͉̠̺͓G̙̞̦͖O̳̗͍

Offline

#2 2005-08-30 15:19:40

phrakture
Arch Overlord
From: behind you
Registered: 2003-10-29
Posts: 7,879
Website

Re: Docbook alternatives

Probably not what you're looking for, but I've heard alot about this:
http://skawina.eu.org/mikolaj/vst.html

It's a vim plugin for docutils (PKGBUILD in the AUR, thank you very much)

Offline

#3 2005-08-31 05:05:56

chane
Member
Registered: 2003-12-02
Posts: 93

Re: Docbook alternatives

I have on my todo list to look at alternatives to DocBook.  Here is one on my short list if you want to check it out:

http://dita-ot.sourceforge.net/

If you try it, I would be interested in what you think of it.

Chris....

Offline

#4 2005-08-31 06:11:26

cactus
Taco Eater
From: t͈̫̹ͨa͖͕͎̱͈ͨ͆ć̥̖̝o̫̫̼s͈̭̱̞͍̃!̰
Registered: 2004-05-25
Posts: 4,622
Website

Re: Docbook alternatives

hmm. Seems dita is closely coupled with the java fracework. That means no for me. I dont use java anymore.
/me shrugs

For in-code documentation, there is nothing finer, in my opinion, then doxygen. It just works great!

The search for me is for out of code documentation. Things like how-to guides, articles, books perhaps, design specifications, etc.


"Be conservative in what you send; be liberal in what you accept." -- Postel's Law
"tacos" -- Cactus' Law
"t̥͍͎̪̪͗a̴̻̩͈͚ͨc̠o̩̙͈ͫͅs͙͎̙͊ ͔͇̫̜t͎̳̀a̜̞̗ͩc̗͍͚o̲̯̿s̖̣̤̙͌ ̖̜̈ț̰̫͓ạ̪͖̳c̲͎͕̰̯̃̈o͉ͅs̪ͪ ̜̻̖̜͕" -- -̖͚̫̙̓-̺̠͇ͤ̃ ̜̪̜ͯZ͔̗̭̞ͪA̝͈̙͖̩L͉̠̺͓G̙̞̦͖O̳̗͍

Offline

Board footer

Powered by FluxBB