Navigation Menu

Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add ODT export format #23

Closed
bdarcus opened this issue Jun 3, 2021 · 6 comments · Fixed by #45
Closed

Add ODT export format #23

bdarcus opened this issue Jun 3, 2021 · 6 comments · Fixed by #45

Comments

@bdarcus
Copy link
Collaborator

bdarcus commented Jun 3, 2021

To accommodate people who need to target MS Word, etc, with real footnotes, etc.

@denismaier
Copy link
Collaborator

Shouldn't that be done on the org-side?

@bdarcus
Copy link
Collaborator Author

bdarcus commented Jun 3, 2021

Yes, also, but ODT isn't a supported format here, according to the docs.

@denismaier
Copy link
Collaborator

I still don't get it. Wouldn't it make more sense to go through a common intermediary? E.g. org-syntax? So that citeproc-el doesn't have to do the formatting for all output formats.

@denismaier
Copy link
Collaborator

Maybe I'm to much influenced by pandoc here, but I would expect citeproc-el to work with all supported output formats out-of-the-box without further configuration.

@bdarcus
Copy link
Collaborator Author

bdarcus commented Jun 3, 2021

IDK why the current design, but that's not how this library works. See:

https://github.com/andras-simonyi/citeproc-el/blob/master/citeproc-formatters.el

@andras-simonyi
Copy link
Owner

andras-simonyi commented Jun 4, 2021

I still don't get it. Wouldn't it make more sense to go through a common intermediary? E.g. org-syntax? So that citeproc-el doesn't have to do the formatting for all output formats.

The main reason for the existence of multiple citeproc-el formatting backends is that Org markup is not expressive enough to represent some of the formatting described by CSL styles, e.g., there is no native Org representation of small caps or hanging indent. Because of these limitations, citeproc-el is designed to be able to provide richer export for important formats that can actually describe (some of) these formatting instructions like HTML and LaTeX, everything else can indeed use the Org citeproc-el backend as an intermediary.

For exporting Org documents with a particular backend using citeproc-el this means that the exporter has to use the dedicated citeproc-el backend for the format in question if it's available, and use the Org citeproc-el backend as a fallback. This ensures that citations and bibliographies can be exported to any format for which there is an Org exporter, and the exported documents will contain richer formatting than what would be possible with plain Org if there is a compatible dedicated citeproc-el backend.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants