From ge0ffrey.spam at gmail.com Mon Sep 26 09:22:54 2011
Content-Type: multipart/mixed; boundary="===============2311268504787487045=="
MIME-Version: 1.0
From: Geoffrey De Smet <ge0ffrey.spam at gmail.com>
To: rules-dev at lists.jboss.org
Subject: Re: [rules-dev] docbook chunking
Date: Mon, 26 Sep 2011 15:22:36 +0200
Message-ID: <j5puat$dqk$1@dough.gmane.org>
In-Reply-To: j5p74b$c1p$1@dough.gmane.org

--===============2311268504787487045==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

I 've added an id for the chapters inside the introduction manual,
so the url for the release notes chapter will be nicer (it starts with =

new and noteworthy).

Op 26-09-11 08:46, Geoffrey De Smet schreef:
> docbook allows you to add an attribute xml:id in the element section:
> <section xml:id=3D"realTimePlanning">
> <title>Real-time planning (event based planning)</title>
>       ...
> </section>
> which gives bookmarkable URL's.
>
>
> For example:
>
> Without attribute xml:id:
> HTML single:
>
> http://docs.jboss.org/drools/release/5.3.0.CR1/drools-planner-docs/html_s=
ingle/index.html#d0e4224
> Chunked:
>
> http://docs.jboss.org/drools/release/5.3.0.CR1/drools-planner-docs/html/c=
h10.html#d0e4284
> Notice the ch10 and the d0e4284, they can change every build.
>
> With attribute xml:id:
> HTML single:
>
> http://docs.jboss.org/drools/release/5.3.0.CR1/drools-planner-docs/html_s=
ingle/index.html#realTimePlanning
> Chunked:
>
> http://docs.jboss.org/drools/release/5.3.0.CR1/drools-planner-docs/html/r=
epeatedPlanning.html#realTimePlanning
>
> Op 25-09-11 20:19, Mark Proctor schreef:
>> Currently the chunked, multi-page, docbook uses indexed numbers for
>> pages. These numbers can change from build to build as the content
>> changes. It seems that chunking can accept various attributes for the
>> url name. This means if someone takes the time to update the docbook we
>> can get something close to permanlinks. If we have links that don't
>> change too often people can then use those web annotation systems, to
>> allow live annotations and comments.
>> http://www.sagehill.net/docbookxsl/Chunking.html
>>
>> Mark
>>
>> _______________________________________________
>> rules-dev mailing list
>> rules-dev(a)lists.jboss.org
>> https://lists.jboss.org/mailman/listinfo/rules-dev
>>

-- =

With kind regards,
Geoffrey De Smet



--===============2311268504787487045==--