[rules-dev] docbook chunking

[Geoffrey De Smet]

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="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_single/index.html#d0e4224
> Chunked:
>
> http://docs.jboss.org/drools/release/5.3.0.CR1/drools-planner-docs/html/ch10.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_single/index.html#realTimePlanning
> Chunked:
>
> http://docs.jboss.org/drools/release/5.3.0.CR1/drools-planner-docs/html/repeatedPlanning.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 at lists.jboss.org
>> https://lists.jboss.org/mailman/listinfo/rules-dev
>>

-- 
With kind regards,
Geoffrey De Smet