From owner-freebsd-doc Wed Dec 11 12:44:22 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 87CFC37B401 for ; Wed, 11 Dec 2002 12:44:20 -0800 (PST) Received: from bast.unixathome.org (bast.unixathome.org [66.11.174.150]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1B4C243EA9 for ; Wed, 11 Dec 2002 12:44:19 -0800 (PST) (envelope-from dan@langille.org) Received: from wocker (wocker.unixathome.org [192.168.0.99]) by bast.unixathome.org (Postfix) with ESMTP id C629C3F4E; Wed, 11 Dec 2002 15:44:07 -0500 (EST) From: "Dan Langille" To: Adam Turoff Date: Wed, 11 Dec 2002 15:44:07 -0500 MIME-Version: 1.0 Subject: Re: duplicate pages Cc: Dan Langille , doc@FreeBSD.ORG Message-ID: <3DF75D47.21440.26447A15@localhost> In-reply-to: <20021211202221.GA7744@panix.com> References: <20021211193350.GC12310@panix.com> X-mailer: Pegasus Mail for Windows (v4.02a) Content-type: text/plain; charset=US-ASCII Content-transfer-encoding: 7BIT Content-description: Mail message body 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 On 11 Dec 2002 at 15:22, Adam Turoff wrote: > On Wed, Dec 11, 2002 at 02:33:50PM -0500, Adam Turoff wrote: > > On Wed, Dec 11, 2002 at 10:15:44AM -0800, Bruce A. Mah wrote: > > > It'd be nice if the internal links for our documentation pages > > > didn't change, but that would require some (large, I suspect) > > > changes to the DocBook toolchain. > > > > Not really. It'll require adding IDs to each of the individual > > sections. > > Step 1: find the problematic sections of a document: > [ziggy@chimay handbook]$ egrep -n '<(part|sect1|chapter|colophon)>' \ > *.sgml */*.sgml > > book.sgml:108: > book.sgml:153: > book.sgml:190: > colophon.sgml:7: > ... > > Step 2: add ids to those elements > > Step 3: clean & rebuild. No more [xzp][0-9]+.html filenames. :-) > > Step 4: doublecheck to see that none of the IDs are duplicates > [ziggy@chimay handbook2]$ egrep '<(part|chapter|sect1|colophon) id=' > \ > *.sgml */*.sgml \ > | cut -f 2 -d '"' | sort | uniq -d > backups-floppybackups > backups-tapebackups > [ziggy@chimay handbook] $ > > NB: These are found in backup/chapter.sgml (unused) and > disks/chapter.sgml (used). This is not a problem. It would be really good to use static names for pages. It means links from other websites will not change as often and search engine data is likely to be stale. -- Dan Langille : http://www.langille.org/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message