Documentation for ODT output

Documentation for ODT output

[Stephan Boltzmann]

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

Hello everybody out there using Pandoc,

With LaTeX output I have a bit of experience and I also manage to use 
pandocfilters to customize the output, but I have a harder time with the 
ODT format.
ODT is an open format, but I already fail in finding documentation on how I 
could, as a simple example, center headlines, images or image captions.
Writing the filters in Python is actually fun, but I would need a hint on 
where I can find the necessary markup for centering text.

Best,
Stephan

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/9506a809-476b-4063-9c3b-ec89b7bf71bcn%40googlegroups.com.

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

Re: Documentation for ODT output

[John MacFarlane]

The xml format used in ODT is called opendocument.
Standard is here:
http://docs.oasis-open.org/office/v1.2/os/OpenDocument-v1.2-os.html
That's a place to start, anyway.
I'm not an expert on this format, but someone else here may be
able to offer more help.

Stephan Boltzmann <stephan2boltzmann-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:

> Hello everybody out there using Pandoc,
>
> With LaTeX output I have a bit of experience and I also manage to use 
> pandocfilters to customize the output, but I have a harder time with the 
> ODT format.
> ODT is an open format, but I already fail in finding documentation on how I 
> could, as a simple example, center headlines, images or image captions.
> Writing the filters in Python is actually fun, but I would need a hint on 
> where I can find the necessary markup for centering text.
>
> Best,
> Stephan
>
> -- 
> You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/9506a809-476b-4063-9c3b-ec89b7bf71bcn%40googlegroups.com.

Re: Documentation for ODT output

[Stephan Boltzmann]

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

Thanks a lot for the link.
I had found it before with normal web search and will still look for a 
shorter source, which would be easier to digest.
In case someone is interested in DOCX ouput, one might find the website 
http://officeopenxml.com/ helpful.

John MacFarlane schrieb am Montag, 14. Dezember 2020 um 18:31:55 UTC+1:

>
> The xml format used in ODT is called opendocument.
> Standard is here:
> http://docs.oasis-open.org/office/v1.2/os/OpenDocument-v1.2-os.html
> That's a place to start, anyway.
> I'm not an expert on this format, but someone else here may be
> able to offer more help.
>
> Stephan Boltzmann <stephan2...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:
>
> > Hello everybody out there using Pandoc,
> >
> > With LaTeX output I have a bit of experience and I also manage to use 
> > pandocfilters to customize the output, but I have a harder time with the 
> > ODT format.
> > ODT is an open format, but I already fail in finding documentation on 
> how I 
> > could, as a simple example, center headlines, images or image captions.
> > Writing the filters in Python is actually fun, but I would need a hint 
> on 
> > where I can find the necessary markup for centering text.
> >
> > Best,
> > Stephan
> >
> > -- 
> > You received this message because you are subscribed to the Google 
> Groups "pandoc-discuss" group.
> > To unsubscribe from this group and stop receiving emails from it, send 
> an email to pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> > To view this discussion on the web visit 
> https://groups.google.com/d/msgid/pandoc-discuss/9506a809-476b-4063-9c3b-ec89b7bf71bcn%40googlegroups.com
> .
>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/b330dbd0-add8-449c-b84e-41e4aa0398d9n%40googlegroups.com.

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

Re: Documentation for ODT output

[MarLinn]

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

I am the author of the ODT reader, so I might be able to help.

The short answer to your examples is this: there is no simple markup.

OpenDocument files split structure and styling into two parts. Either 
into two separate parts in one stand-alone XML or into two separate XML 
files in the ODT zip. "Centring something" is part of the styling in 
this model.

So if you want to centre something in a filter, here's roughly what you 
need to do:

  * Create your own template based on the default template
  * In that template, create a custom style that looks the way you want,
    including centring.
  * In the filter, create your elements and simply apply your custom
    style to them.

This gets more fun with images because images are floating elements, 
possibly in a frame. One of the simpler ways to style them is with the 
same approach via "frame styles". That doesn't sound surprising, 
considering the names, but frame styles are not the best-known feature 
of ODT.

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/9dd3c5be-dbcd-158f-8943-2bada99f6de6%40gmail.com.

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

Re: Documentation for ODT output

[Stephan Boltzmann]

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

Thanks a lot for your hint about the templates, which helped me to adjust
the output the way I wanted.
I was just too much focused on fixing the layout by programming that I
hadn't thought about other possibilities.
Using templates is actually pretty powerful, although I wouldn't have
thought so in the first place.

Am Mo., 14. Dez. 2020 um 22:23 Uhr schrieb MarLinn <monkleyon-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>:

> I am the author of the ODT reader, so I might be able to help.
>
> The short answer to your examples is this: there is no simple markup.
>
> OpenDocument files split structure and styling into two parts. Either into
> two separate parts in one stand-alone XML or into two separate XML files in
> the ODT zip. "Centring something" is part of the styling in this model.
>
> So if you want to centre something in a filter, here's roughly what you
> need to do:
>
>    - Create your own template based on the default template
>    - In that template, create a custom style that looks the way you want,
>    including centring.
>    - In the filter, create your elements and simply apply your custom
>    style to them.
>
> This gets more fun with images because images are floating elements,
> possibly in a frame. One of the simpler ways to style them is with the same
> approach via "frame styles". That doesn't sound surprising, considering the
> names, but frame styles are not the best-known feature of ODT.
>
> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pandoc-discuss/9dd3c5be-dbcd-158f-8943-2bada99f6de6%40gmail.com
> <https://groups.google.com/d/msgid/pandoc-discuss/9dd3c5be-dbcd-158f-8943-2bada99f6de6%40gmail.com?utm_medium=email&utm_source=footer>
> .
>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CAN6NU2wOt4bqChEUzDZ9bqpVr7OTVXtgPxcYg0XjxiygogYO1Q%40mail.gmail.com.

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