Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 11 Dec 2002 15:44:07 -0500
From:      "Dan Langille" <dan@langille.org>
To:        Adam Turoff <ziggy@panix.com>
Cc:        Dan Langille <dan@langille.org>, doc@FreeBSD.ORG
Subject:   Re: duplicate pages
Message-ID:  <3DF75D47.21440.26447A15@localhost>
In-Reply-To: <20021211202221.GA7744@panix.com>
References:  <20021211193350.GC12310@panix.com>

next in thread | previous in thread | raw e-mail | index | archive | help
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:  <part>
>  book.sgml:153:  <part>
>  book.sgml:190:  <part>
>  colophon.sgml:7:<colophon>
>  ...
> 
> 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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?3DF75D47.21440.26447A15>