OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] customization layer for DocBook 5.0: TheTransition Guide

Ken Morse <kenneth.morse@gmail.com>, 2007-08-29 14:23 -0400:

> Thanks for all the good information about the stylesheets. Your response to
> Brett has prompted me to ask a few, hopefully related, questions:
> I notice that the howto.xml file you pointed to at
> https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/docbook/howto/is
> slightly different than the one at
> http://docbook.org/docs/howto/2006-10-22/howto.xml -- is this intentional?

I don't know. I guess I should point out that I'm not the owner of
that howto (Norm and Jirka and Dick Hamilton are, I think) and
didn't really contribute anything to development of it or to the
original build system for it. I just stepped in to try to help
answer Brett's questions about it and help him do what he needed.

> The Transition Guide talks about moving from DocBook 4.5 to 5.0, but doesn't
> really cover changes to how the "ns" stylesheets could be used. Presumable a
> future version of the document should recommend using the "ns" versions of
> the stylesheets for DocBook 5.0 documents and also talk about how
> customization layers would need to be changed (adding namespace prefixes,
> etc.)?

Yeah, I agree that should be added. The only issue with that is
the same one we always have: Finding somebody who has time and
interest in doing it. Somebody on the project may find time to do
it, but we also welcome editorial/content contributions from
anybody else who might want to send something. The sources are
available, so it'd mostly be a matter of checking those out,
making changes/additions, then sending those to us as a patch.

> The section on stylesheets
> <http://www.docbook.org/docs/howto/#dbxsl>includes a link to
> "experimental stylesheets" from
> http://sagehill.net/xml/docbook5ns/ -- perhaps the link should be updated to
> something like http://docbook.sourceforge.net/release/xsl-ns/current/ and
> strike the part about the stylesheets being experimental?

I've gone ahead and done a quick edit/update of that section, and
checked it back in. So the change is included in the source and
will be in the next published revision of the document (unless one
of the owners chooses to revert it).

As an example of what I mean about sending about patch, I've
attached to this message the diff for that change.

Index: howto.xml
--- howto.xml	(revision 7302)
+++ howto.xml	(working copy)
@@ -510,14 +510,9 @@
 Processing stripped document.</screen>
 <para>Although you can successfully use the existing stylesheets to
-process DocBook V5.0, there are some limitations. To support some of
-the new features of DocBook V5.0, the existing stylesheets would
-require a significant rewrite.
-A rewrite is unlikely because a new version of stylesheets is currently
-under development.</para>
+process DocBook V5.0, there are some limitations and unsupported
+features. The unsupported features include:</para>
-<para>The unsupported features include:</para>
 <listitem><para>general annotations;</para></listitem>
 <listitem><para>general XLink links on all elements.</para></listitem>
@@ -534,15 +529,26 @@
 with DocBook V5.0 you have to use profiling variants of those
 stylesheets (their name is starting with
-<para>As you can see namespace stripping could cause troubles in some
-situations. To overcome those limitations Bob Stayton created
-a special version of the DocBook XSL stylesheets which doesn't use
-namespace stripping and supports only DocBook V5.0. You can get those
-experimental stylesheets from <link
+<section xml:id="dbxsl-ns">
+<title>DocBook XSL-NS Stylesheets</title>
+<para>As you can see from reading the previous section, namespace
+  stripping has limitations that will cause trouble in some
+  situations. To overcome those limitations, Bob Stayton created a
+  build system for taking the non-namespace-aware DocBook XSL
+  stylesheets and generating namespace-aware versions from them.
+  The DocBook <link
+    xl:href="http://docbook.sourceforge.net/release/xsl-ns/current/";
+  >XSL-NS stylesheets</link> are the result.</para>
+<para>The DocBook XSL-NS stylesheets are released side-by-side
+  with the DocBook XSL stylesheets, as a separate <link
+  xl:href="https://sourceforge.net/project/showfiles.php?group_id=21935&amp;package_id=219178";
+  ><package>docbook-xsl-ns</package></link> package. They are the
+recommended XSLT 1.0 stylesheets to use for transforming
+namespaced (DocBook 5) documents.</para>
 <section xml:id="dbxsl2">


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]