Thread: [Dblatex-users] Announce: dblatex-0.2.9

Hello,

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

http://prdownloads.sourceforge.net/dblatex/dblatex-0.2.9.tar.bz2?download

It is maily a bug fix release, the most significant improvement being the  
ability to use XeTeX as backend driver. XeTeX is a modern TeX engine that  
natively handles UTF-8, allowing to handle non-latin characters much  
easier than with the other tex engines.

The CVS repository is synced with this release.

The detailed changes are:

- Fix bug #1838293: <dedication> and <colophon> support where
   <title>s are optional.
- Fix bug #1833581 (biblio elements).
- Fix bug #1832623 (<userinput> rendering in normal mode).
- Fix bug #1769020 (date in <biblioentry>).
- Fix bug #1745318 with a minipage in \author{}.
   It fixes also the similar debian bug #465221.
- Fix bug #1642442 (missing unicode characters).
- Fix debian bug #466162 (German localization).
- Fix debian bug #461919 (rendering abstract titles).
- Fix debian bug #459474 (simplesect in appendix).
- Fix unicode character encoding in TeX equations in <alt>.
- Fix bug that transforms "<<" to french quotation marks.
- Fix spurious spaces in inline graphics.
- Fix to have frenchb 2.x support (option macros changed).
- Add refentry.numbered and refentry.tocdepth parameters to have
   the refentry titles numbered (default) or not.
- Add <partintro>s handling.
- Add linking to <areaset>.
- Add <emphasis> rendering in <programlisting> and <screen>.
- Add some logic to handle the graphics in equations.
   Add the alt.use parameter.
- Add some XeTeX support. One can use -b xetex to compile with
   xelatex. Add the xetex.font parameter too.
- Add the "angle" attribute to the dblatex Processing
   Instruction. When set in an <imageobject>, you can rotate
   the image to the required angle.


Regards,
BG

Am Donnerstag, den 29.05.2008, 20:53 +0200 schrieb benoit.guillon:
> Hello,
> 
> The dblatex 0.2.9 release is now available, and can be directly downloaded  
>  from this URL:
> 
Hello Beniot,

thanks for the tons of improvements in the new release. I especially
enjoy having emphasis in programlistings and getting the expected
results.
Some minor remarks:
* ifxetex.sty does not seem to be part of good old TeTeX. Yes, I know I
should migrate to the new texlive, but you might want to include
ifxetex.sty for the users of pre-texlive.
* For 0.2.8, I reported that while the template inline.monoseq honors
the parameter monoseq.small inline.italicmonoseq is hard-coded to \small
which I seem to remember you acknowledged as a minor issue. It's just
that the corresponding patch has not made it into 0.2.9. Just wanted to
know whether that was a conscious decision or it just got lost
somewhere.
* Another thing we discussed back on 0.2.8 was whether it is a good idea
to use corpauthor for the author in case none of the other author tags
is present. You seemed reluctant to look at corpauthor, even if it was
just in order to avoid the author being empty. Just wanted a final
answer from your side (so I will definitely not raise the question
again).
* You introduced some nice parameters to configure refentry numbering
which I appreciate very much. This only leaves the glossary as
hard-coded numbered, but I would assume that some people like me prefer
it to be unnumbered.

Thanks,
-- 
Sven Beyer
aim  : tzwaennbeyer     icq : 322204928
mail : ma...@tz...  www : http://www.tzwaenn.de/

Hi Sven,

On Mon, 02 Jun 2008 20:44:48 +0200, Sven Beyer <ma...@tz...> wrote:

> Am Donnerstag, den 29.05.2008, 20:53 +0200 schrieb benoit.guillon:
>> Hello,
>>
>> The dblatex 0.2.9 release is now available, and can be directly  
>> downloaded
>>  from this URL:
>>
> Hello Beniot,
>
> thanks for the tons of improvements in the new release. I especially
> enjoy having emphasis in programlistings and getting the expected
> results.
> Some minor remarks:
> * ifxetex.sty does not seem to be part of good old TeTeX. Yes, I know I
> should migrate to the new texlive, but you might want to include
> ifxetex.sty for the users of pre-texlive.

Yes, I guess I should add some additionnal controls.

> * For 0.2.8, I reported that while the template inline.monoseq honors
> the parameter monoseq.small inline.italicmonoseq is hard-coded to \small
> which I seem to remember you acknowledged as a minor issue. It's just
> that the corresponding patch has not made it into 0.2.9. Just wanted to
> know whether that was a conscious decision or it just got lost
> somewhere.

