[ANN] ox-pandoc, revived

[ANN] ox-pandoc, revived

[Alex Fenton]

[-- Attachment #1: Type: text/plain, Size: 1026 bytes --]

Hello,

ox-pandoc is an exporter for Org Mode that uses pandoc 
(https://pandoc.org/) to export to a very wide variety of text markup 
(e.g. markdown variants), document (ODT, docx) and presentation (e.g. 
html, .pdf) formats. It is available via MELPA and at: 
https://github.com/emacsorphanage/ox-pandoc

pandoc handles almost all org text-markup features and offers many 
options for controlling output. With ox-pandoc, it can also be used with 
Org Mode's code evaluation.

ox-pandoc was originally created by kawabata, but had fallen out of step 
over the past few years with recent pandoc and Org Mode versions. As a 
result, it had a number of serious bugs. Current releases roll up a 
dozen or so fixes and enhancements and with the kind help of the MELPA 
team, the package is now distributed from a maintained repo.

The current version includes initial support for org citations in Org 
9.5. This feature is experimental and I welcome feedback and reports on 
this or any other aspect of the package.

best

alex



[-- Attachment #2: Type: text/html, Size: 1771 bytes --]

Re: [ANN] ox-pandoc, revived

[Denis Maier]

Am 30.11.2021 um 09:40 schrieb Alex Fenton:
> Hello,
> 
> ox-pandoc is an exporter for Org Mode that uses pandoc 
> (https://pandoc.org/) to export to a very wide variety of text markup 
> (e.g. markdown variants), document (ODT, docx) and presentation (e.g. 
> html, .pdf) formats. It is available via MELPA and at: 
> https://github.com/emacsorphanage/ox-pandoc
> 
> pandoc handles almost all org text-markup features and offers many 
> options for controlling output. With ox-pandoc, it can also be used with 
> Org Mode's code evaluation.
> 
> ox-pandoc was originally created by kawabata, but had fallen out of step 
> over the past few years with recent pandoc and Org Mode versions. As a 
> result, it had a number of serious bugs. Current releases roll up a 
> dozen or so fixes and enhancements and with the kind help of the MELPA 
> team, the package is now distributed from a maintained repo.
> 
> The current version includes initial support for org citations in Org 
> 9.5. This feature is experimental and I welcome feedback and reports on 
> this or any other aspect of the package.
> 
> best
> 
> alex
>

That's great. Thank you.


Regarding citations and 
https://github.com/emacsorphanage/ox-pandoc#alternative-using-pandoc-citation-syntax: 
There are also plans to support the new org cite citation syntax on the 
pandoc side of things. This might make some things easier in the future.

Denis

Re: [ANN] ox-pandoc, revived

[Timothy]

[-- Attachment #1.1: Type: text/plain, Size: 147 bytes --]

Hi Alex,

Great to hear that someone is taking care of ox-pandoc again!

Thanks for stepping up, and I wish you all the best 🙂.

Timothy

[-- Attachment #1.2: Type: text/html, Size: 4470 bytes --]

Re: [ANN] ox-pandoc, revived

[Bruce D'Arcus]

On Tue, Nov 30, 2021 at 7:50 AM Alex Fenton <alex.fenton@pressure.to> wrote:

> The current version includes initial support for org citations in Org 9.5. This feature is experimental and I welcome feedback and reports on this or any other aspect of the package.

Did pandoc get support for org-cite?

There's been basically zero activity on this issue I created awhile back:

https://github.com/jgm/pandoc/issues/7329

Or are you somehow massaging these citations into the "draft" format
already implemented in pandoc?

Bruce

Re: [ANN] ox-pandoc, revived

[Alex Fenton]

On 30/11/2021 15:09, Bruce D'Arcus wrote:

> Did pandoc get support for org-cite?
> 
> There's been basically zero activity on this issue I created awhile back:
> 
> https://github.com/jgm/pandoc/issues/7329

AFAIK pandoc still doesn't support the official Org Mode syntax.

ox-pandoc relies on the fact that it first exports to an intermediate 
org file before handing off to pandoc. SRC blocks and citations are 
already resolved by the time pandoc is called.

If exporting with oc-natbib or oc-biblatex, citations are replaced by 
LaTeX commands, which pandoc passes through to the compiler. If 
exporting with oc-csl, citations and bibliographies are "just" formatted 
text by the time pandoc sees it.

I may add an oc-pandoc to massage org citations into pandoc format if 
there is a need to have citations be resolved by pandoc rather than Org 
Mode.

best
alex

Re: [ANN] ox-pandoc, revived

[Bruce D'Arcus]

On Tue, Nov 30, 2021 at 9:27 AM Alex Fenton <alex.fenton@pressure.to> wrote:
>
> On 30/11/2021 15:09, Bruce D'Arcus wrote:

> AFAIK pandoc still doesn't support the official Org Mode syntax.
>
> ox-pandoc relies on the fact that it first exports to an intermediate
> org file before handing off to pandoc. SRC blocks and citations are
> already resolved by the time pandoc is called.

...

> I may add an oc-pandoc to massage org citations into pandoc format if
> there is a need to have citations be resolved by pandoc rather than Org
> Mode.

I'm not sure that's necessary; it probably doesn't really matter in practice.

Perhaps you can reassess once pandoc itself is updated, so you don't
have to worry about writing and maintaining special code to do this?

FWIW, org-cite seems partially inspired by the pandoc citation model
and syntax, but is a superset of it (pandoc has no global affixes;
also doesn't have styles, though does have sort of boolean feature
flags). I'm not sure how pandoc itself will handle that difference.

Bruce