Date: Mon, 08 Jan 2007 20:16:15 +0100 From: peter@bsdly.net (Peter N. M. Hansteen) To: Nathan Vidican <nvidican@wmptl.com> Cc: freebsd-doc@freebsd.org Subject: Re: Documentation newbie; SGML how-to? Message-ID: <87bql9z5vk.fsf@thingy.datadok.no> In-Reply-To: <45A291EF.6080502@wmptl.com> (Nathan Vidican's message of "Mon, 08 Jan 2007 13:48:15 -0500") References: <45A291EF.6080502@wmptl.com>
next in thread | previous in thread | raw e-mail | index | archive | help
Nathan Vidican <nvidican@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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?87bql9z5vk.fsf>