On Sun, 03 Oct 2010 22:56:30 -0500, john skaller  
<skal...@users.sourceforge.net> wrote:

> Well, I'm now struggling with the usual problem: how to produce  
> documentation.
>
> Basically, I'd like to pull down the web-site and start again from  
> scratch without a messy content manager. That may be appropriate ifwe  
> had lots of users, but since there's only two of us, it would beeasier  
> to post documentation by using the repository and periodicallyextracting  
> the web-site, since that allows offline editing.
>
> But the big problem: what format to use for docs?
>
> Interscript is the current format, it produces web pages and (should)
> also make LaTeX, but it has a number of quirks which would require
> some work to fix (one of which is that it requires lines to change styles
> and doesn't handle spaces properly on style changes).
>
> Raw HTML is a possibility, though it is very hard to work with.
> Links aren't all that easy because one has to name all the files
> and then it is a nightmare to change anything. And the markup
> is <em>soooo</em> verbose it is a pain to read and write.
>
> LaTeX is easier to work with, and can be converted to HTML
> by one of several converters. This would produce a nice stylised
> layout, as well as PDF. But it lacks proper hyperlinking and other
> nice stuff that can be done with web pages.

Another option: reStructuredText/Sphinx (http://sphinx.pocoo.org/)

-- 
Aleksey Gurtovoy
MetaCommunications Engineering

------------------------------------------------------------------------------
Virtualization is moving to the mainstream and overtaking non-virtualized
environment for deploying applications. Does it make network security 
easier or more difficult to achieve? Read this whitepaper to separate the 
two and get a better understanding.
http://p.sf.net/sfu/hp-phase2-d2d
_______________________________________________
Felix-language mailing list
Felix-language@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/felix-language

Reply via email to