Some Assistance Please

[Adonay Felipe Nogueira]

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.