dblatex-users — Dblatex Users List

[Dblatex-users] Unnumbered sections and the table of contents

[John L. C. <joh...@gm...>]

I'm curious about the current design around displaying unnumbered
"sections", which I believe basically corresponds to the front matter in a
DocBook document: elements such as `acknowledgements` and `preface`. These
are handled by component.xsl, which manages the various LaTeX counters
corresponding to `tocdepth` and `secnumdepth`. One point that I note is
that the comment on line 73
<https://sourceforge.net/p/dblatex/dblatex/ci/default/tree/xsl/component.xsl#l73>
explicitly notes a design decision to not use starred headings. I'm curious
about that: why was that chosen? That design decision seems to make it
difficult to use the `shorttoc` package, for example.

The `set-tocdepth` template is defined on line 86 of toc_lot.xsl
<https://sourceforge.net/p/dblatex/dblatex/ci/default/tree/xsl/toc_lot.xsl#l86>.
It both modifies the toc file directly, which is how it manages the printed
table of contents, and sets the `tocdepth` counter, which the comment
says is for bookmarks. Why isn't it sufficient to set the `tocdepth`
counter for the printed table of contents, and in what way does that affect
bookmarks? The direct modification of the toc file seems unnecessarily
invasive, and I think that is what hinders the `shorttoc` package from
emitting a table of contents based on an alternative `tocdepth` value.

Thanks for any insight you may be able to provide!

Peace,

    John L. Clark

P.S. I sent this to both the users and the devel lists because I'm not sure
which is better for this kind of discussion. I'm happy to receive feedback
about this.

[Dblatex-users] Spacing between subfigures

[Leandro R. M. <lea...@ce...>]

Greetings,

How can I add some horizontal space such as \hfill between subfigures?

In case anyone has already solved this via XSL templates, could you  
please reply with the solution?

Thanks in advance.
  Prof. Leandro Resende Mattioli
Centro Federal de Educação Tecnológica de Minas Gerais
Departamento de Eletromecânica

[Dblatex-users] Add custom LaTeX cover page

[Peter K. <pe...@so...>]

Hi!

I am looking at setting up a document publishing flow writing a 
document in AsciiDoc, using AsciiDoctor to convert to various formats. 
For PDFs, so far I have had most success converting to DocBook format 
and using dblatex to create a PDF from that.

However, for the PDF generated here I would like to insert a custom 
title page (and remove \maketitle) from LaTeX code. Is it possible to 
add a command somewhere to include custom LaTeX just after the 
\begin{document} and before the document text itself is included?

(I have the LaTeX document already, I am moving from using LaTeX as 
the source format, and this is only needed for the PDF output).

-- 
\\// Peter - http://www.softwolves.pp.se/

[Dblatex-users] Announce: dblatex3-0.3.12

[Benoit G. <ben...@gm...>]

Hello,

The dblatex3 0.3.12 release is now available, and can be directly
downloaded from this URL:

https://sourceforge.net/projects/dblatex/files/dblatex/dblatex-0.3.12/dblatex3-0.3.12.tar.bz2/download

This is a bug fix release working with python3. The release for python2 is
on the way.
All the fixes have been provided by Petter Reinholdtsen (many thanks):
- Fix SF bug #118: fix 'nb' and 'nn' locales.
- Fix SF bug #119: use locale quotes in glossary.
- Fix SF bug #120: use locale quotes in bibliography.
- Fix SF bug #123: add 'se' locale.
- Fix SF bug #124: set default qandaset title markup in english.

Regards,
BG

[Dblatex-users] Announce: dblatex-0.3.11py3

[Benoit G. <ben...@gm...>]

Hello,

The dblatex 0.3.11py3 release is now available, and can be directly
downloaded from this URL:

https://sourceforge.net/projects/dblatex/files/dblatex/dblatex-0.3.11/dblatex-0.3.11py3.tar.bz2/download

This release is a fork of dblatex starting from version 0.3.11 to work
with python >= 3.2. Thanks very much to Michael J. Gruber who did the
hard work!

The SF repository hosting the python3 port is here:
https://sourceforge.net/p/dblatex/dblatex-py3/ci/default/tree/

Regards,
BG

[Dblatex-users] Announce: dblatex-0.3.11

[Benoit G. <ben...@gm...>]

Hello,

The dblatex 0.3.11 release is now available, and can be directly
downloaded from this URL:

https://sourceforge.net/projects/dblatex/files/dblatex/dblatex-0.3.11/dblatex-0.3.11.tar.bz2/download

It is a bugfix release, before moving to python3. This release is also
registered under the Python Package Index.

The detailed changes are:

- Fix Debian bug #863527: remove active babel character.
- Fix Debian bug #866716: make dblatex robust to non-ascii xml:id
- Fix bug #114: don't skip usefull spaces in hyphenated strings


Regards,
BG

Re: [Dblatex-users] two table of contents?

[<re...@re...>]

> I would like to have two table of contents.

This is what worked for me:

<!-- 2019-07-01 reed - override the table of contents to also do short toc -->
<!-- Print the ToC and all the LoTs listed in $doc.lot.show -->
<xsl:template match="book" mode="toc_lots">
  <xsl:if test="$doc.toc.show != '0'">
    <xsl:text>
{\setlength{\cftbeforechapskip}{-0.8pt}
\renewcommand\cftchapafterpnum{\vspace{-5.0pt}}
\shorttableofcontents{Contents in Brief}{0}}
\newpage
\setlength{\cftbeforechapskip}{2pt} % save some space in ToC
\setcounter{tocdepth}{1} % because shorttableofcontents reset it
\tableofcontents</xsl:text>
  </xsl:if>
  <xsl:apply-templates select="." mode="lots"/>
