Documentation newbie; SGML how-to?
Peter N. M. Hansteen
peter at bsdly.net
Mon Jan 8 19:38:48 UTC 2007
Nathan Vidican <nvidican at wmptl.com> writes:
> Herein lies the new challenge for me; what documentation tools are
> everyone using to generate documents the likes of the FreeBSD FAQ and
> Handbook? From what I understand it's SGML, (a new language to me -
> but no fears there), but what authoring tools are out there; what's
> best to use? What's easiest to get along with, and is there a
> collection or package one can utilize for stylesheets, templates, etc?
> Are indexes and HTML output generated by hand, or manually? etc...
The FreeBSD Documentation Primer[1] is a good place to start. The
tools used are mainly the DocBook DTD and well known sgml tools, all
available via the ports system.
[1] http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/
--
Peter N. M. Hansteen, member of the first RFC 1149 implementation team
http://www.blug.linux.no/rfc1149/ http://www.datadok.no/ http://www.nuug.no/
"First, we kill all the spammers" The Usenet Bard, "Twice-forwarded tales"
delilah spamd[29949]: 85.152.224.147: disconnected after 42673 seconds.
More information about the freebsd-doc
mailing list