Re: [docbook-apps] manpages transform and tables: CALS versus HTML markup

[Paul DuBois]

Hi Bob,

Your suggested fix works perfectly. Thanks!

I've reported the issue at: 
https://github.com/docbook/xslt10-stylesheets/issues/58 


> On Feb 23, 2018, at 4:01 PM, Bob Stayton  wrote:
> 
> Hi Paul,
> This appears to be a bug introduced in version 1.79.1, in which the table 
> templates had a complete rewrite.
> 
> In the manpages stylesheet, tables of either kind are first converted to HTML 
> tables and then converted to tbl tables.  For HTML tables, it is only 
> necessary to copy the table elements.  But in 1.79.1, this line:
> 
> 
> 
> was replaced with:
> 
> 
> 
> but this should only appear in the namespaced version of the stylesheet to 
> remove the docbook namespace from the HTML table elements.  With DocBook 4 
> elements without a namespace, this fails because there is no default template 
> for non-docbook-namespaced elements.
> 
> If you could please file a github issue on this item, it can be fixed in the 
> source.
> 
> As a workaround, you can add this template to a customization layer which 
> provides that default template:
> 
> 
>  
>http://docbook.org/ns/docbook";>
>  
>
>
>  
>
>  
> 
> 
> Let me know if this works for you.
> 
> Bob Stayton
> Sagehill Enterprises
> b...@sagehill.net
> 
> On 2/23/2018 11:07 AM, Paul DuBois wrote:
>> I've just converted a bunch of DocBook tables from CALS markup to HTML 
>> markup. I then find that the manpage transform omits them, or rather, all I 
>> get in the output is:
>> .TS
>> allbox tab(:);
>> .
>> .TE
>> A diff between the output produced for the CALS versus HTML table looks like 
>> this:
>>  .TS
>>  allbox tab(:);
>> -l l s s
>> -l l l s.
>> -T{
>> -\fBCommand\-Line Format\fR
>> -T}:T{
>> -\-\-directory dir_path, \-d dir_path
>> -T}
>> -T{
>> -\fBPermitted Values\fR
>> -T}:T{
>> -\fBType\fR
>> -T}:T{
>> -string
>> -T}
>> +.
>>  .TE
>> Our setup has a bunch of prepreprocessing, so it's possible the trouble lies 
>> there, although the DocBook that we end up shoving into the manpages 
>> transform *does* contain the table source.
>> So, quick question: Is the manpages transform known to have issues with 
>> HTML-markup tables, or should I continue to look elsewhere for the source of 
>> the problem?
>> I can provide more information if necesssary; I'm just making a preliminary 
>> inquiry for now. Thanks.
>> -
>> To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
>> For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
> 
> -
> To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
> 

Re: [docbook-apps] manpages transform and tables: CALS versus HTML markup

[Bob Stayton]

Hi Paul,
This appears to be a bug introduced in version 1.79.1, in which the 
table templates had a complete rewrite.


In the manpages stylesheet, tables of either kind are first converted to 
HTML tables and then converted to tbl tables.  For HTML tables, it is 
only necessary to copy the table elements.  But in 1.79.1, this line:


 

was replaced with:

 

but this should only appear in the namespaced version of the stylesheet 
to remove the docbook namespace from the HTML table elements.  With 
DocBook 4 elements without a namespace, this fails because there is no 
default template for non-docbook-namespaced elements.


If you could please file a github issue on this item, it can be fixed in 
the source.


As a workaround, you can add this template to a customization layer 
which provides that default template:



  
http://docbook.org/ns/docbook";>
  


  

  


Let me know if this works for you.

Bob Stayton
Sagehill Enterprises
b...@sagehill.net

On 2/23/2018 11:07 AM, Paul DuBois wrote:

I've just converted a bunch of DocBook tables from CALS markup to HTML markup. 
I then find that the manpage transform omits them, or rather, all I get in the 
output is:

.TS
allbox tab(:);
.
.TE

A diff between the output produced for the CALS versus HTML table looks like 
this:

  .TS
  allbox tab(:);
-l l s s
-l l l s.
-T{
-\fBCommand\-Line Format\fR
-T}:T{
-\-\-directory dir_path, \-d dir_path
-T}
-T{
-\fBPermitted Values\fR
-T}:T{
-\fBType\fR
-T}:T{
-string
-T}
+.
  .TE

Our setup has a bunch of prepreprocessing, so it's possible the trouble lies 
there, although the DocBook that we end up shoving into the manpages transform 
*does* contain the table source.

So, quick question: Is the manpages transform known to have issues with 
HTML-markup tables, or should I continue to look elsewhere for the source of 
the problem?

I can provide more information if necesssary; I'm just making a preliminary 
inquiry for now. Thanks.
-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org





-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org