</xsl:template>

and:

\usepackage[tight]{shorttoc}

The tight option is broken so that is why I set some spacing.

[Dblatex-users] two table of contents?

[<re...@re...>]

I would like to have two table of contents.

My existing nice table of contents is configured with
<xsl:param name="toc.section.depth">1</xsl:param>

But it is several pages long. It was suggested that I also have a 
shorter ToC.

Any way with dblatex to have a single page ToC first
with \setcounter{tocdepth}{0}
followed by second table of contents on separate pages using
\setcounter{tocdepth}{1}
?

Thanks

Re: [Dblatex-users] Fwd: dblatex mailing list?

[maxwell <ma...@um...>]

On 2019-06-12 18:41, Benoit Guillon wrote:
> ---------- Forwarded message ----------
> From: re...@re...
> ...
> My email follows:
> 
> From re...@re... Wed Jun 12 09:48:42 2019
> Date: Wed, 12 Jun 2019 09:48:40 -0500 (CDT)
> From: re...@re...
> To: dbl...@li...
> Subject: table column valign?
> 
> My text content in tables is aligned to top of cells. I'd like it to be
> centered vertically. I tried various valign options with middle or
> bottom but resulting latex and PDF files don't change.

The code that handles that parameter is (I believe, xsl is my 
un-favorite programming language...):
--------
   <xsl:choose>
     <xsl:when test="@valign = 'top'">
       <xsl:text>p</xsl:text>
     </xsl:when>
     <xsl:when test="@valign = 'bottom'">
       <xsl:text>b</xsl:text>
     </xsl:when>
     <xsl:otherwise>
       <xsl:text>m</xsl:text>
     </xsl:otherwise>
   </xsl:choose>
-------------
starting at line 746 in the file xsl/newtbl.xsl (There's slightly 
different code that is used for multirow, but you can find that if you 
search the newtbl.xsl file for 'valign'.)

The effect of this on the output LaTeX code is nearly invisible to the 
eye, but diff finds it when you produce LaTeX output with and without 
@valign.  (It's at the beginning of the second lines of each < and > in 
the ff. diff output--this might be the multiline output--I forget just 
what that is--but you can do a similar experiment by editing your own 
input file to include various @valign values.)
----------
< 
\cline{1-1}\cline{2-2}\cline{3-3}\cline{4-4}\cline{5-5}\cline{6-6}\cline{7-7}\cline{8-8}\multicolumn{1}
{m{1.5\newtblstarfactor+\arrayrulewidth}}{\centering\addtolength{\parskip}{-.5ex}%
---
> \cline{1-1}\cline{2-2}\cline{3-3}\cline{4-4}\cline{5-5}\cline{6-6}\cline{7-7}\cline{8-8}\multicolumn{1}
{p{1.5\newtblstarfactor+\arrayrulewidth}}{\centering\addtolength{\parskip}{-.5ex}%
----------

As to whether that shows up as a visible difference in the PDF is a bit 
harder to tell, but I imagine it does.

By the way, Ben, perhaps this is a good opportunity to change the 
dblatex version number to 1 :-).

    Mike Maxwell
    University of Maryland

[Dblatex-users] Fwd: dblatex mailing list?

[Benoit G. <ben...@gm...>]

---------- Forwarded message ----------
From: re...@re...
Date: Wed, 12 Jun 2019 16:29:58 -0500 (CDT)
Subject: Re: dblatex mailing list?
To: Benoit Guillon <ben...@gm...>

On Wed, 12 Jun 2019, Benoit Guillon wrote:

> It should work. I admit that's a long time I haven't looked at this
> project. I'll give a look. Meanwhile you can forward your mail to me
> if you wish.

Thanks.

My email follows:

>From re...@re... Wed Jun 12 09:48:42 2019
Date: Wed, 12 Jun 2019 09:48:40 -0500 (CDT)
From: re...@re...
To: dbl...@li...
Subject: table column valign?

My text content in tables is aligned to top of cells. I'd like it to be
centered vertically. I tried various valign options with middle or
bottom but resulting latex and PDF files don't change.

<table id="port-names-table">
<title>Common Port Names</title>
<tgroup cols="2">
<colgroup valign="bottom" />
<tbody valign="bottom">
 <row valign="bottom"><entry>CVSup</entry><entry>5999</entry></row>
 <row><entry valign="bottom">DNS</entry><entry>53</entry></row>
 <row><entry>FTP</entry><entry>21</entry></row>
....

I see share/dblatex/xsl/newtbl.xsl but don't yet understand the valign
features in there.

I think using something other than top or bottom should result in m{...}

I am using dblatex-0.3.10 on NetBSD.

I am unclear how to use newtbl.format.tbody and if it will help. I see
that can add literal latex.

[Dblatex-users] Don't know what gentext to create for xref

[Test U. <tes...@gm...>]

Consider the following Docbook 5 document:

<!DOCTYPE article[
]>

<article xmlns="http://docbook.org/ns/docbook"
      xmlns:xlink="http://www.w3.org/1999/xlink"
      xmlns:xi="http://www.w3.org/2001/XInclude">

    <title>Bug Report</title>

  <procedure xml:id="proc_id_not_found">
    <title>Procedure to demonstrate failure to find id</title>
    <step>
      <para>
        Do nothing.
      </para>
    </step>
  </procedure>
  <xi:include href="intro.xml" />

</article>

The XIncluded document contains an xref to the procedure.
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE section[
]>

<section xmlns="http://docbook.org/ns/docbook"
      xmlns:xlink="http://www.w3.org/1999/xlink"
      xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Introduction</title>
  <para>
    Please follow <xref linkend="proc_id_not_found"/>.
  </para>
</section>

When I process using xsltproc and Apache FOP, I get the expected results in
the PDF:
Please follow Procedure 1, “Procedure to demonstrate failure to find id”.

When I process with dblatex 0.3.10 the output to screen is:
$ python c:/progs/python27/scripts/dblatex document.xml
None
Build the book set list...
None
Build the listings...
None
None
XSLT stylesheets DocBook - LaTeX 2e (0.3.10)
===================================================
Stripping NS from DocBook 5/NG document.
Processing stripped document.
Don't know what gentext to create for xref to: "procedure"
(linkend=proc_id_not_found)
Build document.pdf
None
None
'document.pdf' successfully built

The PDF contains:
Please follow [?procedure].

1) Why can't it find the gentext?
2) When I run dblatex in verbose mode I see:
Stripping NS from DocBook 5/NG document.
Processing stripped document.
Don't know what gentext to create for xref to: "procedure"
(linkend=proc_id_not_found)
Build temp.pdf
built-in module pdftex registered
no support found for ifxetex
no support found for fontspec
no support found for xltxtra
no support found for fontenc
no support found for inputenc
no support found for fancybox
built-in module makeidx registered
no support found for docbook

