473,563 Members | 2,364 Online
Bytes | Software Development & Data Engineering Community
+ Post

Home Posts Topics Members FAQ

trying to get started with docbook/xml + xmlto/xsltproc

I am trying to get started with using Docbook/xml using free tools and
am stymied in generating printable documentation from even the simplest
source. I have attempted to generate a PDF using xmlto (which I guess is
a shell interface to xsltproc) for the docbook source on a variety of
platforms: Debian GNU/Linux stable, Gentoo GNU/Linux, FreeBSD, and Cygwin.
In no case have I been successful, and the error messages are certainly not
helpful.

Minimal docbook document:
-------------------------
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"/usr/share/xml/docbook/schema/dtd/4.2/docbookx.dtd">

<book>

<bookinfo>
<title>Hello, world</title>
</bookinfo>

<chapter>
<title>Hello, world</title>

<para>This is my first DocBook file.</para>

</chapter>
</book>
-------------------------

Debian GNU/Linux stable (sarge):
--------------------------------
10 isis$ xmlto pdf test.xml
Making portrait pages on letter paper (215.9 mm x 279.4 mm)
This is pdfeTeX, Version 3.14159-1.10b-2.1 (Web2C 7.4.5)
entering extended mode
(./tmp.fo{/usr/share/texmf/pdftex/config/pdftex.cfg}
LaTeX2e <2001/06/01>
Babel <v3.7h> and hyphenation patterns for american, french, german, ngerman, n
ohyphenation, basque, czech, icelandic, slovak, slovene, loaded.
xmltex version: 2002/06/25 v1.9 (Exp):
(/usr/share/texmf/tex/xmltex/config/xmltex.cfg)
No File: tmp.cfg (/usr/share/texmf/tex/xmltex/passivetex/fotex.xmt)
(/usr/share/texmf/tex/latex/base/article.cls
Document Class: article 2001/04/21 v1.4e Standard LaTeX document class
(/usr/share/texmf/tex/latex/base/size10.clo))
(/usr/share/texmf/tex/xmltex/passivetex/fotex.sty
)
No file tmp.aux.
(/usr/share/texmf/tex/latex/cyrillic/t2acmr.fd)

[more stuff snipped for brevity]

! LaTeX Error: Something's wrong--perhaps a missing \item.

See the LaTeX manual or LaTeX Companion for explanation.
Type H <return> for immediate help.
...

l.304 ..." hyphenation-remain-character-count="2">
Chapter&#xA0;1. &#xA0;Hello. ..

?
! Emergency stop.
...

l.304 ..." hyphenation-remain-character-count="2">
Chapter&#xA0;1. &#xA0;Hello. ..

! ==> Fatal error occurred, the output PDF file is not finished!
Transcript written on tmp.log.
Gentoo GNU/Linux:
-----------------
203 nephthys$ xmlto pdf test.xml
Making portrait pages on A4 paper (210mmx297mm)
This is pdfTeX, Version 3.14159-1.10b (Web2C 7.4.5)
(./tmp.fo{/usr/share/texmf/pdftex/config/pdftex.cfg}
xmltex version: 2002/06/25 v1.9 (Exp):
(/usr/share/texmf/tex/xmltex/xmltex.cfg)
! I can't find file `tmp.cfg'.
\@filef@und ->\jobname .cfg

....
l.1
<?xml version="1.0"?>
Please type another input file name:
! Emergency stop.
\@filef@und ->\jobname .cfg

....
l.1
<?xml version="1.0"?>
No pages of output.
Transcript written on tmp.log.
FreeBSD:
---------------------------------------
nephthys% xmlto pdf test.xml
Making portrait pages on USletter paper (8.5inx11in)
/usr/local/share/xmlto/format/docbook/../fo/pdf: Can't open /usr/local/share/xmlto/format/docbook/../fo/pdf: No such file or directory
(I don't have a Windows machine handy at the moment, so I can't paste
the error messages Cygwin produces, but it doesn't work there either.)

So, is *anyone* using this toolchain to produce docbook documentation?
I want to stick with free tools and avoid Java if at all possible.

- Will
Apr 14 '06 #1
1 2671
I'm not familiar with the "xmlto" tool. You might want to try doing this
in separate stages -- use a standard xslt stylesheet for converting
docbook-xml to xsl-fo, then put that through an xsl-fo rendering tool
such as fop to obtain a pdf file. I think that would avoid the side
jaunt through LaTeX.

--
() ASCII Ribbon Campaign | Joe Kesselman
/\ Stamp out HTML e-mail! | System architexture and kinetic poetry
Apr 14 '06 #2

This thread has been closed and replies have been disabled. Please start a new discussion.

Similar topics

3
2718
by: Dr. Laurence Leff | last post by:
I am having trouble doing the basics with xmlto on Redhat to convert DocBook XML into the various files. I believe the problem is the first line on the files: Here is starter file (notes.xml): <!DOCTYPE Book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"> <!ENTITY chap1 SYSTEM "chap1.xml"> <Book><title>CS310 notes</title></BOOK>
2
2760
by: Simon Strandgaard | last post by:
I am trying to understand how to create a 'catalog.xml' file for my docbook-xml documents. If I understand correct a local catalog.xml file can both avoid hardcoding in makefiles (portability), plus speed up if the stylesheet+dtds is located on the local machine. Question #1: How do I create a catagory.xml file, which works?
0
1675
by: Dr. Laurence Leff | last post by:
I am having trouble with tables under docbook. I am using xmlto under Redhat Linux. When I process a simple table as below, I get an error message about the Unit of Measure. If I change the colwidth from "1*" to something specific like "1in" it works. Yet the docbook manual indicates the "1*" stands for one column width. I tried...
2
1718
by: Yarco | last post by:
I'm learning for docbook under win32. I download: openjade-1_3_1-2-bin docbook-xml-4.4 docbook-dsssl-1.79 ldp.dsl And then copy all openjade bin\ to win32 system\, and then create a directory share\ under my workhome. Copy openjade-dsssl, docbook-xml-4.4, docbook-dsssl-1.79 to share\. ldp.dsl into docbook-dsssl-1.79\html\.
12
1930
by: Jim Anderson | last post by:
This is my first attempt at XML documentation. I'm trying to get started with docbook so I can put a set of documentation into docbook tags. I'm using 'XML In A Nutshell" and "DocBook The Definitive Guide", both of which are a bit outdated already. I have a simple file that parses, but when I read it into Netscape or Konqueror, I do not...
0
1157
by: Dubravko Gorupic | last post by:
Hi there. I'm using linux with xsltproc/docbook2html/xmleditor(xmlmind) to generate html/javahelp from docbook xml. If I put <refentry> inside of <chapter> tag, all 3 mentioned above generate .html or javahelp with table of contents of refentries which are listed in it. But, if I put <refentry> inside of <section> tag, only docbook2html...
5
3459
by: Darel Finkbeiner | last post by:
This may be the wrong group, so let me know. My "problem" is this: I am writing my commentary in DocBook 5 and using the program xsltproc and the docbook5 XSL stylesheets to produce XHTML output. Since it is a commentary, it has both English and polytonic Greek with combining diacritics in it. My console and VIM are both perfectly...
1
2679
by: Arndt Jonasson | last post by:
The way I read the XPath 1.0 specification, queries like "//*/ text()/.." and "//*/child::text()" should be valid. xmllint seems to agree with me, but xsltproc gives syntax errors for those constructions. Which one is correct? $ xsltproc err1.xsl - error xsltCompileStepPattern : 'child' or 'attribute' expected compilation error: file...
0
897
by: Tommy Nordgren | last post by:
Do anyone on this list know of a Python module for generating DocBook programlisting elements for programming language source code merked with special comments. I want to write a programming book, and want to mark significant lines in the source code for reference. My DocBook processing software xmlint, xsltproc, and fop, don't support...
0
7658
marktang
by: marktang | last post by:
ONU (Optical Network Unit) is one of the key components for providing high-speed Internet services. Its primary function is to act as an endpoint device located at the user's premises. However, people are often confused as to whether an ONU can Work As a Router. In this blog post, we’ll explore What is ONU, What Is Router, ONU & Router’s main...
0
7876
Oralloy
by: Oralloy | last post by:
Hello folks, I am unable to find appropriate documentation on the type promotion of bit-fields when using the generalised comparison operator "<=>". The problem is that using the GNU compilers, it seems that the internal comparison operator "<=>" tries to promote arguments from unsigned to signed. This is as boiled down as I can make it. ...
0
8101
jinu1996
by: jinu1996 | last post by:
In today's digital age, having a compelling online presence is paramount for businesses aiming to thrive in a competitive landscape. At the heart of this digital strategy lies an intricately woven tapestry of website design and digital marketing. It's not merely about having a website; it's about crafting an immersive digital experience that...
0
7941
tracyyun
by: tracyyun | last post by:
Dear forum friends, With the development of smart home technology, a variety of wireless communication protocols have appeared on the market, such as Zigbee, Z-Wave, Wi-Fi, Bluetooth, etc. Each protocol has its own unique characteristics and advantages, but as a user who is planning to build a smart home system, I am a bit confused by the...
1
5479
isladogs
by: isladogs | last post by:
The next Access Europe User Group meeting will be on Wednesday 1 May 2024 starting at 18:00 UK time (6PM UTC+1) and finishing by 19:30 (7.30PM). In this session, we are pleased to welcome a new presenter, Adolph Dupré who will be discussing some powerful techniques for using class modules. He will explain when you may want to use classes...
0
3628
by: TSSRALBI | last post by:
Hello I'm a network technician in training and I need your help. I am currently learning how to create and manage the different types of VPNs and I have a question about LAN-to-LAN VPNs. The last exercise I practiced was to create a LAN-to-LAN VPN between two Pfsense firewalls, by using IPSEC protocols. I succeeded, with both firewalls in...
0
3612
by: adsilva | last post by:
A Windows Forms form does not have the event Unload, like VB6. What one acts like?
1
2077
by: 6302768590 | last post by:
Hai team i want code for transfer the data from one system to another through IP address by using C# our system has to for every 5mins then we have to update the data what the data is updated we have to send another system
0
909
bsmnconsultancy
by: bsmnconsultancy | last post by:
In today's digital era, a well-designed website is crucial for businesses looking to succeed. Whether you're a small business owner or a large corporation in Toronto, having a strong online presence can significantly impact your brand's success. BSMN Consultancy, a leader in Website Development in Toronto offers valuable insights into creating...

By using Bytes.com and it's services, you agree to our Privacy Policy and Terms of Use.

To disable or enable advertisements and analytics tracking please visit the manage ads & tracking page.