I can't say what's wrong with DocBook, because using Org is a personal
preference of mine, so first and most important: This is personal
opinion.
* Pros of Org Mode
- Org Mode's markup is easier to understand and start using. No need to
remember tag names (at least for most used formating functions). One
thing that bothers me in most markup languages is the need to either
rememeber English words, or some abbreviation of them for which a
non-native would find difficult to.
- Exports to LaTeX, LaTeX Beamer, Org (again), PDF, ODT, ePUB
(perhaps), plain text, HTML, MarkDown (with features unsupported by
MarkDown being exported to HTML), and TeXInfo. There are more export
options that I might be unaware of.
- Supports ordered, unordered and description lists. Ordered lists can
make use of Arabic (1, 2, ...) or Roman (I, II, ...) numbers.
- Ordereded lists using letters can be enabled with a variable,
although they are discouraged due to their letter limit.
- Supports defining the counter with which an ordered list will start
with, with this you can force the continuation of an ordered list if
for some reason the counter was broken, or do lists starting with
0. :)
- Depending on the object/thing being referenced and the exported file,
links can reference to specific parts of other files. Furthermore,
links/references to places in the same Org file (or exported file) can
be created for anything, not just sections.
- Supports tables (via either the default table feature or Tabl.el
Emacs package) and formulas (which can also make use of Emacs Calc
formulas). Can also be extended with tools such as Gnuplot so that you
can make charts based on the table data (this support can be enabled
by toggling the respective Org Babel options), or tools such as GNU R
so that you can make more advanced statistic calculations (the same
note in the previous parenthesis applies, now for GNU R), and from
within GNU R you can make use of the ggplot2 library to make the plots
or charts directly from R (no need to enable Gnuplot in Org Babel).
- Parts of the Org document using Org Babel and some scripting language
can take tables (except *maybe* for those formated in Tabl.el),
first-level lists, strings and numbers as input.
- Each section can be exported to individual files, no need to make one
file for each section. This way you can keep a large Org file with all
documentation possible inside.
- Supports including other Org files, or other text/document files
depending on the export format.
- Supports including images.
- Depending on the export format, supports including SVG, PDF and PGF
(or TikZ) drawings with .tex file extension.
* Cons of Org Mode
- The community still has to figure a way so that, while using a
table in Emacs Tabl.el syntax, which can have merged cells (contrary
to Org Mode tables), there would be also the possibility of using
formulas. Currently, you either have to decide to use formulas in a
table, or to make merged cells, you can't mix both.
- Personal note: I tend to stay with Org Mode tables because I don't
need merged cells, and if would find myself tempted to use it, I
would find a way to describe the content in a shorter way --- that
is, if keeping formulas is a must, otherwise I make use of merged
cells.
- The community has to improve BibTeX interaction while exporting to any
format. Currently, my personal setup, which works fine for my needs,
makes use of a script that I wrote whuch uses Org BiBTeX and BibTeX.el
packages to extract at least reference key (use for in-document
links), author, title, year, copyright license and URI of the work.
But since I'm not a developer, and I have limited knowledge on Emacs
Lisp, I'm unable to do fancy things like sorting, inserting suffixes
in the years (when the reference would be similar to an existing one),
extract more BibTeX fields than those mentioned, and so on.
- Providing tables formated with Tabl.el to Org Babel code blocks might
not work as expect. Although I didn't test this yet.
- Currently, providing lists to Org Babel code blocks takes into account
only the first level of the list.
--
- [[https://libreplanet.org/wiki/User:Adfeno]]
- Palestrante e consultor sobre /software/ livre (não confundir com
gratis).
- "WhatsApp"? Ele não é livre, por isso não uso. Iguais a ele prefiro
GNU Ring, ou Tox. Quer outras formas de contato? Adicione o vCard
que está no endereço acima aos teus contatos.
- Pretende me enviar arquivos .doc, .ppt, .cdr, ou .mp3? OK, eu
aceito, mas não repasso. Entrego apenas em formatos favoráveis ao
/software/ livre. Favor entrar em contato em caso de dúvida.
_______________________________________________
gnucash-devel mailing list
gnucash-devel@gnucash.org
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