Do I need to worry about the "no support for" messages?

Re: [Dblatex-users] Using saxon-xslt on Windows

[Mike M. <ma...@um...>]

I'm not sure what saxon-xslt.exe is; saxon seems to have a confusing 
number of versions.  As you could tell from the snippet of our config 
file, I'm using the Home Edition, as a jar file (not the .exe, which is 
presumably only for Windows).

FWIW, saxon throws a number of warnings when it runs dblatex, for instance
--------------
Warning at char 21 in xsl:if/@test on line 114 column 55 of tokens.xsl:
   SXWN9000: The attribute axis starting at an attribute node will never 
select anything
Warning at char 21 in xsl:if/@test on line 196 column 55 of glayout.xsl:
   SXWN9000: The attribute axis starting at an attribute node will never 
select anything
Warning at char 21 in xsl:if/@test on line 204 column 55 of glayout.xsl:
   SXWN9000: The attribute axis starting at an attribute node will never 
select anything
Warning at char 9 in xsl:copy-of/@select on line 66 column 38 of main.xsl:
   SXWN9000: The attribute axis starting at a document node will never 
select anything
...
Warning
   SXXP0005: The source document is in namespace 
http://docbook.org/ns/docbook, but all the
   template rules match elements in no namespace (Use 
--suppressXsltNamespaceCheck:on to avoid this warning)
-------------

I guess the namespace warning is harmless, not sure about the others.

