From mboxrd@z Thu Jan 1 00:00:00 1970 From: Alan L Tyree Subject: Re: org-mode markup vs rst for general content Date: Fri, 10 Mar 2017 10:27:47 +1100 Message-ID: References: <87bmtahkvu.fsf@atmarama.com> <87variglbb.fsf@atmarama.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:60372) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cm7TQ-0000NB-4z for emacs-orgmode@gnu.org; Thu, 09 Mar 2017 18:27:57 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cm7TO-0000J6-D7 for emacs-orgmode@gnu.org; Thu, 09 Mar 2017 18:27:56 -0500 Received: from mail-pf0-x235.google.com ([2607:f8b0:400e:c00::235]:35257) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1cm7TO-0000Ii-75 for emacs-orgmode@gnu.org; Thu, 09 Mar 2017 18:27:54 -0500 Received: by mail-pf0-x235.google.com with SMTP id j5so34307934pfb.2 for ; Thu, 09 Mar 2017 15:27:52 -0800 (PST) In-Reply-To: <87variglbb.fsf@atmarama.com> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: =?UTF-8?B?U2HFoWEgSmFuacWha2E=?= , Emacs Orgmode On 10/03/17 09:03, Saša Janiška wrote: > John Kitchin writes: > >> Could you be more specific about what kind of richness you are looking >> for? > In a general sense…iow, it’s a fact that rst markup is richer than > e.g. Markdown. Probably, Asciidoc(tor) also provides more semantic > richness and make it suitable markup for longer docs/books, so I wonder > where one can put org-mode’s markup on this scale? > > > Sincerely, > Gour > I write legal textbooks (up to 600 printed pages) using org-mode. They are structurally simple (no sidebars, no illustrations, no computer code). On the other hand, they have lots of citations and internal cross references. Org-mode is the best for this kind of work because of the flexible outline structure, not just collapsing and expanding, but the "hoisting" facility that allows me to focus on smaller sections. The org-ref module does its work, and the internal cross referencing is the best. I recently assisted a friend to put together a memoir that he wanted to publish as ePub and print. It had lots of pictures. He had originally typed it in Word and it was a nightmare. Images would not stay put, even the typeface would change. The on-line publishers like Lulu rejected it. We reformatted in in Pandoc Markdown and produced a very nice result. I would have preferred org-mode, but he had never been near Emacs. We got good ePub, xhtml and print from a single manuscript. I have also written in rst: it is a slightly richer language out of the box with provisions for sidebars, cautions, etc, but unless you really need those things, I would stick with org-mode. I find the syntax of rst to be very fiddly. Most of the special effects can be obtained with css in any case. The only problem that I have had is converting org-mode to Word files as required by my publisher. The ODT export module is fiddly and often chokes on my longer documents. When it does choke, it is hard to trace the problems. Markdown + Pandoc seems much better in this regard, but the outlining features in Emacs do not seem to be as good for the Markdown mode. To get a decent export in my latest manuscript I had to export to LaTeX then use ht4tex. Not a pretty workflow. I would say Markdown if you are collaborating with someone not familiar with Emacs. The Pandoc version will do a surprising amount. Org-mode for nearly everything else, but if you need more, go on to LaTeX. This may be more than you wanted to know :-). Regards, Alan -- Alan L Tyree http://www2.austlii.edu.au/~alan Tel: 04 2748 6206 sip:typhoon@iptel.org