From mboxrd@z Thu Jan 1 00:00:00 1970 From: Joost Kremers Subject: Re: Making DocBook xml books from org mode? Date: Thu, 29 Sep 2016 21:23:09 +0200 Message-ID: <878tuajysi.fsf@fastmail.fm> References: <1475172280.399769.741096521.05684B25@webmail.messagingengine.com> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:48059) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bpgvc-0007Ls-82 for emacs-orgmode@gnu.org; Thu, 29 Sep 2016 15:23:33 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bpgvY-0003sR-0U for emacs-orgmode@gnu.org; Thu, 29 Sep 2016 15:23:31 -0400 Received: from out2-smtp.messagingengine.com ([66.111.4.26]:47146) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bpgvV-0003nk-KH for emacs-orgmode@gnu.org; Thu, 29 Sep 2016 15:23:27 -0400 In-reply-to: <1475172280.399769.741096521.05684B25@webmail.messagingengine.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: Peter Davis Cc: emacs-orgmode@gnu.org On Thu, Sep 29 2016, Peter Davis wrote: > I've started a new position in which I have to create and maintain a > large set of documents in DocBook xml format. For new books, I'd really > like to use org mode, since a) I'm already familiar with it, b) I love > it, and c) I believe it does (or can be made to do) nearly everything I > need. > > However, after Googling around the org-mode/DocBook space, I'm left with > some questions. > > 1. I'm going to be creating books, as opposed to articles. My org-header > looks like this: > > #+STARTUP: showeverything logdone > #+OPTIONS: H:5 num:t \n:nil @:t ::t |:t ^:nil -:t f:t *:t <:t > #+LaTeX_CLASS: koma-article > #+LaTeX_HEADER: \usepackage{listings} > #+LATEX_HEADER: \setlength{\parskip}{2ex plus 4pt minus 2pt} > #+LATEX_HEADER: \setlength{\parindent}{0pt} > #+LATEX_HEADER: \renewcommand{\baselinestretch}{1.0} > #+LATEX_HEADER: \setlength{\topsep}{-10pt} > #+LATEX_HEADER: \setlength{\partopsep}{0pt} > #+LaTeX_HEADER: \usepackage{xcolor} > #+LaTeX_HEADER: \lstset{ > #+LaTeX_HEADER: basicstyle=\ttfamily, > #+LaTeX_HEADER: breaklines=true, > #+LaTeX_HEADER: > prebreak=\mbox{\ensuremath{\color{red}\hookleftarrow}}, > #+LaTeX_HEADER: > postbreak=\raisebox{0ex}[0ex][0ex]{\ensuremath{\color{red}\hookrightarrow\space}}, > #+LaTeX_HEADER: columns=fullflexible, > #+LaTeX_HEADER: keepspaces=true > #+LaTeX_HEADER: } > #+LaTeX_CLASS_OPTIONS: > [book,letterpaper,times,12pt,listings-bw,microtype] > > but the PDFs I'm getting still look like articles. (I copied the > above from some examples posted on this list a while ago. Thanks!) Your LaTeX_CLASS is set to `koma-article', so that makes sense. > 2. Are there any advantages to considering MarkDown or AsciiDoc as > opposed to org markup? (Again, my familiarity with org is a strong > incentive here, but I'm willing to consider other options.) There is a (IMHO) excellent markdown-mode available on Melpa, and if you use Pandoc[1] to convert your documents you have a lot of flexibility. There's also `pandoc-mode' (of which I'm the author), a minor mode that makes interacting with pandoc from within Emacs easier. > 3. The direct route from org to DocBook xml seems to be missing. From > what I gather, I can get there somehow via texi (but I don't even have > that in org currently), or perhaps export to HTML and then convert that > to db xml. Am I missing something? Is there some other route I should > consider? Pandoc can convert to Docbook, so that might be an option. Note that Pandoc also converts *from* Org, (although it cannot handle all of Org's capabilities), so depending on your needs, that might be a way to go directly from Org to Docbook. > 4. [LONGSHOT] Is there any way to /import/ docbook xml into org mode? Pandoc also converts *from* Docbook, and can convert *to* Org, so again, that might be of help. Of course, whether Pandoc can be useful to you really depends on your needs. Pandoc's internal document representation is based on Markdown, and by its very nature Markdown is more limited in it capabilities than Org. In essence, anything that cannot be handled by (Pandoc's version of) Markdown, cannot be handled by Pandoc in other formats. HTH -- Joost Kremers Life has its moments