what need to upgrade?

Chen Xu xuchen at brandeis.edu
Thu Apr 23 17:06:24 UTC 2009


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 at 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 at FreeBSD.org .:|:. gabor at kovesdan.org
>  WEB:   http://people.FreeBSD.org/~gabor .:|:. http://kovesdan.org
> 



More information about the freebsd-doc mailing list