It was lost. BTW, I think it's time to refactor the monoseq inline stuff:  
too much code is duplicated.

> * Another thing we discussed back on 0.2.8 was whether it is a good idea
> to use corpauthor for the author in case none of the other author tags
> is present. You seemed reluctant to look at corpauthor, even if it was
> just in order to avoid the author being empty. Just wanted a final
> answer from your side (so I will definitely not raise the question
> again).

Let me think a bit more about this.

> * You introduced some nice parameters to configure refentry numbering
> which I appreciate very much. This only leaves the glossary as
> hard-coded numbered, but I would assume that some people like me prefer
> it to be unnumbered.

You're right, it is reasonnable to think that glossary headings should  
work like the other unnumbered sections. I'll put it in the TODO list.

Regards,
BG

benoit.guillon wrote:
> 
> It was lost. BTW, I think it's time to refactor the monoseq inline 
> stuff: too much code is duplicated.
> 
Hi Benoit,

the fact that you bring up code clean-up makes me submit another patch 
for your review. The patch basically just encapsulate all creation of 
hyperlinks in a single template, create.hyperlink, which also has the 
referrer as a parameter. Should be completely transparent to the user 
(and hopefully have a negligible effect on performance).
Note that I'm not very much concerned with clean code - I need the patch 
to allow different treatment of hyperlinks depending on whether referrer 
and target are in the same book or not (If you remember, I'm using 
dblatex to produce latex for a whole set of books and then do the 
interleaved-latex runs to allow for cross-references between documents). 
The patch allows me to do this different treatment by just overloading 
the single template create.hyperlink.
As I said, I see little benefit in this patch for dblatex as such apart 
from slightly better structured code. The main benefit would admittedly 
be on my side by keeping my patch to the latest release as small as 
possible (or even non-existent). But if you seriously consider 
refactoring some stuff anyway, the patch might actually appeal to you...

Cheers,
-- 
Sven Beyer

On Mon, 02 Jun 2008 20:44:48 +0200, Sven Beyer <ma...@tz...> wrote:

> * You introduced some nice parameters to configure refentry numbering
> which I appreciate very much. This only leaves the glossary as
> hard-coded numbered, but I would assume that some people like me prefer
> it to be unnumbered.

Please find attached a patch that gives the same behaviour to glossary  
than for refentry. Two parameters added:

glossary.numbered
glossary.tocdepth

Regards,
BG

I have just tried to install the brand new verison following the usual 
procedure (>python setup.py install). After many succcessful 
"checkings", the installation programs exits issuing an error:

"Error: not found: ifxetex
setup.py:297: RuntimeWarning: tp_compare didn't return -1 or -2 for 
exeption sys.exit(1)"

At present I'm not using (neither even installed) XeTex. Do I need to 
install some new XeTex related package in order to have the new version 
of DBLatex working??

Regards.
Pedro

benoit.guillon escribió:
> Hello,
>
> The dblatex 0.2.9 release is now available, and can be directly downloaded  
>  from this URL:
>
> http://prdownloads.sourceforge.net/dblatex/dblatex-0.2.9.tar.bz2?download
>
> It is maily a bug fix release, the most significant improvement being the  
> ability to use XeTeX as backend driver. XeTeX is a modern TeX engine that  
> natively handles UTF-8, allowing to handle non-latin characters much  
> easier than with the other tex engines.
>
> The CVS repository is synced with this release.
>
> The detailed changes are:
>
> - Fix bug #1838293: <dedication> and <colophon> support where
>    <title>s are optional.
> - Fix bug #1833581 (biblio elements).
> - Fix bug #1832623 (<userinput> rendering in normal mode).
> - Fix bug #1769020 (date in <biblioentry>).
> - Fix bug #1745318 with a minipage in \author{}.
>    It fixes also the similar debian bug #465221.
> - Fix bug #1642442 (missing unicode characters).
> - Fix debian bug #466162 (German localization).
> - Fix debian bug #461919 (rendering abstract titles).
> - Fix debian bug #459474 (simplesect in appendix).
> - Fix unicode character encoding in TeX equations in <alt>.
> - Fix bug that transforms "<<" to french quotation marks.
> - Fix spurious spaces in inline graphics.
> - Fix to have frenchb 2.x support (option macros changed).
> - Add refentry.numbered and refentry.tocdepth parameters to have
>    the refentry titles numbered (default) or not.
> - Add <partintro>s handling.
> - Add linking to <areaset>.
> - Add <emphasis> rendering in <programlisting> and <screen>.
> - Add some logic to handle the graphics in equations.
>    Add the alt.use parameter.
> - Add some XeTeX support. One can use -b xetex to compile with
>    xelatex. Add the xetex.font parameter too.
> - Add the "angle" attribute to the dblatex Processing
>    Instruction. When set in an <imageobject>, you can rotate
>    the image to the required angle.
>
>
> Regards,
> BG
>
> -------------------------------------------------------------------------
> This SF.net email is sponsored by: Microsoft
> Defy all challenges. Microsoft(R) Visual Studio 2008.
> http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
> _______________________________________________
> Dblatex-users mailing list
> Dbl...@li...
> https://lists.sourceforge.net/lists/listinfo/dblatex-users
>   

