bug-texinfo
[Top][All Lists]

## Looking for TeX/LaTeX gurus help

 From: Patrice Dumas Subject: Looking for TeX/LaTeX gurus help Date: Tue, 27 Oct 2009 17:46:47 +0100 User-agent: Mutt/1.5.20 (2009-06-14)

Hello,

This is a request for help for texi2html/makeinfo in perl. Since it
will be merged very soon to texinfo, I ask here. Also I know that
there are some mighty TeX/LaTeX wizards on this list ;-).

I would like to do some conversion from texinfo to LaTeX/TeX, with a
short term goal to have all the texinfo relevant in @math converted
to TeX/LaTeX (when @math is used by some converter that don't now about
texinfo, like [itex] in mediawiki, latex2html) and a conversion to LaTeX
as a long-term goal. For the @math conversion, I would prefer some
conversion compatible with both plain TeX and LaTeX. Outside @math, the
emphasize is more on LaTeX (no need to redo texinfo.tex). I will list
the @-commands I would like to have a conversion both in math mode
(in @math) and in normal mode first, and after that I'll turn to
commands that shouldn't appear in @math. Please write next to the
command what it should be in @math, and outside. If the construct
requires a specific LaTeX document style, or a \usepackage, or some
\command definition in the preamble, please say so, too.

In case it matters, I plan to use 'report' for normal texinfo documents,
and 'article' for documents that have only one section.

Whan I have a proposal I put it, tell if you disagree. As you can see,
I know LaTeX (and use it quite a lot), but I am, by far, not an expert ;-)

@ringaccent
@'               \acute   \'
@,
@^               \hat     \^
@               \grave   \
@~               \tilde
@"
@=               \bar
@H
@dotaccent       \dot
@u               \breve
@ubaraccent
@udotaccent
@v
@ogonek
@tieaccent
@dotless

@*
@  (@<SPACE>)
@        (@<TAB>)
@
(@<NEWLINE>)
@-
@|
@/
@:
@?
@.
@@
@}  \}  \}
@{  \{  \{

@\ (only in math)

'TeX'               ?      \TeX
'LaTeX'             ?      \LaTeX
'bullet'
'registeredsymbol'
'dots'
'enddots'
'equiv'
'error'
'expansion'
'arrow'
'minus'
'point'
'print'
'result'
'today'
'aa'
'AA'
'ae'
'oe'
'AE'
'OE'
'o'
'O'
'ss'
'l'
'L'
'DH'
'dh'
'TH'
'th'
'exclamdown'
'questiondown'
'pounds'
'ordf'
'ordm'
'comma'
'euro'
'geq'
'leq'
'tie'
'textdegree'
'quotedblleft'
'quotedblright'
'quoteleft'
'quoteright'
'quotedblbase'
'quotesinglbase'
'guillemetleft'
'guillemetright'
'guillemotleft'
'guillemotright'
'guilsinglleft'
'guilsinglright'

'asis'
'b'
'clicksequence'
'click'
'code'
'command'
'dfn'
'emph'
'env'
'file'
'i'
'slanted'
'sansserif'
'kbd'
'key'
'option'
'r'
'samp'
'sc'
'strong'
't'
'var'
'w'

And for the following, if you have an idea about how they should be
rendered in LaTeX normal text, please say. When I have an idea, I put
it next to the command name. For complex formats, like @multitable,
you can just point me to the LaTeX package you think is relevant, with
hints if needed, and I can do the remaining.

characters protected by a backslash in normal text: $& % # _ \$backslash$For the following commands, also tell if the arguments should not be protected normally (for example first @uref argument): 'cite' 'dmn' 'ctrl' 'hyphenation' 'verb' 'titlefont' 'uref' 'url' 'indicateurl' 'email' 'acronym' 'abbr' 'math'$ ... \$

'anchor' label
footnote footnote
I know about \ref to do some cross ref, but I am not sure that it fits with
all the @*ref texinfo commands.
@*ref

a punctuation mark followed by @. in normal text.

for @example, @display and so on:
\fancyvrb with commandchars=\\\{\}, fontfamily=?, fontsize=\small if needed.
If you know what to use for fontfamily for the different possibilities
(like @example and like @format), please say.

@titlepage
@copying
@insertcopying

@raggedright
@group

itemize       \begin{itemize}
enumerate     \begin{enumerate}
table         \begin{description}

@multitable    \tabular, but I don't know exactly how, since it is
possible to have some complicate things in @multitable in texinfo
I am not sure \tabular can handle (in fact, texi2html handle almost any
nesting in @multitable, including @multitable in @multitable since
HTML also accept them, but texinfo.tex doesn't accept everything).

@center
@flushleft
@flushright

@def*

@printindex
@?index

@quotation
@smallquotation
@*quotation with arg

@image

@float  I don't know if there is a generic float command, but we could
have some specific float types, for example
@float Table   @table
@caption   \caption
@shortcaption

@c,@comment depending on the situation, either % or removed

raisesections
lowersections
'contents'
'shortcontents'
'summarycontents'
'setcontentsaftertitlepage'
'setshortcontentsaftertitlepage'
'clickstyle'
'novalidate'
'dircategory'
'pagesizes'
'finalout'
'paragraphindent'
'firstparagraphindent'
'frenchspacing'
'fonttextsize'
'allowcodebreaks'
'exampleindent'
'footnotestyle'
'afourpaper'
'afivepaper'
'afourlatex'
'afourwide'
'setchapternewpage'
'everyfooting'
'evenfooting'
'oddfooting'
'smallbook'
'setfilename'
'shorttitle'
'shorttitlepage'
'settitle'
'author'
'subtitle'
'title'
'syncodeindex'
'synindex'
'defindex'
'defcodeindex'
'documentlanguage'
'kbdinputstyle'
'everyfootingmarks'
'evenfootingmarks'
'oddfootingmarks'
'sp'
'page'
'refill'
'noindent'
'indent'
'need'
'exdent'
'vskip'
'cropmarks'
'verbatiminclude'
'documentencoding'
'filbreak'

--
Pat