Next in thread → Next in month →

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

From
Bob Stayton <>
Date
2013-11-05T20:02:06+00:00
ID
2602CA72446348169B7FB6F7C45C4EE8@totoro
Thread
Re: [docbook-apps] cmdsynopsis omits xml:id
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


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 <> 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 <> 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


    

    

    

    
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
Next in thread → Next in month →