Pedro Pastor <pp...@dl...> wrote:

<snip/>
> At present I'm not using (neither even installed) XeTex. Do I need to
> install some new XeTex related package in order to have the new version
> of DBLatex working??
>
> Regards.
> Pedro
<snip/>

Hi,

if you compile an arbitrary DocBook document with dblatex 0.2.9 using
the --debug switch, you will note in the resulting ..._tmp.tex file the
line:

\usepackage{ifxetex}

Thus you will need some part of XeTeX, even if you don't use this new
backend.

The issue has been addressed in the 0.2.9 announce mail thread [1].

[1] http://sourceforge.net/mailarchive/forum.php?thread_name=op.ubxirpt9n8yfof%40venus&forum_name=dblatex-users

Regards, Andreas
-- 
Andreas Hoenen <an...@ho...>
GPG: 1024D/B888D2CE
     A4A6 E8B5 593A E89B 496B
     82F0 728D 8B7E B888 D2CE

Thank you vey much Andreas for your response.

The point is I connot even finish the installation of dblatex 0.2.9,
then I cannot compile "an arbitrary DocBook document" as you are
suggesting me.

On the other hand, you are rigth, some troubles about "ifxetex" package 
were mentioned, BUT from those comments I cannot work out how can I 
solve my problems (I don't know anything about an "ifxetex.sty" file and 
what's the connection to my problem).

I'm sorry, I'm not a LaTex expert (neither a XeTex one). Could you 
explain me (in plain words) what I should do in order to get dblatex 
0.2.9 working.

Thank you very much.

Pedro


Andreas Hoenen escribió:
> Pedro Pastor <pp...@dl...> wrote:
>
> <snip/>
>   
>> At present I'm not using (neither even installed) XeTex. Do I need to
>> install some new XeTex related package in order to have the new version
>> of DBLatex working??
>>
>> Regards.
>> Pedro
>>     
> <snip/>
>
> Hi,
>
> if you compile an arbitrary DocBook document with dblatex 0.2.9 using
> the --debug switch, you will note in the resulting ..._tmp.tex file the
> line:
>
> \usepackage{ifxetex}
>
> Thus you will need some part of XeTeX, even if you don't use this new
> backend.
>
> The issue has been addressed in the 0.2.9 announce mail thread [1].
>
> [1] http://sourceforge.net/mailarchive/forum.php?thread_name=op.ubxirpt9n8yfof%40venus&forum_name=dblatex-users
>
> Regards, Andreas
>   

Pedro Pastor <pp...@dl...> wrote:

<snip/>
> I'm sorry, I'm not a LaTex expert (neither a XeTex one). Could you explain me
> (in plain words) what I should do in order to get dblatex 0.2.9 working.

Okay,

you can try this quick and dirty hack (just tested at my box):

1) Persuade dblatex to ignore the missing dependency and install anyhow:

   In setup.py comment the lines 286-287, so that they look like:

#         if mis_stys:
#             raise OSError("not found: %s" % ", ".join(mis_stys))

   After that dblatex can be installed.

2) Download the missing file ifxetex.sty into the directory where your
   DocBook documents reside, e.g. from [1].

   After that compilation succeeds.

   But don't forget that this solution is a dirty hack, an alternative
   could be just to install XeTeX.  It seems to be a nice backend.

[1] http://texcatalogue.sarovar.org/entries/ifxetex.html

Hope this helps, Andreas
-- 
Andreas Hoenen <an...@ho...>
GPG: 1024D/B888D2CE
     A4A6 E8B5 593A E89B 496B
     82F0 728D 8B7E B888 D2CE

Thank you very much (again) Andreas for your help and your patience.

Abusing a little bit more on your patience, I have an extra question.

I'm working on Windows platform using MikTex 2.5 (and xsltproc): Is 
XeTex "something" I could install/update using MikTex or I have to get 
rid of MikTex and install a different Tex processor/engine into the 
processing chain (Tex_processor=xsltproc=python)?

