Stability of book URLs

Max Bowsher maxb at
Thu Apr 21 04:18:17 CDT 2005

> Max Bowsher wrote:
>> Currently, URLs to parts of the book suffer from a stability problem.
>> If we add or delete sections (or worse, chapters!), then many URLs
>> pointing to specific sections will be broken.
>> To fix this, I propose the following:
>> Step 1: Enable the parameter ""
>> This will cause each file produced in the chunked HTML to take a name
>> based on the id attribute of the XML element which caused the chunk,
>> instead of the plain sequential system used currently.
>> Step 2: Migrate the values of id attributes away from the primarily
>> numerical system in use now, instead using descriptive names.

C. Michael Pilato wrote:
> To quote something I've been hearing around the Chicago office lately
> (but whose source I do not know):
>    "I'm intrigued by your ideas, and would like to subscribe to your
>    newsletter."
> I would like to get clearance from O'Reilly on this, first, though.  We
> used that scheme because it was described as The Way To Do It (nevermind
> it was always a pain in the buttocks...).


In its simplest form, the question we need asked is "Do you place any 
restrictions on the content of 'id' attributes?".


More information about the svnbook-dev mailing list