From owner-freebsd-doc Thu Sep 27 14:37: 6 2001 Delivered-To: freebsd-doc@freebsd.org Received: from c527597-a.cstvl1.sfba.home.com (c527597-a.cstvl1.sfba.home.com [24.176.204.87]) by hub.freebsd.org (Postfix) with ESMTP id 41B9837B401; Thu, 27 Sep 2001 14:36:43 -0700 (PDT) Received: (from bmah@localhost) by c527597-a.cstvl1.sfba.home.com (8.11.6/8.11.6) id f8RLafY56104; Thu, 27 Sep 2001 14:36:41 -0700 (PDT) (envelope-from bmah) Message-Id: <200109272136.f8RLafY56104@c527597-a.cstvl1.sfba.home.com> X-Mailer: exmh version 2.5 07/13/2001 with nmh-1.0.4 To: Stephane.Legrand@bigfoot.com Cc: doc@FreeBSD.ORG, www@FreeBSD.ORG Subject: Re: About the new HTML files in www/en/releases/4.4R/ In-Reply-To: <20010926033911.B513@sequoia.mondomaineamoi.megalo> References: <20010925000748.E448@sequoia.mondomaineamoi.megalo> <200109242233.f8OMXC093762@c527597-a.cstvl1.sfba.home.com> <20010926033911.B513@sequoia.mondomaineamoi.megalo> Comments: In-reply-to Stephane Legrand message dated "Wed, 26 Sep 2001 03:39:12 +0200." From: "Bruce A. Mah" Reply-To: bmah@FreeBSD.ORG X-Face: g~c`.{#4q0"(V*b#g[i~rXgm*w;:nMfz%_RZLma)UgGN&=j`5vXoU^@n5v4:OO)c["!w)nD/!!~e4Sj7LiT'6*wZ83454H""lb{CC%T37O!!'S$S&D}sem7I[A 2V%N&+ X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-Url: http://www.employees.org/~bmah/ Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==_Exmh_-972057479P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Thu, 27 Sep 2001 14:36:41 -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --==_Exmh_-972057479P Content-Type: text/plain; charset=us-ascii If memory serves me right, Stephane Legrand wrote: > On Mon, Sep 24, 2001 at 03:33:12PM -0700, Bruce A. Mah wrote: > Let me clarify why i asked this question. I'm participating to the > french translation of the www pages and it's extremely useful to > have a version number for each files because you can then easily > track the translations out of sync. If you can assure me that this > current version number will be modified each time the HTML file is > modified (no matter if article.sgml was modified or not), then > that's perfectly fine because i can use this version number as i > already use the ones in the SGML files. OK. I can say with some confidence that the only time that I will go to modify (for example) errata.html is if the article.sgml file that generated it was modified. Since the version number in the page gets changed every time this happens, then you should be able to use this. > I hope you can understand my point of view despite my english :-) Your English is most excellent and much better than my French (despite having taken four years of French in high school). > > > - the fact that the HTML files are no more generated makes difficult > > > any design changes. For instance, i can't add a navigation bar in > > > these pages without directly modifying the files. With SGML, the > > > &header; entity allows this without any change in the original > > > file. Any chance to revert to SGML format ? > > > > I found the old method (drop ASCII text in the middle of SGML) to be > > extremely inconvenient for updating the errata. I'm open to > > alternatives that don't make me do this. > > Could it be possible to have something like (an example with errata) : > > > 2001/09/04 20:51:42 bmah Exp $"> > > %includes; > ]> > > > > &header; > ... > current HTML content without any change > ... > &footer; > > > > ie basically embed the HTML body in a standard SGML "skeleton". > So, the current HTML content is preserved but the SGML entities > are preserved too. > > Is it easily feasible ? Hmmm...I don't know. I'd still like to avoid any modifications to the HTML at all (i.e. headers, footers, etc.) with respect to what a user might find in a RELEASE or a snapshot. But perhaps I'm being lazy, and I freely admit that I am not the best qualified person when it comes to Web site design, so other opinions are welcome (especially, BTW, from those participating in the XML thread on -doc@). Here's another thought. It makes you do a little more work but you do gain something in the end. Instead of translating the HTML renderings of the errata, release notes, etc., what about translating the SGML that produced them? We can put these in src/release/doc/fr_FR.ISO8859-1 in a parallel structure with the rest of the release documentation. This gets you a set of release documentation that can be printed, converted to HTML, or whatever else. The HTML can be used (either directly or indirectly) in the Web site. I can help with setting up the infrastructure for this. It's related, but not identical, to the point we're discussing about the formatting. Bruce. --==_Exmh_-972057479P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: Exmh version 2.3.1+ 05/14/2001 iD8DBQE7s5vp2MoxcVugUsMRAu3IAKCoP8uyMgo/OZkfd1/AYRtjFXtPtwCaAsh3 3Ep1QbobM2lWid2RNJxoEjo= =MFda -----END PGP SIGNATURE----- --==_Exmh_-972057479P-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message