From mboxrd@z Thu Jan 1 00:00:00 1970 From: John Kitchin Subject: Re: org-mode markup vs rst for general content Date: Fri, 10 Mar 2017 09:47:22 -0500 Message-ID: References: <87bmtahkvu.fsf@atmarama.com> <87variglbb.fsf@atmarama.com> <874lz1e625.fsf@mat.ucm.es> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:46535) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cmLpI-0006Tx-7H for emacs-orgmode@gnu.org; Fri, 10 Mar 2017 09:47:29 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cmLpF-0004vs-It for emacs-orgmode@gnu.org; Fri, 10 Mar 2017 09:47:28 -0500 Received: from mail-qk0-x22e.google.com ([2607:f8b0:400d:c09::22e]:32998) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1cmLpF-0004ui-CV for emacs-orgmode@gnu.org; Fri, 10 Mar 2017 09:47:25 -0500 Received: by mail-qk0-x22e.google.com with SMTP id y76so170513287qkb.0 for ; Fri, 10 Mar 2017 06:47:25 -0800 (PST) In-reply-to: <874lz1e625.fsf@mat.ucm.es> 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: Uwe Brauer Cc: emacs-orgmode@gnu.org Over the past few years I have looked at pandoc a few times: http://kitchingroup.cheme.cmu.edu/blog/2014/07/17/Pandoc-does-org-mode-now/ http://kitchingroup.cheme.cmu.edu/blog/2015/01/29/Export-org-mode-to-docx-with-citations-via-pandoc/ http://kitchingroup.cheme.cmu.edu/blog/2015/06/11/ox-pandoc-org-mode-+-org-ref-to-docx-with-bibliographies/ Of the exports, to Word is still the least well developed (in my opinion of course). Sometimes I just use ox-clip to copy org-mode into word with formatting. It works pretty well for simple things. I started https://github.com/jkitchin/scimax/blob/master/ox-rtf.el s an alternative path to word. It works kind of minimally, but it does not do everything, and I have not worked on it in a while. You might see the first three entries of http://kitchingroup.cheme.cmu.edu/blog/2014/08/08/What-we-are-using-org-mode-for/ which talk about the blog, two large "books" I wrote in org-mode, and a few of the scientific papers we have written in org-mode and converted to Latex then pdf (there are over 15 now I think). A long time ago I was enamored by rst, and Sphinx documentation in Python. These days I vastly prefer the simpler, and more functional org-mode markup. The functionality (links, executable code, flexible export, etc) could be made to work in rst too (it is emacs after all), but I find it easier to do it and extend it in org-mode (but that is mostly my experience with org-mode speaking). I like keeping it all in emacs, and not switching over to a browser to get access to documentation. That is certainly a preference of mine, but one that is so strong I wrote an emacs pydoc module to show python docstrings in emacs, and started writing those in org-mode so I could have equations, figures and links in them ;) I think about org-documents in a fundamentally different way than I think about Latex/rst/html. My org-documents are simultaneously narrative functional text and documents that contain human readable, machine-addressable information, e.g. contacts, bibtex entries, meetings, etc. that I can use in other documents or applications, while retaining the capability to export the documents to other formats that are considerably more limited, but that a publisher might demand. Uwe Brauer writes: > > On 10/03/17 09:03, Saša Janiška wrote: > > > 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 had good experience with pandoc exporting from org mode to docx, but > maybe your documents are more complex. > > Uwe Brauer -- Professor John Kitchin Doherty Hall A207F Department of Chemical Engineering Carnegie Mellon University Pittsburgh, PA 15213 412-268-7803 @johnkitchin http://kitchingroup.cheme.cmu.edu