Re: One more stab at an XML docbook tools tutorial

Bram Moolenaar <[email protected]>
Newsgroups gmane.comp.tools.aap.user
Message-ID <[email protected]>
Adriaan de Groot wrote:

> @if os.name == "FreeBSD":
>     Installing the XML docbook tools from ports is by far the easiest thing
[...]

I'm glad you figured out how to do all this.

> xsltproc if it is not in your path in the recipe. It also adds a workaround 
> if you do not have "links" installed, which is a HTML-to-text converter tool.

I just discovered that a more recent version of "links" no longer
supports the "-dump" argument, thus can't be used to convert HTML to
plain text.  I have added a fallback to use Lynx instead:

    @try:
	:sys links -dump exec.html >exec.txt
    @except:
	:sys lynx -dump -nolist exec.html >exec.txt

Exception handling is great, isn't it?  I still prefer the recipe to
fail with an error when "exec.txt" can't be produced.

> The new recipe does not generate pdf. I know generating pdf is
> possible and straightforward, but I haven't talked to the right people
> yet as to how to do it. 

I do need to produce the PDF file.  Thus I'll postpone switching to XML
until you manage to add this.  I think this needs to be done with "jade"
and "pdftex".  I think jade processes XML, if you give it the right
arguments.

> The new recipe generates differently-named HTML files than the
> previous one. I don't know if that can be remedied. The files might
> not match the previous division (one html file per chapter). That can
> be remedied with a suitable params.xsl file. Those remedies are beyond
> the scope of this paper, though.

I what way are the files different?

-- 
            ### Hiroshima 45, Chernobyl 86, Windows 95 ###

 /// Bram Moolenaar -- [email protected] -- http://www.Moolenaar.net   \\\
///          Creator of Vim - Vi IMproved -- http://www.Vim.org          \\\
\\\              Project leader for A-A-P -- http://www.A-A-P.org        ///
 \\\  Help AIDS victims, buy here: http://ICCF-Holland.org/click1.html  ///


-------------------------------------------------------
This sf.net email is sponsored by:ThinkGeek
Welcome to geek heaven.
http://thinkgeek.com/sf
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.