From owner-freebsd-doc Sun Nov 15 20:16:35 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id UAA14259 for freebsd-doc-outgoing; Sun, 15 Nov 1998 20:16:35 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from gamma.aei.ca (gamma.aei.ca [206.123.6.10]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id UAA14254 for ; Sun, 15 Nov 1998 20:16:33 -0800 (PST) (envelope-from malartre@aei.ca) Received: from aei.ca (aeiusrJ-24.aei.ca [206.186.205.224]) by gamma.aei.ca (8.8.5/8.8.5) with ESMTP id XAA28794; Sun, 15 Nov 1998 23:16:02 -0500 (EST) Message-ID: <364FA6C5.89DDF806@aei.ca> Date: Sun, 15 Nov 1998 23:15:01 -0500 From: Malartre X-Mailer: Mozilla 4.06 [en] (X11; I; FreeBSD 2.2.7-STABLE i386) MIME-Version: 1.0 To: Nik Clayton CC: doc@FreeBSD.ORG Subject: Re: Debian (french page!) and GTML. References: <364BA59B.A403C81F@aei.ca> <19981115222615.18414@nothing-going-on.org> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Nik Clayton wrote: > > On Thu, Nov 12, 1998 at 10:20:59PM -0500, Malartre wrote: > > I just checked www.debian.org. Since one year, that site changed a lot. > > First, I was surprised to see that site in French! (I "accidentaly" > > setted the "languages" preference in Netscape to French(fr), without > > knowing what it would do). Surprise! debian.org use that cool feature. > > see (http://www.debian.org/intro/cn.html.en) > > It's near FreeBSD quality :-) > > see (http://www.debian.org/~elphick/ddp/) > > Don't know -- I've noted this for further investigation in a couple of > weeks, if no one else has got to it by then. > > > On another topic: > > I would like to allow many peoples to work on TFUG, since I think it's a > > viable project. I don't know what solutions I could use. > > > > First: should I port it to SGML? > > If it all possible. Although you won't be porting it to SGML, you'll be > porting it to DocBook. > > OK, I'm being pedantic. DocBook and HTML share the same relationship to > SGML -- they're both languages defined using SGML. > > > I never used SGML. The main problem (if > > you see it) is that it's not really portable to anything else than HTML > > I think. It use a lot of tag, special colors... I use "GTML" to > > generate style/colors and the NEXT HOME BACK link at the top and bottom. > > Now it's simple for me to respect the style of it since all is automated > > when I generate the script. I could even automate
tag. > > Most of that looks like it's stuff to specify commands, examples, and > the like. DocBook doesn't need these, since it has element like > > > > > > > and so on. These, in conjunction with a stylesheet, determine what the > output looks like. > > See, for example, the Handbook converted from DocBook to HTML, at > > > > As you can see, userinput is clearly defined, navigation links are > present, and so on. > > See also my introduction to the Doc. Proj., at > > > > which has a lot of information about DocBook, the tags you want to use, > and so on. The primer is incomplete, I should be uploading a more > complete version tomorrow (Monday) evening. > > > Second: How could I let people adding text to it but respecting the > > style of it. What are the tools available to share it and let them > > submit new work and corrections? > > The simplest way is to let people download the source from you, and > include instructions explaining how they can send you the diff. > Alternatively, if and when this becomes a part of the core FreeBSD > doc set, people can receive it in the same ways they can receive > the other FreeBSD core docs. > > You don't need to worry about the 'style' of it, because the style is > dictated by the stylesheet. As long as people submitting content to you > use the same elements to mean the same thing, it will look the same. > This is one of the reasons I've written the primer listed above. > > Incidentally, have you considered getting a lot of this content > integrated into the FAQ? A lot of it looks like FAQ material. > > N > -- > C.R.F. Consulting -- we're run to make me richer. . . Tank you for your informations. I like the new handbook and I will read your introduction to the doc project. It was supposed to be something like a tutorial, but I made it look like a Q&A. I don't know how to integrate it in the FreeBSD FAQ. Has a new section or pick some part of it? Or the handbook? Anyway, to me, it look more like a tutorial but it could change. Thank You -- [Malartre][malartre@aei.ca][http://www.lowrent.org/freebsd/malartre/] To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message