Login | Register For Free | Help
Search for: (Advanced)

Mailing List Archive: Apache: Docs

Problems With Doc Build Target "latex-en"

 

 

Apache docs RSS feed   Index | Next | Previous | View Threaded


tom.browder at gmail

Jul 6, 2012, 4:57 AM

Post #1 of 15 (1477 views)
Permalink
Problems With Doc Build Target "latex-en"

[.Note: I originally sent the following to the dev list, subject:
Errors Building Docs from Trunk (Apparently Solved).]

=== BEGIN QUOTE ===
I'm trying to build the docs from the trunk following instructions here:

http://httpd.apache.org/docs-project/docsformat.html

(Note the first heading on the page is "Module Format and
Transformation" which I believe would better read "Document Format and
Transformation" or something similar.)

I tried the target:

$ ./build.sh latex-en

and got these errors:

latex-en:
[xslt] Processing
/usr/local/src/apache-trunk-svn/docs/manual/misc/perf-scaling.xml to
/usr/local/src/apache-trunk-svn/docs/manual/misc/perf-scaling.tex
[xslt] Loading stylesheet
/usr/local/src/apache-trunk-svn/docs/manual/style/latex/latex.xsl
[xslt] : Fatal Error! org.xml.sax.SAXException: Attempt to output
character of integral value 8220 that is not represented in specified
output encoding of ISO-8859-1. Cause: org.xml.sax.SAXException:
Attempt to output character of integral value 8220 that is not
represented in specified output encoding of ISO-8859-1.
[xslt] Failed to process
/usr/local/src/apache-trunk-svn/docs/manual/misc/perf-scaling.xml

BUILD FAILED
/usr/local/src/apache-trunk-svn/docs/manual/style/lang-targets.xml:106:
The following error occurred while executing this line:
/usr/local/src/apache-trunk-svn/docs/manual/build/build.xml:805: The
following error occurred while executing this line:
/usr/local/src/apache-trunk-svn/docs/manual/build/build.xml:820: Fatal
error during transformation

I looked at file "docs/manual/style/latex/latex.xsl" and noticed this
code chunk:

<xsl:output
method="text"
encoding="ISO-8859-1"
indent="no"
/>

I also noticed other style sheets with the same chunk. Is there any
reason not to use 'encoding="utf-8"' instead of "ISO-8859-1" in all
such chunks?

If that is correct and intended, can anyone help with that error?

In the meantime I changed all the xsl files with the ISO encoding and
changed them to "utf-8" and got an apparent good build. However,
there are still charsets and other encoding references to ISO-8858-1,
so someone knowledgeable of the doc direction needs to comment.
=== END QUOTE ===

[.Note: Then I followed that with an updated message with modified
subject: Re: Errors Building Docs from Trunk (Apparently Solved)
[NOT].]

=== BEGIN QUOTE ===
Hm, the "sitemap.tex" was built but it failed when running it though "pdflatex."

Has there been any discussion of converting the inputs to DocBook?
=== END QUOTE ===

I am interested in helping the situation and have some good experience
in DocBook 5 using the xsltproc/fop tool chain in my own project for
html and pdf output. I also have contributed to the DocBook work flow
for html, pdf, and man page generation for the open source project
BRL-CAD (http://brlcad.org).

Best regards,

-Tom

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd


tom.browder at gmail

Jul 11, 2012, 3:41 AM

Post #2 of 15 (1434 views)
Permalink
Re: Problems With Doc Build Target "latex-en" [In reply to]

...
> I am interested in helping the situation and have some good experience
> in DocBook 5 using the xsltproc/fop tool chain in my own project for
> html and pdf output. I also have contributed to the DocBook work flow
> for html, pdf, and man page generation for the open source project
> BRL-CAD (http://brlcad.org).

And I have just been reminded of a great tool that may be of use in
the process, Pandoc:

http://johnmacfarlane.net/pandoc/index.html

Best regards,

-Tom

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd


tsnyder at gsscomputer

Jul 11, 2012, 3:56 AM

Post #3 of 15 (1432 views)
Permalink
Re: Problems With Doc Build Target "latex-en" [In reply to]

I will be out of the office beginning July 9th and returning on July 16th. Please call the office at
540 362-7686 and ask for service.

Thank you
Tim T Snyder
GSS Computer Technology


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd


vincent at delau

Jul 11, 2012, 4:22 AM

Post #4 of 15 (1429 views)
Permalink
RE: Problems With Doc Build Target "latex-en" [In reply to]

> I am interested in helping the situation and have some good experience
> in DocBook 5 using the xsltproc/fop tool chain in my own project for
> html and pdf output. I also have contributed to the DocBook work flow
> for html, pdf, and man page generation for the open source project BRL-
> CAD (http://brlcad.org).

Hi Tom,

Last week I was also looking at the PDF thing, because of a note in the
STATUS file. As an exercise to myself I was planning on using FOP to
generate PDF. That would require XSLT templates to be created to convert
the docs into XSL FO.

Regards,

Vincent de Lau
vincent [at] delau



---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd


tsnyder at gsscomputer

Jul 11, 2012, 4:36 AM

Post #5 of 15 (1430 views)
Permalink
RE: Problems With Doc Build Target "latex-en" [In reply to]

I will be out of the office beginning July 9th and returning on July 16th. Please call the office at
540 362-7686 and ask for service.

Thank you
Tim T Snyder
GSS Computer Technology


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd


nd at perlig

Jul 11, 2012, 5:15 AM

Post #6 of 15 (1433 views)
Permalink
Re: Problems With Doc Build Target "latex-en" [In reply to]

On Wednesday 11 July 2012 13:22:20 Vincent de Lau wrote:
> > I am interested in helping the situation and have some good experience
> > in DocBook 5 using the xsltproc/fop tool chain in my own project for
> > html and pdf output. I also have contributed to the DocBook work flow
> > for html, pdf, and man page generation for the open source project BRL-
> > CAD (http://brlcad.org).
>
> Hi Tom,
>
> Last week I was also looking at the PDF thing, because of a note in the
> STATUS file. As an exercise to myself I was planning on using FOP to
> generate PDF. That would require XSLT templates to be created to convert
> the docs into XSL FO.

It would be nice. I've tried that 10 years ago, but apache fop didn't have the
necessary features back then (I'm not up-to-date about them now). As a
consequence, Joshua built the latex solution.

nd

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd


tsnyder at gsscomputer

Jul 11, 2012, 5:30 AM

Post #7 of 15 (1434 views)
Permalink
Re: Problems With Doc Build Target "latex-en" [In reply to]

I will be out of the office beginning July 9th and returning on July 16th. Please call the office at
540 362-7686 and ask for service.

Thank you
Tim T Snyder
GSS Computer Technology


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd


tom.browder at gmail

Jul 11, 2012, 5:48 AM

Post #8 of 15 (1441 views)
Permalink
Re: Problems With Doc Build Target "latex-en" [In reply to]

On Wed, Jul 11, 2012 at 7:15 AM, André Malo <nd [at] perlig> wrote:
> On Wednesday 11 July 2012 13:22:20 Vincent de Lau wrote:
>> > I am interested in helping the situation and have some good experience
>> > in DocBook 5 using the xsltproc/fop tool chain in my own project for
>> > html and pdf output. I also have contributed to the DocBook work flow
>> > for html, pdf, and man page generation for the open source project BRL-
>> > CAD (http://brlcad.org).
>>
>> Hi Tom,
>>
>> Last week I was also looking at the PDF thing, because of a note in the
>> STATUS file. As an exercise to myself I was planning on using FOP to
>> generate PDF. That would require XSLT templates to be created to convert
>> the docs into XSL FO.
>
> It would be nice. I've tried that 10 years ago, but apache fop didn't have the
> necessary features back then (I'm not up-to-date about them now). As a
> consequence, Joshua built the latex solution.

If my assumptions are correct (including that the source docs are in
project-specific xml), then maybe, using current apache source docs
xml, which seem to produce great html with the current stylesheets,
it's worth looking into a Pandoc solution:

# the existing flow, makes excellent html IMHO
apache-doc.xml => apache-doc.html

# NEW flow
Pandoc <= apache-doc.html => apache-doc.tex

# existing flow
pdflatex apache-doc.tex => apache-doc.

It would replace the current xml => latex stylesheets and it may
result in a better translation.

Best,

-Tom

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd


tsnyder at gsscomputer

Jul 11, 2012, 6:03 AM

Post #9 of 15 (1430 views)
Permalink
Re: Problems With Doc Build Target "latex-en" [In reply to]

I will be out of the office beginning July 9th and returning on July 16th. Please call the office at
540 362-7686 and ask for service.

Thank you
Tim T Snyder
GSS Computer Technology


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd


vincent at delau

Jul 11, 2012, 6:42 AM

Post #10 of 15 (1433 views)
Permalink
RE: Problems With Doc Build Target "latex-en" [In reply to]

> Van: Tom Browder [mailto:tom.browder [at] gmail]
>
> If my assumptions are correct (including that the source docs are in
> project-specific xml), then maybe, using current apache source docs xml,
> which seem to produce great html with the current stylesheets, it's
> worth looking into a Pandoc solution:
>
> # the existing flow, makes excellent html IMHO
> apache-doc.xml => apache-doc.html
>
> # NEW flow
> Pandoc <= apache-doc.html => apache-doc.tex
>
> # existing flow
> pdflatex apache-doc.tex => apache-doc.
>
> It would replace the current xml => latex stylesheets and it may result
> in a better translation.

I'm not sure why you'd want to use the HTML files or Pandoc to generate a
tex file and convert that into a PDF. The XML files are very structured and
would allow for nice cross-references.

I'd propose to use XML -> XML FO -> PDF, instead of the current XML -> Latex
-> PDF.

Regards,

Vincent de Lau
vincent [at] delau


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd


tsnyder at gsscomputer

Jul 11, 2012, 6:56 AM

Post #11 of 15 (1428 views)
Permalink
RE: Problems With Doc Build Target "latex-en" [In reply to]

I will be out of the office beginning July 9th and returning on July 16th. Please call the office at
540 362-7686 and ask for service.

Thank you
Tim T Snyder
GSS Computer Technology


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd


nd at perlig

Jul 11, 2012, 7:10 AM

Post #12 of 15 (1434 views)
Permalink
Re: Problems With Doc Build Target "latex-en" [In reply to]

Tim,

you were spamming the docs [at] httpd list with these notices. I've
unsubsribed you for now. Feel free to re-subscribe when you're back. Please
fix your email setup before that...

nd

On Wednesday 11 July 2012 15:56:51 tsnyder [at] gsscomputer wrote:
> I will be out of the office beginning July 9th and returning on July 16th.
> Please call the office at 540 362-7686 and ask for service.
>
> Thank you
> Tim T Snyder
> GSS Computer Technology
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe [at] httpd
> For additional commands, e-mail: docs-help [at] httpd



---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd


tom.browder at gmail

Jul 11, 2012, 8:39 AM

Post #13 of 15 (1430 views)
Permalink
Re: Problems With Doc Build Target "latex-en" [In reply to]

On Wed, Jul 11, 2012 at 8:42 AM, Vincent de Lau <vincent [at] delau> wrote:
>> Van: Tom Browder [mailto:tom.browder [at] gmail]
>>
>> If my assumptions are correct (including that the source docs are in
>> project-specific xml), then maybe, using current apache source docs xml,
>> which seem to produce great html with the current stylesheets, it's
>> worth looking into a Pandoc solution:
>>
>> # the existing flow, makes excellent html IMHO
>> apache-doc.xml => apache-doc.html
>>
>> # NEW flow
>> Pandoc <= apache-doc.html => apache-doc.tex
>>
>> # existing flow
>> pdflatex apache-doc.tex => apache-doc.
>>
>> It would replace the current xml => latex stylesheets and it may result
>> in a better translation.
>
> I'm not sure why you'd want to use the HTML files or Pandoc to generate a
> tex file and convert that into a PDF. The XML files are very structured and
> would allow for nice cross-references.

Wouldn't you have to have new stylesheets? Sounds like LOTS of work
if the other method would do the job.

Best,

-Tom

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd


tom.browder at gmail

Jul 11, 2012, 3:23 PM

Post #14 of 15 (1431 views)
Permalink
Re: Problems With Doc Build Target "latex-en" [In reply to]

On Wed, Jul 11, 2012 at 10:39 AM, Tom Browder <tom.browder [at] gmail> wrote:
> On Wed, Jul 11, 2012 at 8:42 AM, Vincent de Lau <vincent [at] delau> wrote:
>>> Van: Tom Browder [mailto:tom.browder [at] gmail]
...
>> I'm not sure why you'd want to use the HTML files or Pandoc to generate a
>> tex file and convert that into a PDF. The XML files are very structured and
>> would allow for nice cross-references.

Hm, Vincent, I think you're right. I just received my "new" Apache
Modules book by Nick Kew (pub. 2007) and he says on p. 11, "All
original documents are in an XML format that is a subset of DocBook."

If that is still true, I can change my proposal for pdf to:

# existing flow
apache-doc.xsl => [stylesheets of some kind] => apache-doc.tex
pdflatex apache-doc.tex => apache-doc.pdf

# new flow
apache-doc.xsl => [DocBook 5 stylesheets] => apache-doc.fo
apache-doc.fo => [Apache Fop 1+] => apache-doc.pdf

In my experience we have been using the xsltproc (from libxml2) for
conversion from xml to fo, but the Apache Java tool chain should work
okay, too.

Best,

-Tom

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd


vincent at delau

Jul 13, 2012, 5:10 AM

Post #15 of 15 (1415 views)
Permalink
RE: Problems With Doc Build Target "latex-en" [In reply to]

> Van: Tom Browder [mailto:tom.browder [at] gmail]
>
> Hm, Vincent, I think you're right. I just received my "new" Apache
> Modules book by Nick Kew (pub. 2007) and he says on p. 11, "All
> original documents are in an XML format that is a subset of DocBook."

I don't think this is true. Initially the format might be inspired on
DocBook, but as far as I know the DTD's are build up from scratch based
on needs. If I recall correctly, a lot of inline markup is actually
'borrowed' from HTML, to ease transition from the then HTML docs into XML.

See also:
http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/style/?view=log

> If that is still true, I can change my proposal for pdf to:
>
> # existing flow
> apache-doc.xsl => [stylesheets of some kind] => apache-doc.tex
> pdflatex apache-doc.tex => apache-doc.pdf
>
> # new flow
> apache-doc.xsl => [DocBook 5 stylesheets] => apache-doc.fo
> apache-doc.fo => [Apache Fop 1+] => apache-doc.pdf

The docbook stylesheets wouldn't work for the above mentioned reason.

The rest of the flow looks like I think it should be.

> In my experience we have been using the xsltproc (from libxml2) for
> conversion from xml to fo, but the Apache Java tool chain should work
> okay, too.

It's fun to work with standards, isn't it! ;) It was once decided to use
a common tool chain, so that the output would be similar and diffs kept to
a minimum. You might have noticed that the output HTML is committed into
the repository.

Regards,

Vincent de Lau
vincent [at] delau


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe [at] httpd
For additional commands, e-mail: docs-help [at] httpd

Apache docs RSS feed   Index | Next | Previous | View Threaded
 
 


Interested in having your list archived? Contact Gossamer Threads
 
  Web Applications & Managed Hosting Powered by Gossamer Threads Inc.