From owner-freebsd-doc Sun Mar 15 15:40:56 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id PAA03427 for freebsd-doc-outgoing; Sun, 15 Mar 1998 15:40:56 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id PAA03381; Sun, 15 Mar 1998 15:40:38 -0800 (PST) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.8.8/8.8.8) id XAA26903; Sun, 15 Mar 1998 23:40:25 GMT (envelope-from nik) Message-ID: <19980315234025.15906@nothing-going-on.org> Date: Sun, 15 Mar 1998 23:40:25 +0000 From: Nik Clayton To: Jun Kuriyama , nik@FreeBSD.ORG Cc: freebsd-doc@FreeBSD.ORG Subject: Re: Convert to DocBook (was Re: ps2pdf) References: <199803052049.PAA00460@hawk.pearson.udel.edu.> <19980305215748.36179@iii.co.uk> <19980311170823.64512@shale.csir.co.za> <19980311152540.43318@iii.co.uk> <35095A81.F35369D9@opt.phys.waseda.ac.jp> <19980313170342.60995@iii.co.uk> <350C5776.3F9EBA34@opt.phys.waseda.ac.jp> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.89.1i In-Reply-To: <350C5776.3F9EBA34@opt.phys.waseda.ac.jp>; from Jun Kuriyama on Mon, Mar 16, 1998 at 07:34:30AM +0900 Organization: Nik at home, where there's nothing going on Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Mar 16, 1998 at 07:34:30AM +0900, Jun Kuriyama wrote: > > 1. Has anyone on the Japanese side used Jade to process SGML with > > the japanese characters suitably encoded? Did it work? > > Now, we are translating "FreeBSD Tutorials" to Japanese. We use > "sgmlfmt" for building html files from DocBook source. I tested Jade > for it yesterday. It might have no problem. (But according to our > Technical Director Mr. Hanai, "rtf" rendering of Jade have some problems > about treating 8-bit characters.) OK. Have you been able to use Jade's TeX backend to do the conversion? > > 2. Do you see any problems with the approach used (i.e., a series of > > commits, each one concerning itself with just one structural change, > > and those changes automated where ever possible)? > > Sorry, I cannot understand this question (my English skill is very > poor...). But technically (such as tags), we can apply English changes > to Japanese version easily now. Right. I don't think this will be a problem, as long as I'm careful to not make 'content' changes and 'tag' changes in the same commit. > > I've been working on getting the handbook converted from the LinuxDoc > > DTD to DocBook, cleaning up the markup, reorganising the file structure > > and so on. > > I am using these components for testing Jade. > > o Jade 1.0.1 > o DocBook 3.0 > o iso8879-1986 > o Norman Walsh's DSSSL stylesheets for the DocBook DTD > > Do you have any stylesheets for FreeBSD Handbook, FAQ, Tutorials? I > think Norman's stylesheets need more (and more) modifications to use for > Handbook, etc. No I don't. I believe that Norman's stylesheets and the configuration options he provides should be enough to get started, although it probably won't look exactly like the current handbook. However, having the Handbook in DocBook means that there's a large body of DocBook source available for people to work on, and others will then be able to work on Norman's stylesheets as well. I've just sent a (lengthy) message out to the list with my current plans for the conversion. Hopefully that will spark a bit more comment and make things clearer as well. N -- Work: nik@iii.co.uk | FreeBSD + Perl + Apache Rest: nik@nothing-going-on.demon.co.uk | Remind me again why we need Play: nik@freebsd.org | Microsoft? To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message