[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: ifinfo vs ifnottex
From: |
Robert J. Chassell |
Subject: |
Re: ifinfo vs ifnottex |
Date: |
Fri, 19 May 2006 07:39:18 -0400 (EDT) |
Luc Teirlinck <address@hidden> is right and I am glad of his
offer. With more output formats, seven direct, last I counted, the
Texinfo source files must change.
Texinfo source files should use address@hidden ... @end ifxml' for conversion
to XML with a Texinfo DTD and address@hidden ... @end ifdocbook' for
conversion to DocBook.
The two are different since XML with a Texinfo DTD can be converted to
either an on-line viewing format, Info or an off-line viewing format
such as DVI. The XML with a Texinfo DTD output should enjoy `maximum'
information. (It is really better to conceive of the XML formats as
being an `intermediate' rather than a `final output' format.)
As far as I know, you can only view DocBook pages on-line; it is not
as if they are designed for on-line viewing.
As it happens, both those output formats, XML with a Texinfo DTD and
DocBook, have the same file extension although they are different
internally.
In more detail:
Luc has offered to insert four more address@hidden' commands into the deep
representations, the Texinfo source files. At the moment, the
documentation is broken. It includes only address@hidden' and
address@hidden'.
address@hidden' handles both Info and Plain Text. In addition there is an
address@hidden' command. There is no address@hidden' command. (This lack is
explained in (texinfo)PDF Output . Also, there are corresponding
address@hidden' commands.)
address@hidden ... @end ifinfo'
Text to appear only in the Info and Plain Text output.
address@hidden ... @end ifplaintext'
Text to appear only in the plain text output.
address@hidden ... @end ifhtml'
Text to appear only in the HTML output.
address@hidden ... @end iftex'
Text to appear only in the printed manual.
address@hidden ... @end ifdocbook'
Text to appear only in the Docbook output.
address@hidden ... @end ifxml'
Text to appear only in the XML output.
The output formats for both DocBook and XML with a Texinfo DTD have
the same extension: .xml `makeinfo' chooses which to output
depending on its flag:
makeinfo --docbook ...
makeinfo --xml ...
Incidently, the seven direct output formats for a single Texinfo
source file are: Info, HTML, plain text, DVI, PDF, DocBook, and
Texinfo XML. For example:
## Info
makeinfo --no-split --fill-column=70 --paragraph-indent=0 --verbose \
foo.texi
## Plain text
makeinfo --no-split --fill-column=70 --paragraph-indent=0 --verbose \
--no-headers --output=foo.txt foo.texi
## HTML
makeinfo --no-split --html foo.texi
## DVI
texi2dvi foo.texi
## PDF
texi2dvi --pdf foo.texi
## DocBook
makeinfo --docbook --no-split --paragraph-indent=0 --verbose foo.texi
## XML
makeinfo --xml --no-split --paragraph-indent=0 --verbose foo.texi
Also, you can create PostScript and RTF in two steps and LaTeX in
three steps:
## PostScript (needs DVI)
dvi2ps foo.dvi > foo.ps
## RTF (needs HTML)
/usr/local/src/html2rtf.pl foo.html
## LaTex (needs RTF)
/usr/bin/rtf2latex foo.rtf
Even though the files extensions are similar, the headers for DocBook
and XML with a Texinfo DTD are different:
DocBook
<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY tex "TeX">
<!ENTITY latex "LaTeX">
]>
<book lang="en">
XML with a Texinfo DTD
<?xml version="1.0"?>
<!DOCTYPE texinfo PUBLIC "-//GNU//DTD TexinfoML V4.8//EN"
"http://www.gnu.org/software/texinfo/dtd/4.8/texinfo.dtd">
<texinfo xml:lang="en">
--
Robert J. Chassell
address@hidden GnuPG Key ID: 004B4AC8
http://www.rattlesnake.com http://www.teak.cc
Re: ifinfo vs ifnottex, Luc Teirlinck, 2006/05/18
Re: ifinfo vs ifnottex, Luc Teirlinck, 2006/05/18
Re: ifinfo vs ifnottex, Richard Stallman, 2006/05/18
Re: ifinfo vs ifnottex,
Robert J. Chassell <=