docbook-apps

hi, when I convert DocBook 5 using the 1.77 html (chunk) stylesheets, the
cmdsynopsis element is rendered as a div, but the xml:id is omitted. Is
this a bug or am I misunderstanding? I would have expected the xml:id to
come through as an id in the html.

Test document:
<chapter xmlns="http://docbook.org/ns/docbook"
version="5.0" xml:id="abc">
<info></info>

<info></info>
<para>
<cmdsynopsis xml:id="abe" sepchar=" ">

<arg choice="plain">variable-list</arg>
<arg choice="plain">;</arg>
</cmdsynopsis>
</para>

</chapter>

with this command line:
xsltproc /path/to/docbook/xsl-1.77.1/html/chunk.xsl test.xml

the cmdsynopsis element results in this block of html (I expected the id
"abe" on the div):


thanks,
--Tim

Hi Tim,
By default, the $generate.id.attributes param in the html stylesheet is set to zero (it generates the old named anchor elements instead). If you set that to 1, then you should get an id output on cmdsynopsis.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net


From: Tim Arnold
Sent: Tuesday, October 29, 2013 10:59 AM
To: DocBook Apps
Subject: [docbook-apps] cmdsynopsis omits xml:id


hi, when I convert DocBook 5 using the 1.77 html (chunk) stylesheets, the cmdsynopsis element is rendered as a div, but the xml:id is omitted. Is this a bug or am I misunderstanding? I would have expected the xml:id to come through as an id in the html.


Test document:
<chapter xmlns="http://docbook.org/ns/docbook"
version="5.0" xml:id="abc">
<info></info>

<info></info>
<para>
<cmdsynopsis xml:id="abe" sepchar=" ">

<arg choice="plain">variable-list</arg>
<arg choice="plain">;</arg>
</cmdsynopsis>
</para>

</chapter>


with this command line:
xsltproc /path/to/docbook/xsl-1.77.1/html/chunk.xsl test.xml



the cmdsynopsis element results in this block of html (I expected the id "abe" on the div):



thanks,
--Tim

Hi Bob,
You are right--I had the attribute set to 1 at some point and turned it off
without realizing the consequence.

thanks!
--Tim



On Thu, Oct 31, 2013 at 3:18 PM, Bob Stayton <bobs@sagehill.net> wrote:

> Hi Tim,
> By default, the $generate.id.attributes param in the html stylesheet is
> set to zero (it generates the old named anchor elements instead). If you
> set that to 1, then you should get an id output on cmdsynopsis.
>
> Bob Stayton
> Sagehill Enterprises
> bobs@sagehill.net
>
> *From:* Tim Arnold <jtim.arnold@gmail.com>
> *Sent:* Tuesday, October 29, 2013 10:59 AM
> *To:* DocBook Apps <docbook-apps@lists.oasis-open.org>
> *Subject:* [docbook-apps] cmdsynopsis omits xml:id
>
> hi, when I convert DocBook 5 using the 1.77 html (chunk) stylesheets, the
> cmdsynopsis element is rendered as a div, but the xml:id is omitted. Is
> this a bug or am I misunderstanding? I would have expected the xml:id to
> come through as an id in the html.
>
> Test document:
> <chapter xmlns="http://docbook.org/ns/docbook"
> version="5.0" xml:id="abc">
> <info></info>
>

> <info></info>
> <para>
> <cmdsynopsis xml:id="abe" sepchar=" ">
>
> <arg choice="plain">variable-list</arg>
> <arg choice="plain">;</arg>
> </cmdsynopsis>
> </para>
>

> </chapter>
>
> with this command line:
> xsltproc /path/to/docbook/xsl-1.77.1/html/chunk.xsl test.xml
>
> the cmdsynopsis element results in this block of html (I expected the id
> "abe" on the div):
>
>
> thanks,
> --Tim
>
>

but one more thing, why doesn't the cmdsynopsis have
inside? The chapter and section headings have their anchors. for example,
here is the section div:




On Tue, Nov 5, 2013 at 2:28 PM, Tim Arnold <jtim.arnold@gmail.com> wrote:

> Hi Bob,
> You are right--I had the attribute set to 1 at some point and turned it
> off without realizing the consequence.
>
> thanks!
> --Tim
>
>
>
> On Thu, Oct 31, 2013 at 3:18 PM, Bob Stayton <bobs@sagehill.net> wrote:
>
>> Hi Tim,
>> By default, the $generate.id.attributes param in the html stylesheet is
>> set to zero (it generates the old named anchor elements instead). If you
>> set that to 1, then you should get an id output on cmdsynopsis.
>>
>> Bob Stayton
>> Sagehill Enterprises
>> bobs@sagehill.net
>>
>> *From:* Tim Arnold <jtim.arnold@gmail.com>
>> *Sent:* Tuesday, October 29, 2013 10:59 AM
>> *To:* DocBook Apps <docbook-apps@lists.oasis-open.org>
>> *Subject:* [docbook-apps] cmdsynopsis omits xml:id
>>
>> hi, when I convert DocBook 5 using the 1.77 html (chunk) stylesheets, the
>> cmdsynopsis element is rendered as a div, but the xml:id is omitted. Is
>> this a bug or am I misunderstanding? I would have expected the xml:id to
>> come through as an id in the html.
>>
>> Test document:
>> <chapter xmlns="http://docbook.org/ns/docbook"
>> version="5.0" xml:id="abc">
>> <info></info>
>>

>> <info></info>
>> <para>
>> <cmdsynopsis xml:id="abe" sepchar=" ">
>>
>> <arg choice="plain">variable-list</arg>
>> <arg choice="plain">;</arg>
>> </cmdsynopsis>
>> </para>
>>

>> </chapter>
>>
>> with this command line:
>> xsltproc /path/to/docbook/xsl-1.77.1/html/chunk.xsl test.xml
>>
>> the cmdsynopsis element results in this block of html (I expected the id
>> "abe" on the div):
>>
>>
>> thanks,
>> --Tim
>>
>>
>

Hi Tim,
It appears that in 2007, the named anchor output was made dependent on the presence of a dbcmdlist processing instruction:

http://docbook.sourceforge.net/release/xsl/1.78.1/doc/pi/dbcmdlist.html

I think the implementor went to far, though, and turned off the anchor if that PI was not used, even when an id attribute was present. I'll fix that for a future release.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net


From: Tim Arnold
Sent: Tuesday, November 05, 2013 11:35 AM
To: Bob Stayton
Cc: DocBook Apps
Subject: Re: [docbook-apps] cmdsynopsis omits xml:id


but one more thing, why doesn't the cmdsynopsis have inside? The chapter and section headings have their anchors. for example, here is the section div:






On Tue, Nov 5, 2013 at 2:28 PM, Tim Arnold <jtim.arnold@gmail.com> wrote:

Hi Bob,
You are right--I had the attribute set to 1 at some point and turned it off without realizing the consequence.


thanks!
--Tim





On Thu, Oct 31, 2013 at 3:18 PM, Bob Stayton <bobs@sagehill.net> wrote:

Hi Tim,
By default, the $generate.id.attributes param in the html stylesheet is set to zero (it generates the old named anchor elements instead). If you set that to 1, then you should get an id output on cmdsynopsis.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net


From: Tim Arnold
Sent: Tuesday, October 29, 2013 10:59 AM
To: DocBook Apps
Subject: [docbook-apps] cmdsynopsis omits xml:id


hi, when I convert DocBook 5 using the 1.77 html (chunk) stylesheets, the cmdsynopsis element is rendered as a div, but the xml:id is omitted. Is this a bug or am I misunderstanding? I would have expected the xml:id to come through as an id in the html.


Test document:
<chapter xmlns="http://docbook.org/ns/docbook"
version="5.0" xml:id="abc">
<info></info>

<info></info>
<para>
<cmdsynopsis xml:id="abe" sepchar=" ">

<arg choice="plain">variable-list</arg>
<arg choice="plain">;</arg>
</cmdsynopsis>
</para>

</chapter>


with this command line:
xsltproc /path/to/docbook/xsl-1.77.1/html/chunk.xsl test.xml



the cmdsynopsis element results in this block of html (I expected the id "abe" on the div):



thanks,
--Tim