Regards,
Pedro

Andreas Hoenen escribió:
> Pedro Pastor <pp...@dl...> wrote:
>
> <snip/>
>   
>> I'm sorry, I'm not a LaTex expert (neither a XeTex one). Could you explain me
>> (in plain words) what I should do in order to get dblatex 0.2.9 working.
>>     
>
> Okay,
>
> you can try this quick and dirty hack (just tested at my box):
>
> 1) Persuade dblatex to ignore the missing dependency and install anyhow:
>
>    In setup.py comment the lines 286-287, so that they look like:
>
> #         if mis_stys:
> #             raise OSError("not found: %s" % ", ".join(mis_stys))
>
>    After that dblatex can be installed.
>
> 2) Download the missing file ifxetex.sty into the directory where your
>    DocBook documents reside, e.g. from [1].
>
>    After that compilation succeeds.
>
>    But don't forget that this solution is a dirty hack, an alternative
>    could be just to install XeTeX.  It seems to be a nice backend.
>
> [1] http://texcatalogue.sarovar.org/entries/ifxetex.html
>
> Hope this helps, Andreas
>   

Hello,

On Wed, 04 Jun 2008 11:20:30 +0200, Pedro Pastor <pp...@dl...> wrote:

> I have just tried to install the brand new verison following the usual
> procedure (>python setup.py install). After many succcessful
> "checkings", the installation programs exits issuing an error:
>
> "Error: not found: ifxetex
> setup.py:297: RuntimeWarning: tp_compare didn't return -1 or -2 for
> exeption sys.exit(1)"
>
> At present I'm not using (neither even installed) XeTex. Do I need to
> install some new XeTex related package in order to have the new version
> of DBLatex working??



>
> Regards.
> Pedro
>
> benoit.guillon escribió:
>> Hello,
>>
>> The dblatex 0.2.9 release is now available, and can be directly  
>> downloaded
>>  from this URL:
>>
>> http://prdownloads.sourceforge.net/dblatex/dblatex-0.2.9.tar.bz2?download
>>
>> It is maily a bug fix release, the most significant improvement being  
>> the
>> ability to use XeTeX as backend driver. XeTeX is a modern TeX engine  
>> that
>> natively handles UTF-8, allowing to handle non-latin characters much
>> easier than with the other tex engines.
>>
>> The CVS repository is synced with this release.
>>
>> The detailed changes are:
>>
>> - Fix bug #1838293: <dedication> and <colophon> support where
>>    <title>s are optional.
>> - Fix bug #1833581 (biblio elements).
>> - Fix bug #1832623 (<userinput> rendering in normal mode).
>> - Fix bug #1769020 (date in <biblioentry>).
>> - Fix bug #1745318 with a minipage in \author{}.
>>    It fixes also the similar debian bug #465221.
>> - Fix bug #1642442 (missing unicode characters).
>> - Fix debian bug #466162 (German localization).
>> - Fix debian bug #461919 (rendering abstract titles).
>> - Fix debian bug #459474 (simplesect in appendix).
>> - Fix unicode character encoding in TeX equations in <alt>.
>> - Fix bug that transforms "<<" to french quotation marks.
>> - Fix spurious spaces in inline graphics.
>> - Fix to have frenchb 2.x support (option macros changed).
>> - Add refentry.numbered and refentry.tocdepth parameters to have
>>    the refentry titles numbered (default) or not.
>> - Add <partintro>s handling.
>> - Add linking to <areaset>.
>> - Add <emphasis> rendering in <programlisting> and <screen>.
>> - Add some logic to handle the graphics in equations.
>>    Add the alt.use parameter.
>> - Add some XeTeX support. One can use -b xetex to compile with
>>    xelatex. Add the xetex.font parameter too.
>> - Add the "angle" attribute to the dblatex Processing
>>    Instruction. When set in an <imageobject>, you can rotate
>>    the image to the required angle.
>>
>>
>> Regards,
>> BG
>>
>> -------------------------------------------------------------------------
>> This SF.net email is sponsored by: Microsoft
>> Defy all challenges. Microsoft(R) Visual Studio 2008.
>> http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
>> _______________________________________________
>> Dblatex-users mailing list
>> Dbl...@li...
>> https://lists.sourceforge.net/lists/listinfo/dblatex-users
>>
>
>
> -------------------------------------------------------------------------
> Check out the new SourceForge.net Marketplace.
> It's the best place to buy or sell services for
> just about anything Open Source.
> http://sourceforge.net/services/buy/index.php
> _______________________________________________
> Dblatex-users mailing list
> Dbl...@li...
> https://lists.sourceforge.net/lists/listinfo/dblatex-users

