Re: Texinfo for FAQs?

---------

era eriksson (reriksso@cc.helsinki.fi)
Wed, 5 Mar 1997 12:46:24 +0200 (EET)


On 05 Mar 1997 07:57:25 +0000, Andrew Gierth
<andrew@erlenstar.demon.co.uk> wrote:
> (I've considered other formats, like linuxdoc or raw HTML, but I don't
> like their handling of special characters like '<' and '&'. This is the
> new comp.unix.programmer FAQ, so it has a lot of C code examples; I find
> Texinfo's @{ and @} less painful than having &lt; and &amp; all over the
> place. I mainly want plain text and HTML output, produced from a single
> source document.)

(The Qwertz system or its descendant / perversion Sgml-Tools [nee
Linuxdoc] handles code snippets quite well -- you just put the code
inside <code> or <verb> tags. And they both translate into various
other formats. Qwertz is more limited for all I know, mainly LaTeX and
*roff, whereas Sgml-Tools includes downtranslators for HTML and
Texinfo and a couple more as well. I suppose you could try to retrofit
the Sgml-Tools additional translators back onto the original Qwertz
and end up with something more elegant than the current Stml-Tools.
Disclaimer: I have tried LaTeX, then Qwertz, then Linuxdoc, then
Sgml-Tools but never been satisfied with any of them enough to stop
looking for something better, preferrably still SGML based.
I have archived some pointers to other SGML systems from this
mailing list; mail me in private if you want me to dig them up. I
think mainly there was Docbook and then this apparently partly
homegrown thing the Amiga TCP FAQ writer uses which is described at
<http://www.phone.net/ATCPFAQ/FAQ.html>.)

Hope this helps,

/* era */

(Personally, I'd just write a simple preprocessor if some details in
the input formalism were bothersome to me. I currently do this for all
the HTML I produce; in quick paraphrase:

perl -pe 's/\&([^#])/\&amp;\1/g; s/</\&lt;/g; s/>/\&gt;/g;'

The actual preprocessor I use has an escape hatch so that <>:s are
only substituted inside actual example snippets. I use &#65; like
entities when I have to. [The above example will politely leave &#
sequences untouched.]
The tool is too specific to be of any use to anybody but me, but if
you want to look at it [yes, it's in Perl], maybe you can try to bribe
me :-)

-- 
Defin-i-t-e-ly. Sep-a-r-a-te. Gram-m-a-r.  <http://www.iki.fi/~era/>
 * Enjoy receiving spam? Register at <http://www.iki.fi/~era/spam.html>


[ Usenet Hypertext FAQ Archive | Search Mail Archive | Authors | Usenet ]
[ 1993 | 1994 | 1995 | 1996 | 1997 ]

---------

faq-admin@landfield.com

© Copyright The Landfield Group, 1997
All rights reserved