The warnings in tokens.xsl and glayout.xsl (both are in the mathml2 
directory, which we don't use) all seem to refer to this:
    <xsl:if test="@color[not(@mathcolor)] or @mathcolor">
Perhaps what is meant is
    <xsl:if (test="@color and not(@mathcolor)) or @mathcolor">
But xslt is my least favorite programming language, so I'm probably wrong.

As for the "attribute axis starting at a document node will never select 
anything" warning, most of the things I googled that talk about that 
warning say that it has to do with diff's between xslt1.0 and 2.0.  That 
said, I can't say it's causing any problem for us.

    Mike Maxwell

On 2/20/2019 1:36 PM, Test User wrote:
> Thanks. I was able to modify your custom command example for my 
> environment. Also, with the help of Process Monitor from 
> www.sysinternals.com <http://www.sysinternals.com>, I discovered 
> that  dblatex was looking for saxon-xslt.exe, which was why it  did not 
> find my script saxon-xslt even though it was on my PATH. I think that I 
> would still like to find that program although I can do without it.
> 
> On Tue, Feb 19, 2019 at 10:16 PM Mike Maxwell <ma...@um... 
> <mailto:ma...@um...>> wrote:
> 
>     By coincidence, I encountered just this issue today, when I moved our
>     dblatex installation from one Linux computer to another.  Saxon was
>     installed in different places on the two computers, and it was getting
>     called with the old path on the new computer.  Turned out we had set
>     the
>     path in our dblatex.xml configuration file, describe here:
>     http://dblatex.sourceforge.net/doc/manual/sec-specs.html
>     In particular, we set the path to saxon in the
>     config/xslt/engine/command element:
> 
>     ...
>     <xslt>
>           <engine param-format="%(param_name)s=%(param_value)s">
>             <command>
>             /bin/java -d64 -jar /usr/local/saxon/saxon9he.jar
>             -o:%(output)s
>             -s:%(xmlfile)s
>             -xsl:%(stylesheet)s %(param_list)s</command>
>           </engine>
>     </xslt>
>     ...
> 
>     You could probably pass the path on the command line, but if you do
>     this
>     often, it's more convenient to do so in this config file.  You tell
>     dblatex the location of this config file using the -c command line
>     parameter.
>     -- 
>          Mike Maxwell
>          "My definition of an interesting universe is
>          one that has the capacity to study itself."
>                --Stephen Eastmond
> 
>     On 2/19/2019 6:16 PM, Test User wrote:
>      > I would like to try Saxon xslt on Windows. The verbose option
>     told me
>      > that dblatex calls saxon-xslt. I don't have that program but an
>     article
>      > (possibly in the dblatex mailing list archives) said that
>     saxon-xslt is
>      > simply a wrapper for java -jar /path/to/saxon.jar. I made a
>     script (I am
>      > running within MSYS, which is like Cygwin) and put it in my PATH:
>      > $ saxon-xslt
>      > calling saxon-xslt
>      > No source file name
>      > SAXON 6.5.5 from Michael Kay
>      > Usage:  java com.icl.saxon.StyleSheet [options] source-doc style-doc
>      > {param=value}...
>      > Options:
>      >    -a              Use xml-stylesheet PI, not style-doc argument
>      > ...
>      >
>      > I added
>      > echo "calling saxon-xslt" to the top of my saxon-xslt script to
>     verify
>      > that saxon-xslt was the file that could not be found below.
>      >
>      > $ python c:/progs/python27/scripts/dblatex   -m saxon  -V temp.xml
>      > Build the book set list...
>      > saxon-xslt -o doclist.txt
>      > C:\Users\testuser448\AppData\Local\Temp\book\temp.xml doclist.xsl
>      > Unexpected error occured
>      > Error: [Error 2] The system cannot find the file specified
>      >
>      > Where do I get saxon-xslt? Where does dblatex expect to find it?
>      >
>      >
>      >
>      >
>      >
>      > _______________________________________________
>      > Dblatex-users mailing list
>      > Dbl...@li...
>     <mailto:Dbl...@li...>
>      > https://lists.sourceforge.net/lists/listinfo/dblatex-users
>      >
> 
> 
> 
> _______________________________________________
> Dblatex-users mailing list
> Dbl...@li...
> https://lists.sourceforge.net/lists/listinfo/dblatex-users
> 

-- 
    Mike Maxwell
    "My definition of an interesting universe is
    one that has the capacity to study itself."
          --Stephen Eastmond

Re: [Dblatex-users] Using saxon-xslt on Windows

[Test U. <tes...@gm...>]

Thanks. I was able to modify your custom command example for my
environment. Also, with the help of Process Monitor from
www.sysinternals.com, I discovered that  dblatex was looking for
saxon-xslt.exe, which was why it  did not find my script saxon-xslt even
though it was on my PATH. I think that I would still like to find that
program although I can do without it.

On Tue, Feb 19, 2019 at 10:16 PM Mike Maxwell <ma...@um...>
wrote:

> By coincidence, I encountered just this issue today, when I moved our
> dblatex installation from one Linux computer to another.  Saxon was
> installed in different places on the two computers, and it was getting
> called with the old path on the new computer.  Turned out we had set the
> path in our dblatex.xml configuration file, describe here:
>     http://dblatex.sourceforge.net/doc/manual/sec-specs.html
> In particular, we set the path to saxon in the
> config/xslt/engine/command element:
>
> ...
> <xslt>
>      <engine param-format="%(param_name)s=%(param_value)s">
>        <command>
>        /bin/java -d64 -jar /usr/local/saxon/saxon9he.jar
>        -o:%(output)s
>        -s:%(xmlfile)s
>        -xsl:%(stylesheet)s %(param_list)s</command>
>      </engine>
> </xslt>
> ...
>
> You could probably pass the path on the command line, but if you do this
> often, it's more convenient to do so in this config file.  You tell
> dblatex the location of this config file using the -c command line
> parameter.
> --
>     Mike Maxwell
>     "My definition of an interesting universe is
>     one that has the capacity to study itself."
>           --Stephen Eastmond
>
> On 2/19/2019 6:16 PM, Test User wrote:
> > I would like to try Saxon xslt on Windows. The verbose option told me
> > that dblatex calls saxon-xslt. I don't have that program but an article
> > (possibly in the dblatex mailing list archives) said that saxon-xslt is
> > simply a wrapper for java -jar /path/to/saxon.jar. I made a script (I am
> > running within MSYS, which is like Cygwin) and put it in my PATH:
> > $ saxon-xslt
> > calling saxon-xslt
> > No source file name
> > SAXON 6.5.5 from Michael Kay
> > Usage:  java com.icl.saxon.StyleSheet [options] source-doc style-doc
> > {param=value}...
> > Options:
> >    -a              Use xml-stylesheet PI, not style-doc argument
> > ...
> >
> > I added
> > echo "calling saxon-xslt" to the top of my saxon-xslt script to verify
> > that saxon-xslt was the file that could not be found below.
> >
> > $ python c:/progs/python27/scripts/dblatex   -m saxon  -V temp.xml
> > Build the book set list...
> > saxon-xslt -o doclist.txt
> > C:\Users\testuser448\AppData\Local\Temp\book\temp.xml doclist.xsl
> > Unexpected error occured
> > Error: [Error 2] The system cannot find the file specified
> >
> > Where do I get saxon-xslt? Where does dblatex expect to find it?
> >
> >
> >
> >
> >
> > _______________________________________________
> > Dblatex-users mailing list
> > Dbl...@li...
> > https://lists.sourceforge.net/lists/listinfo/dblatex-users
> >
>
>

Re: [Dblatex-users] Using saxon-xslt on Windows

[Mike M. <ma...@um...>]

By coincidence, I encountered just this issue today, when I moved our 
dblatex installation from one Linux computer to another.  Saxon was 
installed in different places on the two computers, and it was getting 
called with the old path on the new computer.  Turned out we had set the 
path in our dblatex.xml configuration file, describe here:
    http://dblatex.sourceforge.net/doc/manual/sec-specs.html
In particular, we set the path to saxon in the 
config/xslt/engine/command element:

...
<xslt>
     <engine param-format="%(param_name)s=%(param_value)s">
       <command>
       /bin/java -d64 -jar /usr/local/saxon/saxon9he.jar
       -o:%(output)s
       -s:%(xmlfile)s
       -xsl:%(stylesheet)s %(param_list)s</command>
     </engine>
</xslt>
...

You could probably pass the path on the command line, but if you do this 
often, it's more convenient to do so in this config file.  You tell 
dblatex the location of this config file using the -c command line 
parameter.
-- 
    Mike Maxwell
    "My definition of an interesting universe is
    one that has the capacity to study itself."
          --Stephen Eastmond

On 2/19/2019 6:16 PM, Test User wrote:
> I would like to try Saxon xslt on Windows. The verbose option told me 
> that dblatex calls saxon-xslt. I don't have that program but an article 
> (possibly in the dblatex mailing list archives) said that saxon-xslt is 
> simply a wrapper for java -jar /path/to/saxon.jar. I made a script (I am 
> running within MSYS, which is like Cygwin) and put it in my PATH:
> $ saxon-xslt
> calling saxon-xslt
> No source file name
> SAXON 6.5.5 from Michael Kay
> Usage:  java com.icl.saxon.StyleSheet [options] source-doc style-doc 
> {param=value}...
> Options:
>    -a              Use xml-stylesheet PI, not style-doc argument
> ...
> 
> I added
> echo "calling saxon-xslt" to the top of my saxon-xslt script to verify 
> that saxon-xslt was the file that could not be found below.
> 
> $ python c:/progs/python27/scripts/dblatex   -m saxon  -V temp.xml
> Build the book set list...
> saxon-xslt -o doclist.txt 
> C:\Users\testuser448\AppData\Local\Temp\book\temp.xml doclist.xsl
> Unexpected error occured
> Error: [Error 2] The system cannot find the file specified
> 
> Where do I get saxon-xslt? Where does dblatex expect to find it?
> 
> 
> 
> 
> 
> _______________________________________________
> Dblatex-users mailing list
> Dbl...@li...
> https://lists.sourceforge.net/lists/listinfo/dblatex-users
> 

[Dblatex-users] Using saxon-xslt on Windows

[Test U. <tes...@gm...>]

I would like to try Saxon xslt on Windows. The verbose option told me that
dblatex calls saxon-xslt. I don't have that program but an article
(possibly in the dblatex mailing list archives) said that saxon-xslt is
simply a wrapper for java -jar /path/to/saxon.jar. I made a script (I am
running within MSYS, which is like Cygwin) and put it in my PATH:
$ saxon-xslt
calling saxon-xslt
No source file name
SAXON 6.5.5 from Michael Kay
Usage:  java com.icl.saxon.StyleSheet [options] source-doc style-doc
{param=value}...
Options:
  -a              Use xml-stylesheet PI, not style-doc argument
...

I added
echo "calling saxon-xslt" to the top of my saxon-xslt script to verify that
saxon-xslt was the file that could not be found below.

$ python c:/progs/python27/scripts/dblatex   -m saxon  -V temp.xml
Build the book set list...
saxon-xslt -o doclist.txt
C:\Users\testuser448\AppData\Local\Temp\book\temp.xml doclist.xsl
Unexpected error occured
Error: [Error 2] The system cannot find the file specified

Where do I get saxon-xslt? Where does dblatex expect to find it?

[Dblatex-users] How do I disable chapter numbering for the index?

[Epstein, A. (DOS) <Ari...@do...>]

Mainly curiosity here.  I created a custom template for dblatex where I overrode the Index redefinition from docbook.sty to prevent numbering the Index chapter. I got it to work by making substitutions shown below in yellow highlight.  However, I am wondering what the \chapter{\indexname}{% and subsequent commented lines highlighted in green are there for.  They do not appear to be necessary to avoid section numbering.  Any explanation?

% ##############################################################################
% ### Index redefinition
% ##############################################################################

%
% Index is redefined to have the section numbered.
%
\renewenvironment{theindex}
{
  \if@twocolumn
    \@restonecolfalse
  \else
    \@restonecoltrue
  \fi
  \columnseprule \z@
  \columnsep 35\p@
  \pagebreak
  \@ifundefined{chapter}{
    \twocolumn[\section{\indexname}]%
  }{
    % To not have the number, replace makechapterhead by
    % makeschapterhead
    % \chapter{\indexname}{%
    % \@mkboth{\MakeUppercase\indexname}%
    %        {\MakeUppercase\indexname}
    % }%
    \refstepcounter{chapter}
    \twocolumn[\@makeschapterhead{\indexname}]%
  }
  \thispagestyle{plain}\parindent\z@
  \parskip\z@ \@plus .3\p@\relax
  \let\item\@idxitem
}{\if@restonecol\onecolumn\else\clearpage\fi}

\let\stdindex=\theindex
\let\endstdindex=\endtheindex
\renewenvironment{theindex}{
  \begin{stdindex}
  \@ifundefined{chapter}{}{
    % To not have the number, replace by:
    \addcontentsline{toc}{chapter}{\numberline{}\indexname}
  }
}{
  \end{stdindex}
}


Ari Epstein
Special Assistant

New York State Department of State
One Commerce Plaza, Albany, NY 12231
ari...@do...<mailto:ari...@do...> | www.dos.ny.gov/lg/<http://www.dos.ny.gov/lg/>

Re: [Dblatex-users] backslashes

[Mike M. <ma...@um...>]

On 8/15/2017 1:34 PM, ben.guillon wrote:
> It would be easier to give an answer if you could give an example of the 
> input XML, the (subset of) the XSL template, the expected latex file 
> (where does foo[PRS.3[SG.F]] occur?).

I guess you mean like a Minimal Working Example...:-)

I think I've found another way to work around the use of [] for lists in 
expex (in case anyone is wondering, I put each list element in {}, and 
then expex ignores any [] internal to the {}).  Much simpler than my 
\textrightsqbracket{} kludge.

So I think I'll rescind this request.  But thank you!

    Mike Maxwell

> On Tue, 15 Aug 2017 01:06:13 +0200, maxwell <ma...@um...> wrote:
> 
>> I am using dblatex to format grammars.  I modified some things that 
>> Andy Black had written to handle "interlinear glossing", including the 
>> necessary XSL templates for these structures.  Our XeLaTeX style sheet 
>> uses the 'expex' package to format the interlinear text.
>>
>> But I've run into a problem.  In the form of expex that we're using, a 
>> certain type of list is delineated by square brackets [].  
>> Unfortunately, we also use '[' and in particular ']' in some of our 
>> glosses.  It looks like this in our XML:
>>     <ilr:langData>foo</ilr:langData>
>>     <ilr:gloss>PRS.3[SG.F]</ilr:gloss>
>> where 'PRS.3[SG.F]' is one of our glosses containing ']'.  Our 
>> modified xsl converts this into the following latex:
>>     foo[PRS.3[SG.F]]
>> Here the outer [] is the list that expex expects.  This extra ']' from 
>> our gloss causes expex to choke, because the moment it sees a ']', it 
>> assumes that's the end of the list.
>>
>> I experimented with the latex file, and discovered that converting our 
>> ']' into a latex command would work:
>>     \newcommand{\textrightsqbracket}{]}
>>     ...
>>     foo[PRS.3\textrightsqbracket{}SG.F]]
>>
>> Unfortunately, I can't persuade dblatex to output this.  I thought I 
>> could modify the template for text() to replace any ']' in our XML 
>> with the latex command, like this:
>>     ...
>>     <xsl:value-of select="replace(., '\]', '\\textrightsqbracket{}')"/>
>>     ...
>> I think this is doing the right thing, but then something else in 
>> dblatex comes along and changes its output
>>     foo[PRS.3\textrightsqbracket{}SG.F]]
>> to
>>     foo[PRS.3\textbackslash{}textrightsqbracket\{\}SG.F]]
>> which of course doesn't work when I feed this through latex.
>>
>> I tracked the "something" in dblatex that's making this change down to 
>> this:
>>     text = text.replace("\\", r"\textbackslash")
>> in LatexCodec.encode() in the file texcodec.py, which gets called from
>>      if not(self._fontmgr):
>>         return LatexCodec.encode(self, text)
>> in XetexCodec.encode().
>>
>> It's unclear to me when this text.replace() code gets called.  In most 
>> places in the xsl, I can write
>>     <xsl:text>\foobar{}</xsl:text>
>> and the backslash doesn't get changed into a \textbackslash.  But in 
>> other places it does, and I haven't been able to avoid it happening in 
>> the template for text().
>>
>> Short of building my own post-processor for the output of dblatex, or 
>> entirely turning off the conversion of '\' to \textbackslash inside 
>> texcodec.py (which is probably dangerous!), is there any trick?  Some 
>> way to protect the '\' so
>>      \textrightsqbracket{}
>> doesn't become
>>      \textbackslash{}textrightsqbracket\{\}
>>
>> (I guess I could use \3 or some such in my .xsl, in place of the 
>> backslash before the 'textrightsqbracket', and then modify codec.py to 
>> convert \3 to a plain backslash...)
>>
>>     Mike Maxwell
>>     University of Maryland
>>
>>
>> ------------------------------------------------------------------------------ 
>>
>> Check out the vibrant tech community on one of the world's most
>> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
>> _______________________________________________
>> Dblatex-users mailing list
>> Dbl...@li...
>> https://lists.sourceforge.net/lists/listinfo/dblatex-users

