From ge0ffrey.spam at gmail.com Mon Sep 26 02:46:48 2011
Content-Type: multipart/mixed; boundary="===============2582404719263705915=="
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 08:46:35 +0200
Message-ID: <j5p74b$c1p$1@dough.gmane.org>
In-Reply-To: 4E7F70A9.3060204@codehaus.org

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

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_sin=
gle/index.html#d0e4224
Chunked:
   =

http://docs.jboss.org/drools/release/5.3.0.CR1/drools-planner-docs/html/ch1=
0.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_sin=
gle/index.html#realTimePlanning
Chunked:
   =

http://docs.jboss.org/drools/release/5.3.0.CR1/drools-planner-docs/html/rep=
eatedPlanning.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



--===============2582404719263705915==--