Csound Csound-dev Csound-tekno Search About

Re: [Cs-dev] PDF manual

Date2010-03-18 15:41
FromFrancois PINOT
SubjectRe: [Cs-dev] PDF manual
AttachmentsNone  None  
Hi Steven

The http://xml.apache.org/fop/extensions namespace has changed to http://xmlgraphics.apache.org/fop/extensions for FOP versions 0.90 and higher. If your docbook.xsl package doesn't reflect this, then you get a compilation error. This is the case in Ubuntu 9.10 with the distributed docbook-xsl package. I manually changed line 4 of the file /usr/share/xml/docbook/stylesheet/docbook-xsl/fo/fop.xsl from xmlns:fox="http://xml.apache.org/fop/extensions" to xmlns:fox="http://xmlgraphics.apache.org/fop/extensions" and it worked.

But then I got other compilation errors due to docbook errors in the xml articles. For example, in the opcodes/defines.xml file, the table is declared with 2 columns (tgroup cols="2") and its rows have 3 cells each. It seems that fop-0.95 is less permissive than fop-0.20.5 about such things.

Unfortunately, I don't have enough time now to debug the manual for fop-0.95, so I will go on using fop-0.20.5 at the moment. I will be able to do this debugging work in a few weeks, I hope...

Regards

François


From: Steven Yi <stevenyi@gmail.com>
Subject: Re: [Cs-dev] PDF manual
To: Developer discussions <csound-devel@lists.sourceforge.net>
Message-ID:
       <4af92f7c1003170735l4b55b74em65fae69a737b4d3@mail.gmail.com>
Content-Type: text/plain; charset=ISO-8859-1

Hi Francois,

Could you elaborate on the known problem?  I use 0.95 with blue's
manual and haven't had problems and want to know if there's anything I
should be avoiding.

Thanks!
steven

On Wed, Mar 17, 2010 at 6:43 AM, Francois PINOT <fggpinot@gmail.com> wrote:
> Well, with fop-0.20.5, the error appeared toward the end of compilation. And
> I remembered that we once had the same problem with quickref.xml. In fact,
> examples.xml is not well formed referring to docbook. The <part> component
> should have a direct child among those ones: <appendix>, <chapter>, etc (see
> http://www.docbook.org/tdg/en/html/part.html). Maybe we could generate a
> single file from quickref.py that would include both opcodes quickref and
> examples as two <chapter> children of the <part> element? I can investigate
> to produce a static xml example before we modify quickref.xml, but I've no
> time to do it in the next few days.
>
> With fop-0.95 it doesn't work anyway. I even try with a trunk version from
> apache svn with the same errors. By googling about the topic, it seems that
> it's a known problem between docbook and fop-0.9x. So I would recommend to
> stay with fop-0.20.5
>
> Regards
>
> Fran?ois
>