-- 
    Mike Maxwell
    "My definition of an interesting universe is
    one that has the capacity to study itself."
          --Stephen Eastmond

Re: [Dblatex-users] backslashes

[ben.guillon <ben...@gm...>]

Hi,

It would be easier to give an answer if you could give an example of the  
input XML, the (subset of) the XSL template, the expected latex file  
(where does foo[PRS.3[SG.F]] occur?).

Thanks,
BG

On Tue, 15 Aug 2017 01:06:13 +0200, maxwell <ma...@um...> wrote:

> I am using dblatex to format grammars.  I modified some things that Andy  
> Black had written to handle "interlinear glossing", including the  
> necessary XSL templates for these structures.  Our XeLaTeX style sheet  
> uses the 'expex' package to format the interlinear text.
>
> But I've run into a problem.  In the form of expex that we're using, a  
> certain type of list is delineated by square brackets [].   
> Unfortunately, we also use '[' and in particular ']' in some of our  
> glosses.  It looks like this in our XML:
>     <ilr:langData>foo</ilr:langData>
>     <ilr:gloss>PRS.3[SG.F]</ilr:gloss>
> where 'PRS.3[SG.F]' is one of our glosses containing ']'.  Our modified  
> xsl converts this into the following latex:
>     foo[PRS.3[SG.F]]
> Here the outer [] is the list that expex expects.  This extra ']' from  
> our gloss causes expex to choke, because the moment it sees a ']', it  
> assumes that's the end of the list.
>
> I experimented with the latex file, and discovered that converting our  
> ']' into a latex command would work:
>     \newcommand{\textrightsqbracket}{]}
>     ...
>     foo[PRS.3\textrightsqbracket{}SG.F]]
>
> Unfortunately, I can't persuade dblatex to output this.  I thought I  
> could modify the template for text() to replace any ']' in our XML with  
> the latex command, like this:
>     ...
>     <xsl:value-of select="replace(., '\]', '\\textrightsqbracket{}')"/>
>     ...
> I think this is doing the right thing, but then something else in  
> dblatex comes along and changes its output
>     foo[PRS.3\textrightsqbracket{}SG.F]]
> to
>     foo[PRS.3\textbackslash{}textrightsqbracket\{\}SG.F]]
> which of course doesn't work when I feed this through latex.
>
> I tracked the "something" in dblatex that's making this change down to  
> this:
>     text = text.replace("\\", r"\textbackslash")
> in LatexCodec.encode() in the file texcodec.py, which gets called from
>      if not(self._fontmgr):
>         return LatexCodec.encode(self, text)
> in XetexCodec.encode().
>
> It's unclear to me when this text.replace() code gets called.  In most  
> places in the xsl, I can write
>     <xsl:text>\foobar{}</xsl:text>
> and the backslash doesn't get changed into a \textbackslash.  But in  
> other places it does, and I haven't been able to avoid it happening in  
> the template for text().
>
> Short of building my own post-processor for the output of dblatex, or  
> entirely turning off the conversion of '\' to \textbackslash inside  
> texcodec.py (which is probably dangerous!), is there any trick?  Some  
> way to protect the '\' so
>      \textrightsqbracket{}
> doesn't become
>      \textbackslash{}textrightsqbracket\{\}
>
> (I guess I could use \3 or some such in my .xsl, in place of the  
> backslash before the 'textrightsqbracket', and then modify codec.py to  
> convert \3 to a plain backslash...)
>
>     Mike Maxwell
>     University of Maryland
>
>
> ------------------------------------------------------------------------------
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> _______________________________________________
> Dblatex-users mailing list
> Dbl...@li...
> https://lists.sourceforge.net/lists/listinfo/dblatex-users

