[rules-dev] docbook chunking

[Geoffrey De Smet]

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