* Making DocBook xml books from org mode?
@ 2016-09-29 18:04 Peter Davis
2016-09-29 19:23 ` Joost Kremers
` (2 more replies)
0 siblings, 3 replies; 26+ messages in thread
From: Peter Davis @ 2016-09-29 18:04 UTC (permalink / raw)
To: emacs-orgmode
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!)
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.)
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?
4. [LONGSHOT] Is there any way to /import/ docbook xml into org mode?
Thank you very much.
-pd
--
Peter Davis
www.techcurmudgeon.com
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-09-29 18:04 Making DocBook xml books from org mode? Peter Davis
@ 2016-09-29 19:23 ` Joost Kremers
2016-09-29 22:17 ` Peter Davis
2016-09-30 9:16 ` [DOCS] " Christian Moe
2016-09-30 9:37 ` Marcin Borkowski
2 siblings, 1 reply; 26+ messages in thread
From: Joost Kremers @ 2016-09-29 19:23 UTC (permalink / raw)
To: Peter Davis; +Cc: emacs-orgmode
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
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-09-29 19:23 ` Joost Kremers
@ 2016-09-29 22:17 ` Peter Davis
2016-09-30 15:44 ` Peter Davis
0 siblings, 1 reply; 26+ messages in thread
From: Peter Davis @ 2016-09-29 22:17 UTC (permalink / raw)
To: Joost Kremers; +Cc: emacs-orgmode
Dear Joost,
On Thu, Sep 29, 2016, at 03:23 PM, Joost Kremers wrote:
>
> On Thu, Sep 29 2016, Peter Davis wrote:
> >
> > 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.
>
Ah, yes! Thanks.
>
> > 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.
>
Bravo! Thank you again.
>
> > 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.
>
Thank you. I did succeed in exporting from org to texi, and then
makeinfo'ing that into a DocBook xml, though a bit of hand editing was
necessary.
>
> > 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.
>
Thanks. Sounds like Pandoc should really be in my toolkit.
>
> HTH
Definitely!
Thanks,
-pd
--
Peter Davis
www.techcurmudgeon.com
^ permalink raw reply [flat|nested] 26+ messages in thread
* [DOCS] Re: Making DocBook xml books from org mode?
2016-09-29 18:04 Making DocBook xml books from org mode? Peter Davis
2016-09-29 19:23 ` Joost Kremers
@ 2016-09-30 9:16 ` Christian Moe
2016-09-30 14:51 ` Peter Davis
2016-09-30 9:37 ` Marcin Borkowski
2 siblings, 1 reply; 26+ messages in thread
From: Christian Moe @ 2016-09-30 9:16 UTC (permalink / raw)
To: Peter Davis; +Cc: emacs-orgmode
Peter Davis writes:
> 3. The direct route from org to DocBook xml seems to be missing.
It's gone extinct, but there is a fossil record of it in the online
manual:
http://orgmode.org/guide/DocBook-export.html
It's not linked to from the TOC, but turned up in a DuckDuckGo
search. It should probably be carefully excavated and placed in the
Museum of Paleorgology.
Yours,
Christian
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-09-29 18:04 Making DocBook xml books from org mode? Peter Davis
2016-09-29 19:23 ` Joost Kremers
2016-09-30 9:16 ` [DOCS] " Christian Moe
@ 2016-09-30 9:37 ` Marcin Borkowski
2016-09-30 14:55 ` Peter Davis
2016-09-30 17:05 ` Nick Dokos
2 siblings, 2 replies; 26+ messages in thread
From: Marcin Borkowski @ 2016-09-30 9:37 UTC (permalink / raw)
To: Peter Davis; +Cc: emacs-orgmode
On 2016-09-29, at 20:04, Peter Davis <pfd@pfdstudio.com> 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.
Nice. Of many things XML is ill-suited to, marking text up is a nice
exception: it seems really good at it (definitely way better than LaTeX,
of which I'm a great fan!).
> 3. The direct route from org to DocBook xml seems to be missing. From
Why not start with the HTML exporter and write your own one? It's quite
fun, and can be done in reasonable time.
I did a talk about writing your own Org exporter during EmacsConf 2015;
also, I had a plan (and I even started) for a series of blog posts on
that topic, but I don't have time for that now. Still, you might want
to pursue this road - you'd have (as opposed to Pandoc, which admittedly
is a great tool, but has its limitations, as Joost mentioned) full
control over what get exported to what.
> 4. [LONGSHOT] Is there any way to /import/ docbook xml into org mode?
XSLT?
> Thank you very much.
>
> -pd
Hth,
--
Marcin Borkowski
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: [DOCS] Re: Making DocBook xml books from org mode?
2016-09-30 9:16 ` [DOCS] " Christian Moe
@ 2016-09-30 14:51 ` Peter Davis
2016-09-30 15:33 ` Thomas S. Dye
0 siblings, 1 reply; 26+ messages in thread
From: Peter Davis @ 2016-09-30 14:51 UTC (permalink / raw)
To: emacs-orgmode
On Fri, Sep 30, 2016, at 05:16 AM, Christian Moe wrote:
>
> Peter Davis writes:
>
> > 3. The direct route from org to DocBook xml seems to be missing.
>
> It's gone extinct, but there is a fossil record of it in the online
> manual:
>
> http://orgmode.org/guide/DocBook-export.html
>
> It's not linked to from the TOC, but turned up in a DuckDuckGo
> search. It should probably be carefully excavated and placed in the
> Museum of Paleorgology.
Thanks, Christian. This say I can use
C-c C-e D
but that gives me 'Invalid key', and it doesn't show up in the export
menu.
Thanks,
-pd
--
Peter Davis
www.techcurmudgeon.com
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-09-30 9:37 ` Marcin Borkowski
@ 2016-09-30 14:55 ` Peter Davis
2016-09-30 17:05 ` Nick Dokos
1 sibling, 0 replies; 26+ messages in thread
From: Peter Davis @ 2016-09-30 14:55 UTC (permalink / raw)
To: emacs-orgmode
On Fri, Sep 30, 2016, at 05:37 AM, Marcin Borkowski wrote:
>
> On 2016-09-29, at 20:04, Peter Davis <pfd@pfdstudio.com> 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.
>
> Nice. Of many things XML is ill-suited to, marking text up is a nice
> exception: it seems really good at it (definitely way better than LaTeX,
> of which I'm a great fan!).
>
I'm also a big LaTeX fan, but I don't use it often enough to remember
everything I need. I rely on copying stretches from documents I created
earlier, or constantly having to Google for solutions.
One thing I like about org-mode for creating documents (as opposed to
all its other uses), is the fact that I can easily remember the simple
mark-up, see reminders on screen while editing, and easily generate HTML
and PDF.
> > 3. The direct route from org to DocBook xml seems to be missing. From
>
> Why not start with the HTML exporter and write your own one? It's quite
> fun, and can be done in reasonable time.
>
For some definition of "reasonable." Seriously, I might want to do this
as an exercise sometime, but I can't wait for that right now.
>
> > 4. [LONGSHOT] Is there any way to /import/ docbook xml into org mode?
>
> XSLT?
>
Yes, that's a good option I hadn't considered.
>
> Hth,
>
Definitely. Thanks!
-pd
--
Peter Davis
www.techcurmudgeon.com
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: [DOCS] Re: Making DocBook xml books from org mode?
2016-09-30 14:51 ` Peter Davis
@ 2016-09-30 15:33 ` Thomas S. Dye
2016-09-30 15:46 ` Peter Davis
0 siblings, 1 reply; 26+ messages in thread
From: Thomas S. Dye @ 2016-09-30 15:33 UTC (permalink / raw)
To: Peter Davis; +Cc: emacs-orgmode
Aloha pd,
Peter Davis writes:
> On Fri, Sep 30, 2016, at 05:16 AM, Christian Moe wrote:
>>
>> Peter Davis writes:
>>
>> > 3. The direct route from org to DocBook xml seems to be missing.
>>
>> It's gone extinct, but there is a fossil record of it in the online
>> manual:
>>
>> http://orgmode.org/guide/DocBook-export.html
>>
>> It's not linked to from the TOC, but turned up in a DuckDuckGo
>> search. It should probably be carefully excavated and placed in the
>> Museum of Paleorgology.
>
> Thanks, Christian. This say I can use
>
> C-c C-e D
>
> but that gives me 'Invalid key', and it doesn't show up in the export
> menu.
This was part of the old exporter. It hasn't been ported to the new one.
All the best,
Tom
--
Thomas S. Dye
http://www.tsdye.com
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-09-29 22:17 ` Peter Davis
@ 2016-09-30 15:44 ` Peter Davis
2016-10-02 21:23 ` Peter Davis
0 siblings, 1 reply; 26+ messages in thread
From: Peter Davis @ 2016-09-30 15:44 UTC (permalink / raw)
To: Joost Kremers; +Cc: emacs-orgmode
To follow up ...
On Thu, Sep 29, 2016, at 06:17 PM, Peter Davis wrote:
> On Thu, Sep 29, 2016, at 03:23 PM, Joost Kremers wrote:
> >
> > 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.
> >
>
> Thank you. I did succeed in exporting from org to texi, and then
> makeinfo'ing that into a DocBook xml, though a bit of hand editing was
> necessary.
>
I did manage to get this working. I found I had to export to Pandoc
instead of running pandoc from a command line with the org file as
input. Otherwise, the embedded dot code I used would not link to an
image, but simply contain the dot code as source.
Unfortunately, in trying to export to a file, I'm getting
Unable to resolve link "www.gimp.org/downloads"
I don't know where this is coming from, or how to fix it.
Finally, the 'Export with Pandoc' menu item only gives me two choices:
[P] Markdown to buffer
[p] To file
I assume it's just generating Markdown, which would then have to be
converted to docbook or whatever in a separate step. Any way to export
to docbook directly, using Pandoc implicitly?
Thanks!
-pd
--
Peter Davis
www.techcurmudgeon.com
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: [DOCS] Re: Making DocBook xml books from org mode?
2016-09-30 15:33 ` Thomas S. Dye
@ 2016-09-30 15:46 ` Peter Davis
2016-09-30 19:37 ` Nick Dokos
0 siblings, 1 reply; 26+ messages in thread
From: Peter Davis @ 2016-09-30 15:46 UTC (permalink / raw)
To: Thomas S. Dye; +Cc: emacs-orgmode
Hi, Tom,
On Fri, Sep 30, 2016, at 11:33 AM, Thomas S. Dye wrote:
> ... stuff excised ...
>
> This was part of the old exporter. It hasn't been ported to the new one.
Thanks, Tom. Christian's post made me wonder if this was hiding in the
background somewhere.
Cheers,
-pd
--
Peter Davis
www.techcurmudgeon.com
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-09-30 9:37 ` Marcin Borkowski
2016-09-30 14:55 ` Peter Davis
@ 2016-09-30 17:05 ` Nick Dokos
1 sibling, 0 replies; 26+ messages in thread
From: Nick Dokos @ 2016-09-30 17:05 UTC (permalink / raw)
To: emacs-orgmode
Marcin Borkowski <mbork@mbork.pl> writes:
> On 2016-09-29, at 20:04, Peter Davis <pfd@pfdstudio.com> 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.
>
> Nice. Of many things XML is ill-suited to, marking text up is a nice
> exception: it seems really good at it (definitely way better than LaTeX,
> of which I'm a great fan!).
>
Why do you think so? I've used XML lightly over the years and I have found
it to be a bear. LaTeX has its own problems but I grew up with it, so I guess
I'm less conscious of its flaws (but I rarely write LaTeX any more: org has
subsumed it). Should I change my mind?
>> 3. The direct route from org to DocBook xml seems to be missing. From
>
My memory might be playing tricks on me, but wasn't there a docbook
exporter at some point? Maybe it did not survive the 8.x transition?
Or am I misremembering?
--
Nick
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: [DOCS] Re: Making DocBook xml books from org mode?
2016-09-30 15:46 ` Peter Davis
@ 2016-09-30 19:37 ` Nick Dokos
2016-09-30 19:46 ` Peter Davis
` (2 more replies)
0 siblings, 3 replies; 26+ messages in thread
From: Nick Dokos @ 2016-09-30 19:37 UTC (permalink / raw)
To: emacs-orgmode
Peter Davis <pfd@pfdstudio.com> writes:
> Hi, Tom,
>
> On Fri, Sep 30, 2016, at 11:33 AM, Thomas S. Dye wrote:
>> ... stuff excised ...
>>
>> This was part of the old exporter. It hasn't been ported to the new one.
>
> Thanks, Tom. Christian's post made me wonder if this was hiding in the
> background somewhere.
>
There is a footnote in the (incomplete) page
http://orgmode.org/worg/exporters/ox-overview.html
that says:
,----
| (1) DocBook export, available in previous Org-mode versions, has not
| currently been ported to the new exporter, however the new ox-texinfo
| backend can generate DocBook format. Once file.texi is created via
| ox-texinfo, simply execute:
|
| makeinfo --docbook file.texi
`----
I wonder if that will meet the OP's requirements.
--
Nick
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: [DOCS] Re: Making DocBook xml books from org mode?
2016-09-30 19:37 ` Nick Dokos
@ 2016-09-30 19:46 ` Peter Davis
2016-09-30 20:18 ` Colin Baxter
2016-10-05 13:32 ` Peter Davis
2 siblings, 0 replies; 26+ messages in thread
From: Peter Davis @ 2016-09-30 19:46 UTC (permalink / raw)
To: emacs-orgmode
On Fri, Sep 30, 2016, at 03:37 PM, Nick Dokos wrote:
> Peter Davis <pfd@pfdstudio.com> writes:
>
> > Hi, Tom,
> >
> > On Fri, Sep 30, 2016, at 11:33 AM, Thomas S. Dye wrote:
> >> ... stuff excised ...
> >>
> >> This was part of the old exporter. It hasn't been ported to the new one.
> >
> > Thanks, Tom. Christian's post made me wonder if this was hiding in the
> > background somewhere.
> >
>
> There is a footnote in the (incomplete) page
>
> http://orgmode.org/worg/exporters/ox-overview.html
>
> that says:
>
> ,----
> | (1) DocBook export, available in previous Org-mode versions, has not
> | currently been ported to the new exporter, however the new ox-texinfo
> | backend can generate DocBook format. Once file.texi is created via
> | ox-texinfo, simply execute:
> |
> | makeinfo --docbook file.texi
> `----
>
> I wonder if that will meet the OP's requirements.
>
Hi, Nick,
Yes, I did see that, and I did succeed in creating a DocBook file by
exporting to texi and then converting with makeinfo. It's a bit
unwieldy, but it will do in a pinch. I'm not sure how this compares with
pandoc.
I'd really like to be able to set things like doctype, etc.
automatically, but there doesn't seem to be a way to do that in the org
file so that it would survive getting passed through texi into docbook
xml (or pandoc, for that matter).
Thanks,
-pd
--
Peter Davis
www.techcurmudgeon.com
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: [DOCS] Re: Making DocBook xml books from org mode?
2016-09-30 19:37 ` Nick Dokos
2016-09-30 19:46 ` Peter Davis
@ 2016-09-30 20:18 ` Colin Baxter
2016-09-30 20:50 ` Nick Dokos
2016-10-05 13:32 ` Peter Davis
2 siblings, 1 reply; 26+ messages in thread
From: Colin Baxter @ 2016-09-30 20:18 UTC (permalink / raw)
To: Nick Dokos; +Cc: emacs-orgmode
Hello,
On Fri, Sep 30 2016, Nick Dokos wrote:
> Peter Davis <pfd@pfdstudio.com> writes:
... snip ...
> ,----
> | (1) DocBook export, available in previous Org-mode versions, has not
> | currently been ported to the new exporter, however the new ox-texinfo
> | backend can generate DocBook format. Once file.texi is created via
> | ox-texinfo, simply execute:
> |
> | makeinfo --docbook file.texi
> `----
>
No need to call makeinfo explicitly, "file.info" is an output option.
Best wishes,
Colin.
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: [DOCS] Re: Making DocBook xml books from org mode?
2016-09-30 20:18 ` Colin Baxter
@ 2016-09-30 20:50 ` Nick Dokos
2016-10-01 8:01 ` Colin Baxter
0 siblings, 1 reply; 26+ messages in thread
From: Nick Dokos @ 2016-09-30 20:50 UTC (permalink / raw)
To: emacs-orgmode
Colin Baxter <m43cap@yandex.com> writes:
> Hello,
>
> On Fri, Sep 30 2016, Nick Dokos wrote:
>
>> Peter Davis <pfd@pfdstudio.com> writes:
>
> ... snip ...
>> ,----
>> | (1) DocBook export, available in previous Org-mode versions, has not
>> | currently been ported to the new exporter, however the new ox-texinfo
>> | backend can generate DocBook format. Once file.texi is created via
>> | ox-texinfo, simply execute:
>> |
>> | makeinfo --docbook file.texi
>> `----
>>
>
> No need to call makeinfo explicitly, "file.info" is an output option.
>
But the OP wanted Docbook XML, not info.
--
Nick
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: [DOCS] Re: Making DocBook xml books from org mode?
2016-09-30 20:50 ` Nick Dokos
@ 2016-10-01 8:01 ` Colin Baxter
0 siblings, 0 replies; 26+ messages in thread
From: Colin Baxter @ 2016-10-01 8:01 UTC (permalink / raw)
To: Nick Dokos; +Cc: emacs-orgmode
On Fri, Sep 30 2016, Nick Dokos wrote:
Hello,
>
> But the OP wanted Docbook XML, not info.
Ah! I must remember to read a thread more carefully next time. Thanks.
Best wishes,
Colin.
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-09-30 15:44 ` Peter Davis
@ 2016-10-02 21:23 ` Peter Davis
2016-10-02 21:35 ` Joost Kremers
2016-10-03 3:38 ` Marcin Borkowski
0 siblings, 2 replies; 26+ messages in thread
From: Peter Davis @ 2016-10-02 21:23 UTC (permalink / raw)
To: Joost Kremers; +Cc: emacs-orgmode
Peter Davis <pfd@pfdstudio.com> writes:
> To follow up ...
>
> On Thu, Sep 29, 2016, at 06:17 PM, Peter Davis wrote:
>> On Thu, Sep 29, 2016, at 03:23 PM, Joost Kremers wrote:
>> >
>> > 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.
>> >
>>
>> Thank you. I did succeed in exporting from org to texi, and then
>> makeinfo'ing that into a DocBook xml, though a bit of hand editing was
>> necessary.
>>
>
> I did manage to get this working. I found I had to export to Pandoc
> instead of running pandoc from a command line with the org file as
> input. Otherwise, the embedded dot code I used would not link to an
> image, but simply contain the dot code as source.
>
> Unfortunately, in trying to export to a file, I'm getting
>
> Unable to resolve link "www.gimp.org/downloads"
>
> I don't know where this is coming from, or how to fix it.
>
> Finally, the 'Export with Pandoc' menu item only gives me two choices:
> [P] Markdown to buffer
> [p] To file
>
> I assume it's just generating Markdown, which would then have to be
> converted to docbook or whatever in a separate step. Any way to export
> to docbook directly, using Pandoc implicitly?
I'm trying this again, on a Mac instead of Windows. I managed to get
ox-pandoc working. (It now displays an org export menu too big to fit on
my screen, and I can't figure out how to scroll it.)
When I try to export to docbook via pandoc (C-c C-e p d), I get
Running pandoc with args: (-f org -t docbook5 -o /Users/peterdavis/Dropbox/HMH/my_file.dbk --parse-raw --mathjax --standalone /Users/peterdavis/Dropbox/HMH/my_file.tmp3362h9T.org)
Error occured.
pandoc: Unknown writer: docbook5
Any guesses? Is there something additional I need to install in pandoc?
Thanks!
-pd
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-10-02 21:23 ` Peter Davis
@ 2016-10-02 21:35 ` Joost Kremers
2016-10-02 21:46 ` Peter Davis
2016-10-03 2:09 ` Norman Walsh
2016-10-03 3:38 ` Marcin Borkowski
1 sibling, 2 replies; 26+ messages in thread
From: Joost Kremers @ 2016-10-02 21:35 UTC (permalink / raw)
To: Peter Davis; +Cc: emacs-orgmode
On Sun, Oct 02 2016, Peter Davis wrote:
> When I try to export to docbook via pandoc (C-c C-e p d), I get
>
> Running pandoc with args: (-f org -t docbook5 -o /Users/peterdavis/Dropbox/HMH/my_file.dbk --parse-raw --mathjax --standalone /Users/peterdavis/Dropbox/HMH/my_file.tmp3362h9T.org)
> Error occured.
> pandoc: Unknown writer: docbook5
>
> Any guesses? Is there something additional I need to install in pandoc?
The `docbook5' writer was added to Pandoc fairly recently, in version
1.17.1, released in June of this year. There's also a `docbook' writer,
which has been part of Pandoc much longer and which outputs to (I
assume) DocBook v4. So I suspect you either need to upgrade your Pandoc
or make sure ox-pandoc sets the output format to `docbook'.
--
Joost Kremers
Life has its moments
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-10-02 21:35 ` Joost Kremers
@ 2016-10-02 21:46 ` Peter Davis
2016-10-02 22:12 ` Joost Kremers
2016-10-03 2:09 ` Norman Walsh
1 sibling, 1 reply; 26+ messages in thread
From: Peter Davis @ 2016-10-02 21:46 UTC (permalink / raw)
To: Joost Kremers; +Cc: emacs-orgmode
Joost Kremers <joostkremers@fastmail.fm> writes:
> On Sun, Oct 02 2016, Peter Davis wrote:
>> When I try to export to docbook via pandoc (C-c C-e p d), I get
>>
>> Running pandoc with args: (-f org -t docbook5 -o /Users/peterdavis/Dropbox/HMH/my_file.dbk --parse-raw --mathjax --standalone /Users/peterdavis/Dropbox/HMH/my_file.tmp3362h9T.org)
>> Error occured.
>> pandoc: Unknown writer: docbook5
>>
>> Any guesses? Is there something additional I need to install in pandoc?
>
> The `docbook5' writer was added to Pandoc fairly recently, in version
> 1.17.1, released in June of this year.
Interesting. I just installed Pandoc on my Mac today with Homebrew, but
it claims to be 1.13.1. I'll try to find an update. Thanks.
> There's also a `docbook' writer,
> which has been part of Pandoc much longer and which outputs to (I
> assume) DocBook v4. So I suspect you either need to upgrade your Pandoc
> or make sure ox-pandoc sets the output format to `docbook'.
Well, I'm trying to output docbook5 anyway, so better to update my
installation.
Thank you.
-pd
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-10-02 21:46 ` Peter Davis
@ 2016-10-02 22:12 ` Joost Kremers
2016-10-03 0:32 ` Peter Davis
0 siblings, 1 reply; 26+ messages in thread
From: Joost Kremers @ 2016-10-02 22:12 UTC (permalink / raw)
To: Peter Davis; +Cc: emacs-orgmode
On Sun, Oct 02 2016, Peter Davis wrote:
> Interesting. I just installed Pandoc on my Mac today with Homebrew, but
> it claims to be 1.13.1. I'll try to find an update. Thanks.
Check the "Installing" page on pandoc.org: there's a link to an OS X
package on Pandoc's Github page:
https://github.com/jgm/pandoc/releases/tag/1.17.2
Perhaps you can use that?
--
Joost Kremers
Life has its moments
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-10-02 22:12 ` Joost Kremers
@ 2016-10-03 0:32 ` Peter Davis
0 siblings, 0 replies; 26+ messages in thread
From: Peter Davis @ 2016-10-03 0:32 UTC (permalink / raw)
To: Joost Kremers; +Cc: emacs-orgmode
Joost Kremers <joostkremers@fastmail.fm> writes:
> On Sun, Oct 02 2016, Peter Davis wrote:
>> Interesting. I just installed Pandoc on my Mac today with Homebrew, but
>> it claims to be 1.13.1. I'll try to find an update. Thanks.
>
> Check the "Installing" page on pandoc.org: there's a link to an OS X
> package on Pandoc's Github page:
>
> https://github.com/jgm/pandoc/releases/tag/1.17.2
>
Thanks again, Joost. I didn't find any installation instructions or kits, but I just copied the executable from the .pkg file to
/usr/local/bin on my machine, overwriting the 1.13 version that was there. That seems to have worked. I was able to export from org-mode to
docbook.
Thanks!
-pd
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-10-02 21:35 ` Joost Kremers
2016-10-02 21:46 ` Peter Davis
@ 2016-10-03 2:09 ` Norman Walsh
2016-10-03 12:46 ` Peter Davis
1 sibling, 1 reply; 26+ messages in thread
From: Norman Walsh @ 2016-10-03 2:09 UTC (permalink / raw)
To: emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 746 bytes --]
Joost Kremers <joostkremers@fastmail.fm> writes:
> There's also a `docbook' writer,
> which has been part of Pandoc much longer and which outputs to (I
> assume) DocBook v4. So I suspect you either need to upgrade your Pandoc
> or make sure ox-pandoc sets the output format to `docbook'.
Depending on what your down-stream processing is like, you could
just go with V4 DocBook from org and then convert that to V5 with
the upgrade stylesheet.
Be seeing you,
norm
--
Norman Walsh <ndw@nwalsh.com> | There is no monument dedicated to the
http://nwalsh.com/ | memory of a committee.--Lester J.
| Pourciau
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 172 bytes --]
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-10-02 21:23 ` Peter Davis
2016-10-02 21:35 ` Joost Kremers
@ 2016-10-03 3:38 ` Marcin Borkowski
2016-10-03 12:49 ` Peter Davis
1 sibling, 1 reply; 26+ messages in thread
From: Marcin Borkowski @ 2016-10-03 3:38 UTC (permalink / raw)
To: Peter Davis; +Cc: Joost Kremers, emacs-orgmode
On 2016-10-02, at 23:23, Peter Davis <pfd@pfdstudio.com> wrote:
> I'm trying this again, on a Mac instead of Windows. I managed to get
> ox-pandoc working. (It now displays an org export menu too big to fit on
> my screen, and I can't figure out how to scroll it.)
Space/backspace?
Best,
--
Marcin Borkowski
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-10-03 2:09 ` Norman Walsh
@ 2016-10-03 12:46 ` Peter Davis
0 siblings, 0 replies; 26+ messages in thread
From: Peter Davis @ 2016-10-03 12:46 UTC (permalink / raw)
To: emacs-orgmode
On Sun, Oct 2, 2016, at 10:09 PM, Norman Walsh wrote:
> Joost Kremers <joostkremers@fastmail.fm> writes:
> > There's also a `docbook' writer,
> > which has been part of Pandoc much longer and which outputs to (I
> > assume) DocBook v4. So I suspect you either need to upgrade your Pandoc
> > or make sure ox-pandoc sets the output format to `docbook'.
>
> Depending on what your down-stream processing is like, you could
> just go with V4 DocBook from org and then convert that to V5 with
> the upgrade stylesheet.
>
Thank you, Norm. I'll keep that in mind, but if I can get directly to
DocBook5, that seems easier and less "lossy."
Cheers,
-pd
--
Peter Davis
www.techcurmudgeon.com
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: Making DocBook xml books from org mode?
2016-10-03 3:38 ` Marcin Borkowski
@ 2016-10-03 12:49 ` Peter Davis
0 siblings, 0 replies; 26+ messages in thread
From: Peter Davis @ 2016-10-03 12:49 UTC (permalink / raw)
To: Marcin Borkowski; +Cc: Joost Kremers, emacs-orgmode
On Sun, Oct 2, 2016, at 11:38 PM, Marcin Borkowski wrote:
>
> On 2016-10-02, at 23:23, Peter Davis <pfd@pfdstudio.com> wrote:
>
> > I'm trying this again, on a Mac instead of Windows. I managed to get
> > ox-pandoc working. (It now displays an org export menu too big to fit on
> > my screen, and I can't figure out how to scroll it.)
>
> Space/backspace?
I'll give it a try. Thanks, Marcin!
Now here's the real problem. I get this slew of pandoc output options on
my Mac, but on my Win10 machine, also with pandoc 1.117.2, I only get
two options:
[P] Markdown to buffer
[p] To file
I seem to be running the right ox-pandoc, so I'm not sure how to get all
the other options.
I could run pandoc on the org file from a command line, but then the
embedded dot diagrams won't be evaluated. Perhaps export to HTML (or
some other format?) and then use pandoc to convert to docbook?
Thanks,
-pd
--
Peter Davis
www.techcurmudgeon.com
^ permalink raw reply [flat|nested] 26+ messages in thread
* Re: [DOCS] Re: Making DocBook xml books from org mode?
2016-09-30 19:37 ` Nick Dokos
2016-09-30 19:46 ` Peter Davis
2016-09-30 20:18 ` Colin Baxter
@ 2016-10-05 13:32 ` Peter Davis
2 siblings, 0 replies; 26+ messages in thread
From: Peter Davis @ 2016-10-05 13:32 UTC (permalink / raw)
To: emacs-orgmode
On Fri, Sep 30, 2016, at 03:37 PM, Nick Dokos wrote:
> Peter Davis <pfd@pfdstudio.com> writes:
>
> > Hi, Tom,
> >
> > On Fri, Sep 30, 2016, at 11:33 AM, Thomas S. Dye wrote:
> >> ... stuff excised ...
> >>
> >> This was part of the old exporter. It hasn't been ported to the new one.
> >
> > Thanks, Tom. Christian's post made me wonder if this was hiding in the
> > background somewhere.
> >
>
> There is a footnote in the (incomplete) page
>
> http://orgmode.org/worg/exporters/ox-overview.html
>
> that says:
>
> ,----
> | (1) DocBook export, available in previous Org-mode versions, has not
> | currently been ported to the new exporter, however the new ox-texinfo
> | backend can generate DocBook format. Once file.texi is created via
> | ox-texinfo, simply execute:
> |
> | makeinfo --docbook file.texi
> `----
>
> I wonder if that will meet the OP's requirements.
>
I've been trying this, but on Windows 10, makeinfo keeps generating info
files, even with the --docbook switch specified. I can not get it to
output xml.
Thanks,
-pd
--
Peter Davis
www.techcurmudgeon.com
^ permalink raw reply [flat|nested] 26+ messages in thread
end of thread, other threads:[~2016-10-05 13:32 UTC | newest]
Thread overview: 26+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2016-09-29 18:04 Making DocBook xml books from org mode? Peter Davis
2016-09-29 19:23 ` Joost Kremers
2016-09-29 22:17 ` Peter Davis
2016-09-30 15:44 ` Peter Davis
2016-10-02 21:23 ` Peter Davis
2016-10-02 21:35 ` Joost Kremers
2016-10-02 21:46 ` Peter Davis
2016-10-02 22:12 ` Joost Kremers
2016-10-03 0:32 ` Peter Davis
2016-10-03 2:09 ` Norman Walsh
2016-10-03 12:46 ` Peter Davis
2016-10-03 3:38 ` Marcin Borkowski
2016-10-03 12:49 ` Peter Davis
2016-09-30 9:16 ` [DOCS] " Christian Moe
2016-09-30 14:51 ` Peter Davis
2016-09-30 15:33 ` Thomas S. Dye
2016-09-30 15:46 ` Peter Davis
2016-09-30 19:37 ` Nick Dokos
2016-09-30 19:46 ` Peter Davis
2016-09-30 20:18 ` Colin Baxter
2016-09-30 20:50 ` Nick Dokos
2016-10-01 8:01 ` Colin Baxter
2016-10-05 13:32 ` Peter Davis
2016-09-30 9:37 ` Marcin Borkowski
2016-09-30 14:55 ` Peter Davis
2016-09-30 17:05 ` Nick Dokos
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).