[Dblatex-users] backslashes

[maxwell <ma...@um...>]

I am using dblatex to format grammars.  I modified some things that Andy 
Black had written to handle "interlinear glossing", including the 
necessary XSL templates for these structures.  Our XeLaTeX style sheet 
uses the 'expex' package to format the interlinear text.

But I've run into a problem.  In the form of expex that we're using, a 
certain type of list is delineated by square brackets [].  
Unfortunately, we also use '[' and in particular ']' in some of our 
glosses.  It looks like this in our XML:
    <ilr:langData>foo</ilr:langData>
    <ilr:gloss>PRS.3[SG.F]</ilr:gloss>
where 'PRS.3[SG.F]' is one of our glosses containing ']'.  Our modified 
xsl converts this into the following latex:
    foo[PRS.3[SG.F]]
Here the outer [] is the list that expex expects.  This extra ']' from 
our gloss causes expex to choke, because the moment it sees a ']', it 
assumes that's the end of the list.

I experimented with the latex file, and discovered that converting our 
']' into a latex command would work:
    \newcommand{\textrightsqbracket}{]}
    ...
    foo[PRS.3\textrightsqbracket{}SG.F]]

Unfortunately, I can't persuade dblatex to output this.  I thought I 
could modify the template for text() to replace any ']' in our XML with 
the latex command, like this:
    ...
    <xsl:value-of select="replace(., '\]', '\\textrightsqbracket{}')"/>
    ...
