Subject: Re: presentation neutral publication tool
To: None <netbsd-users@netbsd.org>
From: George Georgalis <george@galis.org>
List: netbsd-users
Date: 03/20/2007 18:29:48
On Tue, Mar 20, 2007 at 10:05:44AM -0500, Jeremy C. Reed wrote:
>> LyX it's just a latex wysiwyg, no html.
>
>There are a few latex to html converters. I frequently use latex2html.
>
>I use lyx to make presentations in PDF and HTML.

Interesting, do you have any links to lyx tex and associated html
that includes graphics and figures?

>I have used latex2html a lot.

had problems with multi page tables, and something else, moved to
htlatex (tex4ht), where I'm now experiencing problems including
graphics with single source.

Thanks for the links (and offline suggestions), cannot help but
wonder if I started the prior thread too; I know I've brought up
the topic before but don't remember where.

Here is the wiki source of my summary. ;)

= Document Formats =

A guide to document standards. (not really in order)

Per recent discussions on various doc formats, here
is a summary of best options for large technical
reports and validation.
http://www.trust.metrg.net/trac/wiki/DocFormat

I think it boils down to Latex, and the user's
editor of choice. The ''single source doc rendered
to PDF or HTML'' idea is only well supported with
XML source and there aren't any high end XML WYSIWYG
editors.

Latex is standard for scientific docs. Lyx is the
only WYSIWYG latex editor, for many, it's easier to
learn/edit source than learn lyx, but lyx is mature
and often recommended.

asciidoc may fill a niche for quick document prep in
pdf/html; but so could OpenOffice or Word.


 [http://www.princexml.com/ Prince] is a computer program that converts XML into PDF documents.:: Prince is an ideal printing component for server-based software such as web applications and database systems. Using Prince, data in XML can easily be converted to PDF documents that can be printed, archived or downloaded over the web.

 [http://oxygenxml.com/ OxygenXML] an XML Editor:: tools for the document creation and presentation, seems the best tool for xml source editing; requires separate browser or pdf viewer to view renderings.

 [http://www.methods.co.nz/asciidoc/ AsciiDoc] a text document format:: for writing short documents, articles, books and UNIX man pages. !AsciiDoc files can be translated to HTML and !DocBook markups. 

 [http://www.ccs.neu.edu/home/dorai/tex2page/tex2page-doc.html TeX2page] Scheme script for making Web pages from TeX documents.:: Reads an input document that is marked up in plain TeX or LaTeX and produces an output document with the functionally equivalent HTML markup.

 [http://www.lyx.org/ LyX] The Document Processor:: LyX is a document processor that encourages an approach to writing based on the structure of your documents, not their appearance. The Latex editor that wouldn't go away, difficult to use but looks good and has been recommended for years.

 [http://www.scribus.net/ Scribus] award-winning professional page layout:: modern and user friendly interface. Does Scribus export to html? Not yet.

 [http://www.latex-project.org/ LaTeX] (pronounced latek):: a document preparation system for high-quality typesetting based on, and succeeding TeX formatting. LaTeX is the de facto standard for the communication and publication of scientific documents.

 [http://docbook.sourceforge.net/ DocBook] is an XML / SGML vocabulary:: for document content in a presentation-neutral form that captures the logical structure of the content.

 [http://pauillac.inria.fr/~maranget/hevea/index.html HEVEA] is a quite complete and fast LATEX to HTML translator.::

 [http://hutchinson.belmont.ma.us/tth/ TTH] the TEX to HTML translator:: enables mathematical documents to be made available on the web. No mention in graphics. Good additional references.

 [http://lout.sourceforge.net/ Lout] document formatting system:: The system reads a high-level description of a document similar in style to LaTeX and produces a !PostScript file which can be printed on most laser printers and graphic display devices. Plain text output is also available, PDF output is limited but working (e.g. no graphics).

 [http://www.adobe.com/products/dreamweaver/ Dreamweaver]:: it's an XML editor.

 [http://ahds.ac.uk/creating/information-papers/xml-editors/ Choosing an XML editor] based on the 2004 study ''Benchmarking XML editors'':: an extensive comparison of features including recommendation for different types (including WYSIWYG) users.

Latex is limited in that pdf ''and'' html renderings of single source can be difficult or impossible. The actual source is not complex to type but new directives can be difficult to figure out.

XML and an associated schema can define any type of document structure, pdf and html from single source are widely supported. It is has more syntax and source code characters in with the regular document text than Latex, which can be confusing. There are many editors available, but WYSIWYG is not supported in the high end editors.

!AsciiDoc looks like it intends to provide simple source files (fully useable, much like wiki source), that lead to well rendered pdf or html. Limitations are not clear, certainly it's not a widely used. Not sure of footnote, page header and footer capability.


// George

-- 
George Georgalis, systems architect, administrator <IXOYE><