From owner-freebsd-doc Fri Mar 31 3:54: 7 2000 Delivered-To: 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 (Postfix) with ESMTP id 66A1537BBBD; Fri, 31 Mar 2000 03:52:54 -0800 (PST) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id MAA08829; Fri, 31 Mar 2000 12:44:51 +0100 (BST) (envelope-from nik) Date: Fri, 31 Mar 2000 12:44:51 +0100 From: Nik Clayton To: Alexey Zelkin Cc: Jim Mock , committers@FreeBSD.org, doc@freebsd.org Subject: Re: www/en/news/webchanges.sgml Message-ID: <20000331124450.A5965@catkin.nothing-going-on.org> Reply-To: doc@freebsd.org References: <20000319174437.A6630@luna.cdrom.com> <20000322104328.A3982@scorpion.crimea.ua> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary=a8Wt8u1KmwUX3Y2C X-Mailer: Mutt 0.95.4i In-Reply-To: <20000322104328.A3982@scorpion.crimea.ua>; from Alexey Zelkin on Wed, Mar 22, 2000 at 10:43:28AM +0300 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --a8Wt8u1KmwUX3Y2C Content-Type: text/plain; charset=us-ascii [ cc'd to -committers, where this came up, and -doc, where it's more on-topic. FU to -doc ] On Wed, Mar 22, 2000 at 10:43:28AM +0300, Alexey Zelkin wrote: > On Sun, Mar 19, 2000 at 05:44:37PM -0800, Jim Mock wrote: > > Does anyone object to removing www/en/news/webchanges.sgml? It hasn't > > been updated since last December. It's kind of crufty, and I'm not sure > > that we really need it if it hasn't been or going to be updated. > > Opinions? > > I disagree. It's useful file, but people forget to update it. I have > point at my TODO list to add latest commits there. Per my earlier message about trying to automate the updates, here's my first stab. This is not integrated with the build process in any way yet. You will need: cvs2cl.pl Get this from http://www.red-bean.com/~kfogel/cvs2cl.shtml. You need version 2.3 or above, which supports the --xml output flag. We'll need to port this if we use this approach. jade textproc/jade, you'll have this if you installed the textproc/docproj port XML declaration The XML declaration. I use the one from the textproc/dsssl-docbook-modular port. webchanges-new.sgml Attached to this message. cl.sh Quick and dirty shell script. Attached to this message. changelog.dsl DSSSL script to convert from the ChangeLog XML to HTML. Attached to this message. 1. Check out a copy of the www/ repository somewhere, and go to the www/en directory. 2. Run "cvs2cl.pl", getting the last month's worth of changes. Put the results in news/ChangeLog.xml. Something like this should do it. cvs2cl.pl -g '-d /home/ncvs' -l "-d'>2000-03-01'" -r -P \ --xml --stdout > news/ChangeLog.xml 3. Change to the news/ directory, and put a copy of the attached webchanges-new.sgml file in there. 4. Run jade over ChangeLog.xml, using changelog.dsl, to generate changelog.html. See the commands in cl.sh for how to do this. Note the two calls to sed, which are required to make up for some deficiencies in my DSSSL knowledge. 5. Patch news/Makefile to know about webchanges-new.sgml, and then make webchanges-new.html 6. Examine the HTML output in your browser of choice. There are a few nits. 1. Multiple changes by different people on the same day get a different entry. This really needs a patch to cvs2cl.pl to fix, so that you have ... ... Rather than the current approach. 2. We're ignoring some information in the ChangeLog. For example the time of the commit, and the file revisions affected. We could use this info to link back to the CVS repository. 3. The sed in the shell script is ugly, but I don't know enough DSSSL to do that in the stylesheet. For those that don't to do all the above, I've attached a copy of a webchanges-new.html ("Here's one I made earlier") so you can see the direction we're going in. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery --a8Wt8u1KmwUX3Y2C Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="changelog.dsl" (declare-flow-object-class element "UNREGISTERED::James Clark//Flow Object Class::element") (element changelog (make element gi: "UL")) (element entry (make element gi: "LI")) (element date (make element gi: "B")) (element weekday (empty-sosofo)) (element time (empty-sosofo)) (element author (make sequence (literal "<") (make element gi: "A" attributes: (list (list "HREF" (string-append "mailto:" (data (current-node)) "@FreeBSD.org"))) (process-children) (literal "@FreeBSD.org")) (literal ">"))) (element file (make element gi: "P")) (element name (make sequence (make element gi: "A" attributes: (list (list "HREF" (string-append "/" (data (current-node)))))))) (element revision (empty-sosofo)) (element commondir (empty-sosofo)) (element msg (make element gi: "PRE")) --a8Wt8u1KmwUX3Y2C Content-Type: application/x-sh Content-Disposition: attachment; filename="cl.sh" #!/bin/sh jade -c /usr/local/share/sgml/jade/catalog -c /usr/local/share/sgml/docbook/dsssl/modular/catalog -d changelog.dsl -t sgml /usr/local/share/sgml/docbook/dsssl/modular/dtds/decls/xml.dcl ChangeLog.xml | sed 's/ //' | sed 's/\.sgml/\.html/' > changelog.html --a8Wt8u1KmwUX3Y2C Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="webchanges-new.sgml" %includes; %newsincludes; ]> &header;

This page lists the changes made to the files that make up the FreeBSD web site over the past month.

&changelog; &newshome; &footer; --a8Wt8u1KmwUX3Y2C Content-Type: text/html Content-Disposition: attachment; filename="webchanges-new.html" Changes at the FreeBSD Web Server Navigation Bar

Changes at the FreeBSD Web Server


Top Applications Support Documentation Vendors Search Index Top Top

This page lists the changes made to the files that make up the FreeBSD web site over the past month.

News Home
freebsd-questions@FreeBSD.ORG
Copyright © 1995-2000 The FreeBSD Project. All rights reserved.
Last modified: 2000/01/09 19:38:49
--a8Wt8u1KmwUX3Y2C-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message