I think this is doing the right thing, but then something else in 
dblatex comes along and changes its output
    foo[PRS.3\textrightsqbracket{}SG.F]]
to
    foo[PRS.3\textbackslash{}textrightsqbracket\{\}SG.F]]
which of course doesn't work when I feed this through latex.

I tracked the "something" in dblatex that's making this change down to 
this:
    text = text.replace("\\", r"\textbackslash")
in LatexCodec.encode() in the file texcodec.py, which gets called from
     if not(self._fontmgr):
        return LatexCodec.encode(self, text)
in XetexCodec.encode().

It's unclear to me when this text.replace() code gets called.  In most 
places in the xsl, I can write
    <xsl:text>\foobar{}</xsl:text>
and the backslash doesn't get changed into a \textbackslash.  But in 
other places it does, and I haven't been able to avoid it happening in 
the template for text().

Short of building my own post-processor for the output of dblatex, or 
entirely turning off the conversion of '\' to \textbackslash inside 
texcodec.py (which is probably dangerous!), is there any trick?  Some 
way to protect the '\' so
     \textrightsqbracket{}
doesn't become
     \textbackslash{}textrightsqbracket\{\}

(I guess I could use \3 or some such in my .xsl, in place of the 
backslash before the 'textrightsqbracket', and then modify codec.py to 
convert \3 to a plain backslash...)

    Mike Maxwell
    University of Maryland

Re: [Dblatex-users] Announce: dblatex-0.3.10

[ben.guillon <ben...@gm...>]

Hi,

