Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
newsletter:markuplanguages [2011/05/29 03:15] – [AsciiDoc] elextr | newsletter:markuplanguages [2011/06/01 09:16] – elextr | ||
---|---|---|---|
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/ | ||
+ | |||
+ | Con fewer contributions may come in Latex so more conversion effort may be needed by the production team. | ||
==== ReST ==== | ==== ReST ==== | ||
==== Sphinx ==== | ==== Sphinx ==== | ||
==== AsciiDoc ==== | ==== AsciiDoc ==== | ||
- | Asciidoc provides table of contents, automatic section numbering and output in all three formats, images in PDF and HTML. As shown in the example at: [[https:// | + | Asciidoc provides table of contents, automatic section numbering and output in all three formats, images in PDF and HTML. As shown in the example at: [[https:// |
+ | |||
+ | The lightweight markup language is similar to most such languages, eg ReST, Markdown etc and like them you could almost use the source as the text version. | ||
+ | |||
+ | To generate PDF needs a docbook toolchain such as free open source dblatex (uses your installed latex) or Apache project' | ||
+ | |||
+ | 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 | ||
+ | FOP configuration is by 1) attributes set on the command line or 2) XSL stylesheets | ||
+ | |||
+ | Pros are this is what Asciidoc is designed for, writing human documents, it isn't a code docstring extractor that is being forced into another role. It also provides a Python script to assist in running the backend toolchains | ||
+ | |||
+ | 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' | ||
==== Doxygen ==== | ==== Doxygen ==== |