From owner-freebsd-doc@FreeBSD.ORG  Thu Apr 23 17:06:24 2009
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 4F068106566B;
	Thu, 23 Apr 2009 17:06:24 +0000 (UTC)
	(envelope-from xuchen@brandeis.edu)
Received: from farnsworth.unet.brandeis.edu (farnsworth.unet.brandeis.edu
	[129.64.99.56])
	by mx1.freebsd.org (Postfix) with ESMTP id 26FDD8FC0C;
	Thu, 23 Apr 2009 17:06:24 +0000 (UTC)
	(envelope-from xuchen@brandeis.edu)
Received: from localhost (selene.rose2.brandeis.edu [129.64.33.166])
	by farnsworth.unet.brandeis.edu (Postfix) with ESMTP id 611D952256;
	Thu, 23 Apr 2009 12:48:40 -0400 (EDT)
Date: Thu, 23 Apr 2009 12:52:51 -0400
From: Chen Xu <xuchen@brandeis.edu>
To: G??bor K??vesd??n <gabor@FreeBSD.org>
Message-ID: <20090423165250.GA9664@brandeis.edu>
References: <184b087c0904230720t5852baabxe3b3d7e74adb1c11@mail.gmail.com>
	<49F094F2.3030205@FreeBSD.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <49F094F2.3030205@FreeBSD.org>
Ruler: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
User-Agent: Mutt/1.5.15 (2007-04-06)
Cc: freebsd-doc@FreeBSD.org
Subject: Re: what need to upgrade?
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 23 Apr 2009 17:06:24 -0000

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
>