Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
newsletter:markuplanguages [2011/05/29 03:48] – [AsciiDoc] elextrnewsletter:markuplanguages [2011/06/05 17:13] (current) frlan
Line 14: Line 14:
 ===== Languages / Toolkits ===== ===== Languages / Toolkits =====
 ==== LaTeX ==== ==== LaTeX ====
 +
 +Pros (for this application) Latex is a combined content structure, layout and formatting language, all the lightweight markup languages are content structure only and a different backend configuration language must be used for layout/formatting.  Already setup.
 +
 +Con fewer contributions may come in Latex so more conversion effort may be needed by the production team.
 +
 ==== ReST ==== ==== ReST ====
 +
 +Is the current used markup language. Its seems to support all points mentioned above either as build in or with some little manuel work after. 
 +
 +The only unsolved issue is the generating of plain text with table of content and section numbering. This could be done using the HTML/PDF output but will need some further effort to investigate. 
 +
 ==== Sphinx ==== ==== Sphinx ====
 ==== AsciiDoc ====  ==== AsciiDoc ==== 
Line 24: Line 34:
 To generate PDF needs a docbook toolchain such as free open source dblatex (uses your installed latex) or Apache project's FOP.  For text it uses w3m (includes the javascript generated toc). To generate PDF needs a docbook toolchain such as free open source dblatex (uses your installed latex) or Apache project's FOP.  For text it uses w3m (includes the javascript generated toc).
  
-Asciidoc configuration is by 1) setting attribute values one the command line or in the source file 2) for complex changes cascading (like css) configuration files control input format and generated output (HTML and docbook).+Asciidoc configuration is by 1) setting attribute values on the command line or in the source file 2) for complex changes cascading (like css) configuration files control input format and generated output (HTML and docbook).
  
 dblatex configuration is by 1) attributes set on the command line or in a config file or 2) latex stylesheets for complex changes dblatex configuration is by 1) attributes set on the command line or in a config file or 2) latex stylesheets for complex changes
Line 33: Line 43:
 Cons isn't used in Geany so its an extra tool. Cons isn't used in Geany so its an extra tool.
  
-But it is just Python and can be just installed in a user directory (or even run from the clone of the Mercurial repo), it doesn't need to be a system install (although it can be from package (most distros, all listed above) or makefile).+But it is just Python and can be just installed in a user directory (or even run from the clone of the Mercurial repo), it doesn't need to be a system install (although it can be from package (most distros, all listed above including windows) or makefile).
  
 ==== Doxygen ==== ==== Doxygen ====
Print/export