The website has not been updated (it's my fault i must sync the HTML  
pages); the actual latest release is 0.3.10. The sourceforge project site  
(https://sourceforge.net/projects/dblatex) is always up to date.

Regards,
BG

On Mon, 19 Jun 2017 23:23:14 +0200, maxwell <ma...@um...> wrote:

> On 2017-04-04 16:51, ben.guillon wrote:
>> The dblatex 0.3.10 release is now available, and can be directly
>> downloaded from this URL:
>> https://sourceforge.net/projects/dblatex/files/dblatex/dblatex-0.3.10/dblatex-0.3.10.tar.bz2/download
>>  It is a minor release containing some new features. This release is  
>> also
>> registered under the Python Package Index.
>>  The detailed changes are:
>>  - Add the ability to set images for front and back covers
>> - Add the ability to pass several configuration files (-c option)
>> - Fix Debian bug #840189: drop dependency on the latex package  
>> 'multirow'
>> ...
>
> Thanks (belatedly) for this new version! (the Debian fix above solves a  
> problem which otherwise prevents dblatex from working with the new  
> TeXLive 2017)
>
> But I have a confusion; I went to
>     http://dblatex.sourceforge.net/
> which points to the older (0.3.9) version, while
>     https://sourceforge.net/projects/dblatex
> points to the new (0.3.10) version.  Why does the old URL still exist?   
> (I realize this may be a sourceforge problem...)
>
>     Mike Maxwell
>     University of Maryland

Re: [Dblatex-users] Announce: dblatex-0.3.10

[maxwell <ma...@um...>]

On 2017-04-04 16:51, ben.guillon wrote:
> The dblatex 0.3.10 release is now available, and can be directly
> downloaded from this URL:
> https://sourceforge.net/projects/dblatex/files/dblatex/dblatex-0.3.10/dblatex-0.3.10.tar.bz2/download
> 
> It is a minor release containing some new features. This release is 
> also
> registered under the Python Package Index.
> 
> The detailed changes are:
> 
> - Add the ability to set images for front and back covers
> - Add the ability to pass several configuration files (-c option)
> - Fix Debian bug #840189: drop dependency on the latex package 
> 'multirow'
> ...

Thanks (belatedly) for this new version! (the Debian fix above solves a 
problem which otherwise prevents dblatex from working with the new 
TeXLive 2017)

But I have a confusion; I went to
    http://dblatex.sourceforge.net/
which points to the older (0.3.9) version, while
    https://sourceforge.net/projects/dblatex
points to the new (0.3.10) version.  Why does the old URL still exist?  
(I realize this may be a sourceforge problem...)

    Mike Maxwell
    University of Maryland

[Dblatex-users] Announce: dblatex-0.3.10

[ben.guillon <ben...@gm...>]

Hello,

The dblatex 0.3.10 release is now available, and can be directly  
downloaded from this URL:

https://sourceforge.net/projects/dblatex/files/dblatex/dblatex-0.3.10/dblatex-0.3.10.tar.bz2/download

It is a minor release containing some new features. This release is also  
registered under the Python Package Index.

The detailed changes are:

- Add the ability to set images for front and back covers
- Add the ability to pass several configuration files (-c option)
- Fix Debian bug #840189: drop dependency on the latex package 'multirow'
- Fix Debian bug #849679: wrong character entities in el.xml
- Fix Debian bug #851145: put the paragraph title on a separate line

Regards,
BG

Re: [Dblatex-users] using Saxon

[Jan T. <j.t...@em...>]

On 2017-02-22 maxwell wrote:
> I've been using the Saxon processor, rather than xsltproc, for a couple
> months now (using the tip you gave me back then).  It produces some
> warnings with dblatex v0.3.9, which I've been ignoring, but maybe
> that's a bad idea.
> 
> One of the warnings is
> ----------
> Warning: on line 51 of main.xsl:
>    The child axis starting at an attribute node will never select
> anything
> ----------
> which refers to the first line of this code:
> ----------
>     <xsl:for-each select="node()/@*[not(id)]">
>        <xsl:copy-of select="."/>
>     </xsl:for-each>
> ----------

I don't know author intention, but for filtering attributes 'name()'
function has to be employed:

<xsl:for-each select="node()/@*[name()!='id']">
   <xsl:copy-of select="."/>
</xsl:for-each>

Regards,

Jan

[Dblatex-users] using Saxon

[maxwell <ma...@um...>]

I've been using the Saxon processor, rather than xsltproc, for a couple 
months now (using the tip you gave me back then).  It produces some 
warnings with dblatex v0.3.9, which I've been ignoring, but maybe that's 
a bad idea.

One of the warnings is
----------
Warning: on line 51 of main.xsl:
   The child axis starting at an attribute node will never select 
anything
----------
which refers to the first line of this code:
----------
    <xsl:for-each select="node()/@*[not(id)]">
       <xsl:copy-of select="."/>
    </xsl:for-each>
----------

Other warnings are
     The attribute axis starting at an attribute node will never select 
anything
     SXWN9001: A variable with no following sibling instructions has no 
effect

I'm not enough of an xslt programmer to know what the affected pieces of 
code are doing, nor do I know whether these are real errors in the 
dblatex code, or problems in Saxon.

Should I worry?  Should I revert to using xsltproc?

    Mike Maxwell
    University of Maryland

[Dblatex-users] Customizing Header

[Patrick B. K. <p...@sy...>]

Greetings,

I'm looking for a way to customize the header section. I'd like to add a
string, which should be printed on any page (except cover pages).

Unfortunately my own attemtps have all failed. I've tried to modify the latex
(which I am not very good at) and docbook xsl templates.

Any advice how I could acchieve what I want?

TIA

p@rick


-- 
[*] sys4 AG
 
https://sys4.de, +49 (89) 30 90 46 64
Schleißheimer Straße 26/MG,80333 München
 
Sitz der Gesellschaft: München, Amtsgericht München: HRB 199263
Vorstand: Patrick Ben Koetter, Marc Schiffbauer
Aufsichtsratsvorsitzender: Florian Kirstein