Date: Wed, 26 Sep 2001 03:39:12 +0200 From: Stephane Legrand <Stephane.Legrand@bigfoot.com> To: doc@freebsd.org, www@freebsd.org Subject: Re: About the new HTML files in www/en/releases/4.4R/ Message-ID: <20010926033911.B513@sequoia.mondomaineamoi.megalo> In-Reply-To: <200109242233.f8OMXC093762@c527597-a.cstvl1.sfba.home.com>; from bmah@freebsd.org on Mon, Sep 24, 2001 at 03:33:12PM -0700 References: <20010925000748.E448@sequoia.mondomaineamoi.megalo> <200109242233.f8OMXC093762@c527597-a.cstvl1.sfba.home.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, Sep 24, 2001 at 03:33:12PM -0700, Bruce A. Mah wrote: > If memory serves me right, Stephane Legrand wrote: > > > Some remarks about these new files : > > > > - the version numbers are different from the usual ones. > > For instance, in errata.html, it is : > > > > "$FreeBSD: src/release/doc/en_US.ISO8859-1/errata/article.sgml,v 1.1.2.27 > > 2001/09/23 22:57:48 bmah Exp $" > > > > instead of something like > > > > "$FreeBSD: www/en/releases/4.4R/errata.html,v 1.2 > > 2001/09/23 22:57:48 bmah Exp $" > > > > Why ?? > > I turned off keyword substitution for these files in CVS. The html > files in www/en/ releases/4.4R/ were generated from SGML files, and I > thought it best to leave the ID strings intact so that people can see > where the content came from (and what revision). Otherwise this > information gets spammed with the date the generated HTML file was > updated in the repository. Although the dates will bear a strong > resemblance, the version numbers don't, and I bet I'd get a bunch of > questions as to why the version numbers on the Web site don't match > those in the RELNOTESng snapshots. 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. But if it's not true, it would be great if for instance an other version number could be added to reflect each changes in the HTML file. Or may be you could transform this current line in a simple comment to keep inform the reader that the content was generated from article.sgml with its version and let the CVS do its job to have a more usual version number ? I hope you can understand my point of view despite my english :-) > > > - 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) : <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" [ <!ENTITY base CDATA "../.."> <!ENTITY date "$FreeBSD: www/en/releases/4.4R/errata.sgml,v 1.17 2001/09/04 20:51:42 bmah Exp $"> <!ENTITY title "FreeBSD 4.4-RELEASE Errata"> <!ENTITY % includes SYSTEM "../../includes.sgml"> %includes; ]> <!-- $FreeBSD: www/en/releases/4.4R/errata.sgml,v 1.17 2001/09/04 20:51:42 bmah Exp $ --> <html> &header; ... current HTML content without any change ... &footer; </body> </html> 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 ? > My goal for the release documents was to provide, verbatim, the same > files that live in the distribution, in order to minimize confusion when > people happen to see copies of the same document coming from multiple > sources. My point is certainly not to criticize these new HTML files :) What i only want is to preserve some useful (at least for me) features of the SGML files. Stephane Legrand. -- Je recherche un emploi dans le domaine de l'informatique : PHP, Perl, SQL, FreeBSD, Linux, Internet... C.V. : http://stephleg.free.fr/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-www" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010926033911.B513>