Date: Wed, 13 Apr 2011 14:54:40 +0100 From: Gabor Kovesdan <gabor@FreeBSD.org> To: Mic <michael_is_98@mail.ru> Cc: freebsd-doc@freebsd.org Subject: Re: creating doc page Message-ID: <4DA5AB20.5000207@FreeBSD.org> In-Reply-To: <20110413022256.GA1859@mic.dummy.ru> References: <20110413022256.GA1859@mic.dummy.ru>
next in thread | previous in thread | raw e-mail | index | archive | help
Em 13-04-2011 03:22, Mic escreveu: > Hello! > > I decided to create my own help page about general settings of FreeBSD PC. > So, I've read "fdp-primer" book (and parts concerning DocBook). > DocBook seems to me very suitable for this task. > SGML file is ready, but some instruments for creating html page (openjade and tidy) are not so easy to involve. If you want to use DocBook for your own documentation, I encourage you to use a newer, XML-based version, preferably DocBook 5.0. That lets you customize the output easier through XSLT stylesheets. You can also use Apache FOP to generate a very fancy pdf. However, if this is something you want to submit to FreeBSD to be integrated into the documentation set, you cannot use XML because it is not supported in the doc tree yet. But in this case you don't have to worry because doc committers can take care of polishing the formal requirements of the document. Regards, Gabor
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4DA5AB20.5000207>