Re: [docbook-apps] cmdsynopsis omits xml:id

[Bob Stayton]

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
b...@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 <a name="abe"></a> inside? 
The chapter and section headings have their anchors. for example, here is the 
section div: 
   <div class="section">
      <div class="titlepage">
        <div>
          <div>
            <h2 class="title" style="clear: both">
              <a name="abd"></a>
              The Section
            </h2>
          </div>
        </div>
      </div>
      <p></p>
      <div class="cmdsynopsis">
        <p>
          <code class="command">The Command</code>
          variable-list   ;
        </p>
      </div>
      <p></p>
    </div>





On Tue, Nov 5, 2013 at 2:28 PM, Tim Arnold <jtim.arn...@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 <b...@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
    b...@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><title>The Chapter</title></info>
      <section xml:id="abd">
        <info><title>The Section</title></info>
        <para>
          <cmdsynopsis xml:id="abe" sepchar=" ">
            <command>The Command</command>
            <arg choice="plain">variable-list</arg>
            <arg choice="plain">;</arg>
          </cmdsynopsis>
        </para>
      </section>
    </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):
     <div class="cmdsynopsis">
       <p>
         <code class="command">The Command</code>
         variable-list   ;
       </p>
     </div>


    thanks,
    --Tim