emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* [ANN] ox-pandoc, revived
@ 2021-11-30  8:40 Alex Fenton
  2021-11-30 13:56 ` Denis Maier
                   ` (2 more replies)
  0 siblings, 3 replies; 6+ messages in thread
From: Alex Fenton @ 2021-11-30  8:40 UTC (permalink / raw)
  To: emacs-orgmode

[-- 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 --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [ANN] ox-pandoc, revived
  2021-11-30  8:40 [ANN] ox-pandoc, revived Alex Fenton
@ 2021-11-30 13:56 ` Denis Maier
  2021-11-30 13:57 ` Timothy
  2021-11-30 14:09 ` Bruce D'Arcus
  2 siblings, 0 replies; 6+ messages in thread
From: Denis Maier @ 2021-11-30 13:56 UTC (permalink / raw)
  To: Alex Fenton, emacs-orgmode

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



^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [ANN] ox-pandoc, revived
  2021-11-30  8:40 [ANN] ox-pandoc, revived Alex Fenton
  2021-11-30 13:56 ` Denis Maier
@ 2021-11-30 13:57 ` Timothy
  2021-11-30 14:09 ` Bruce D'Arcus
  2 siblings, 0 replies; 6+ messages in thread
From: Timothy @ 2021-11-30 13:57 UTC (permalink / raw)
  To: Alex Fenton; +Cc: emacs-orgmode


[-- 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 --]

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [ANN] ox-pandoc, revived
  2021-11-30  8:40 [ANN] ox-pandoc, revived Alex Fenton
  2021-11-30 13:56 ` Denis Maier
  2021-11-30 13:57 ` Timothy
@ 2021-11-30 14:09 ` Bruce D'Arcus
  2021-11-30 14:27   ` Alex Fenton
  2 siblings, 1 reply; 6+ messages in thread
From: Bruce D'Arcus @ 2021-11-30 14:09 UTC (permalink / raw)
  To: Alex Fenton; +Cc: org-mode-email

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


^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [ANN] ox-pandoc, revived
  2021-11-30 14:09 ` Bruce D'Arcus
@ 2021-11-30 14:27   ` Alex Fenton
  2021-11-30 14:37     ` Bruce D'Arcus
  0 siblings, 1 reply; 6+ messages in thread
From: Alex Fenton @ 2021-11-30 14:27 UTC (permalink / raw)
  To: Bruce D'Arcus; +Cc: org-mode-email

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


^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [ANN] ox-pandoc, revived
  2021-11-30 14:27   ` Alex Fenton
@ 2021-11-30 14:37     ` Bruce D'Arcus
  0 siblings, 0 replies; 6+ messages in thread
From: Bruce D'Arcus @ 2021-11-30 14:37 UTC (permalink / raw)
  To: Alex Fenton; +Cc: org-mode-email

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


^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2021-11-30 14:38 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-11-30  8:40 [ANN] ox-pandoc, revived Alex Fenton
2021-11-30 13:56 ` Denis Maier
2021-11-30 13:57 ` Timothy
2021-11-30 14:09 ` Bruce D'Arcus
2021-11-30 14:27   ` Alex Fenton
2021-11-30 14:37     ` Bruce D'Arcus

Code repositories for project(s) associated with this 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).