Date: Thu, 23 Apr 2009 12:52:51 -0400 From: Chen Xu <xuchen@brandeis.edu> To: G??bor K??vesd??n <gabor@FreeBSD.org> Cc: freebsd-doc@FreeBSD.org Subject: Re: what need to upgrade? Message-ID: <20090423165250.GA9664@brandeis.edu> In-Reply-To: <49F094F2.3030205@FreeBSD.org> References: <184b087c0904230720t5852baabxe3b3d7e74adb1c11@mail.gmail.com> <49F094F2.3030205@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Hi Gabor, thanks for the information. Yes, I have been using the FreeBSD doc infrastructure to build my own docs not related to FreeBSD. I use SGML. I have just updated the doc src and found that CSS was indeed changed. What you mentioned about DocBook 5 and DocBook XSLT stylesheets interested me. Could you provide a link or example what source code looks like? Regards, Chen * G??bor K??vesd??n <gabor@FreeBSD.org> [090423 12:19]: > Chen Xu escribi??: > > Dear list, > > > > I have a simple question here. I have been using doc system to build my own > > documentation for a few years now. But it doesn't take a few things like > > <tip> <warning> <note> etc., which I want too. > > > > My question is: do I have to upgrade building tools or just doc main > > structure, > > or simply css file? > > > Hi Chen, > > I'm not totally sure what you mean, i.e. you build FreeBSD docs for yourself > or you use the FreeBSD doc infrastructure to build your own documents not > related to FreeBSD. I suppose you mean the latter. It is hard to tell what's > wrong without seeing your document and seeing the way how you build it. The > CSS file was changed some time ago. Maybe your one is outdated? > If you use this system, you must be already experienced with DocBook. I > suggest looking at DocBook 5, which is based on XML instead of SGML. Using > DocBook 5 with the DocBook XSLT stylesheets is quite convenient and the > output is very nice if you are willing to install Java and Apache FOP. > > Regards, > > -- > Gabor Kovesdan > FreeBSD Volunteer > > EMAIL: gabor@FreeBSD.org .:|:. gabor@kovesdan.org > WEB: http://people.FreeBSD.org/~gabor .:|:. http://kovesdan.org >
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20090423165250.GA9664>