From owner-freebsd-doc@FreeBSD.ORG Mon Jan 8 19:38:48 2007 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 2E5CC16A407 for ; Mon, 8 Jan 2007 19:38:48 +0000 (UTC) (envelope-from peter@bsdly.net) Received: from skapet.datadok.no (skapet.datadok.no [194.54.107.19]) by mx1.freebsd.org (Postfix) with ESMTP id E0E8213C455 for ; Mon, 8 Jan 2007 19:38:45 +0000 (UTC) (envelope-from peter@bsdly.net) Received: from thingy.bsdly.net ([10.168.103.11] helo=thingy.datadok.no.bsdly.net ident=peter) by skapet.datadok.no with esmtp (Exim 4.62) (envelope-from ) id 1H3zyk-0002ro-QF; Mon, 08 Jan 2007 20:16:18 +0100 To: Nathan Vidican References: <45A291EF.6080502@wmptl.com> From: peter@bsdly.net (Peter N. M. Hansteen) Date: Mon, 08 Jan 2007 20:16:15 +0100 In-Reply-To: <45A291EF.6080502@wmptl.com> (Nathan Vidican's message of "Mon, 08 Jan 2007 13:48:15 -0500") Message-ID: <87bql9z5vk.fsf@thingy.datadok.no> User-Agent: Gnus/5.1007 (Gnus v5.10.7) XEmacs/21.4.19 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: freebsd-doc@freebsd.org Subject: Re: Documentation newbie; SGML how-to? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Jan 2007 19:38:48 -0000 Nathan Vidican 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.