Hello,

On Wed, 04 Jun 2008 11:20:30 +0200, Pedro Pastor <pp...@dl...> wrote:

> At present I'm not using (neither even installed) XeTex. Do I need to
> install some new XeTex related package in order to have the new version
> of DBLatex working??

Sorry for the noise about the xetex support. Please try the following  
workaround patch. If you need the plain files, tell me. Andreas, I guess  
it's worth including it in your debian version (provided you confirm it  
fixes the troubles).

Regards,
BG

Hi Ben,

Thanks for the patch.

On the ohter hand, if you think it would be better to move to XeTex (if, 
as Andreas said, XeTex is the future for Tex processing) I don't mind 
the migration. I'm using MikTex engine under Windows. What should I do 
to move to XeTex?

Regards,
Pedro


ben.guillon escribió:
> Hello,
>
> On Wed, 04 Jun 2008 11:20:30 +0200, Pedro Pastor <pp...@dl...> wrote:
>
>> At present I'm not using (neither even installed) XeTex. Do I need to
>> install some new XeTex related package in order to have the new version
>> of DBLatex working??
>
> Sorry for the noise about the xetex support. Please try the following 
> workaround patch. If you need the plain files, tell me. Andreas, I 
> guess it's worth including it in your debian version (provided you 
> confirm it fixes the troubles).
>
> Regards,
> BG

Hi Pedro,

On Thu, 05 Jun 2008 10:23:18 +0200, Pedro Pastor <pp...@dl...> wrote:

> Thanks for the patch.
>
> On the ohter hand, if you think it would be better to move to XeTex (if,
> as Andreas said, XeTex is the future for Tex processing) I don't mind
> the migration. I'm using MikTex engine under Windows. What should I do
> to move to XeTex?

To be fair I think the xetex support in dblatex is not mature enough. It  
works for most of things, but some recent bug reports show that some  
improvements are needed. So, in a conservative approach there's no need to  
rush to xetex.

This said, when things are more stable (especially localization and font  
selection in dblatex), xetex will be a quite good backend. But I cannot  
help you about installing on windows since I 'm not a windows user. Maybe  
you can look at this URL:  
http://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/web2c75-e.html

Regards,
BG

ben.guillon <ben...@gm...> wrote:

Hi Benoît,

<snip/>
> Sorry for the noise about the xetex support. Please try the following
> workaround patch. If you need the plain files, tell me. Andreas, I guess  it's
> worth including it in your debian version (provided you confirm it  fixes the
> troubles).
<snip/>

too late, debian dblatex 0.2.9-1 has just been released.  (My new
sponsor is lightning fast :-)) )  For debian it isn't a problem anyhow,
as I just had to add a dependency on texlive-xetex.  However, if your
patch proves itself, I will relax this dependency from an absolute to an
optional one with dblatex 0.2.10.

Regards, Andreas
-- 
Andreas Hoenen <an...@ho...>
GPG: 1024D/B888D2CE
     A4A6 E8B5 593A E89B 496B
     82F0 728D 8B7E B888 D2CE

Pedro Pastor <pp...@dl...> wrote:

<snip/>
> On the ohter hand, if you think it would be better to move to XeTex (if, 
> as Andreas said, XeTex is the future for Tex processing) I don't mind 
> the migration. I'm using MikTex engine under Windows. What should I do 
> to move to XeTex?
<snip/>

I hope I didn't expressed it that strongly, as I don't know much more
about XeTeX than that it a modern and very interesting looking TeX
engine.  It might be worth a try.  OTOH, Benoît's patch will save you
the work of installing it.

Sorry, as a passionate Linux user my Windows experience is very limited,
thus I can't tell you much about dblatex/TeX/Windows.  However, a
brief glance into the MiKTeX Wikipedia [1] article reveals that MiKTeX
2.7 has integrated XeTeX...

A personal note: For someone familiar with Linux the simplest way to use
dblatex on a Windows PC could be to install andLinux [2] under Windows
and either to use the dblatex packaged with Ubuntu or to install the
native dblatex under Ubuntu.  Thus I'm not likely to ever use MiKTeX ;-)

[1] http://en.wikipedia.org/wiki/Miktex
[2] http://www.andlinux.org/

Regards, Andreas
-- 
Andreas Hoenen <an...@ho...>
GPG: 1024D/B888D2CE
     A4A6 E8B5 593A E89B 496B
     82F0 728D 8B7E B888 D2CE