ODF backend for AsciiDoc ODF backend for AsciiDoc Professional documents Professional documents while keeping it simple while keeping it simple ODF Plugfest 2012, Brussels ODF Plugfest 2012, Brussels Dag Wieërs, [email protected] Dag Wieërs, [email protected]

Why AsciiDoc ? Why AsciiDoc ? ● It is plain text It is plain text ● Intuitive markup language Intuitive markup language ● Maps 1:1 to simplified DocBook Maps 1:1 to simplified DocBook ● Flexible to extend Flexible to extend

Why ODF ? Why ODF ? ● “ “The” The” O Open Source document standard pen Source document standard ● Can be easily converted to other formats Can be easily converted to other formats ● LibreOffice PDF output is superb ! LibreOffice PDF output is superb ! ● Visual styling using LibreOffice Visual styling using LibreOffice

How does it work ? How does it work ? ● Collaborate on Collaborate on content content (e.g. Git) (e.g. Git) ● Conversion to Flat ODF using AsciiDoc Conversion to Flat ODF using AsciiDoc ● Styling through LibreOffice Styling through LibreOffice ● Re-apply styles to future documents Re-apply styles to future documents

AsciiDoc-ODF functionality ! AsciiDoc-ODF functionality ! ● AsciiDoc features AsciiDoc features admonitions, blocks, captions, comments, admonitions, blocks, captions, comments, footnotes, table-of-content, themes footnotes, table-of-content, themes ● Filter integration Filter integration ascii-art, charts, mathml, plantuml, qrcode, ascii-art, charts, mathml, plantuml, qrcode, syntax highlighting syntax highlighting ● ODF functionality ODF functionality annotation, columns, covers, headers/footers, annotation, columns, covers, headers/footers, metadata metadata

Live demonstration ! Live demonstration !

Various ODF-related issues. Various ODF-related issues. ● Unspecified ODF-consumer behavior Unspecified ODF-consumer behavior – Images with only width or height Images with only width or height #23 #23 – Ordering of styles Ordering of styles #31 #31 – Standard naming of styles Standard naming of styles #5 #5 – Open and save rewrites styles Open and save rewrites styles

Various ODF-related issues.. Various ODF-related issues.. ● Issues in LibreOffice Issues in LibreOffice – Native SVG support Native SVG support #17 #17 → fixed → fixed – Crashes on incorrect ODF Crashes on incorrect ODF → fixed → fixed – Flat ODF integration Flat ODF integration #22 #22 → in progress → in progress – style:rel-width/rel-height bug style:rel-width/rel-height bug #23 #23 – Content/style pollution Content/style pollution #15 #15 – Open and save trashes output Open and save trashes output #28 #28 ● Other ODF-consumers ? Other ODF-consumers ?

Various ODF-related issues... Various ODF-related issues... ● Unsupported AsciiDoc constructs Unsupported AsciiDoc constructs – Admonitions Admonitions #12 #12 → abuse sections/columns → abuse sections/columns – Nested paragraphs Nested paragraphs #18 #18 → avoid → avoid – Reference label Reference label #14 #14 → abuse bookmarks → abuse bookmarks – Table styles Table styles #13 #13 → per cell is ” → per cell is ”horror horror” ” – Complex tables Complex tables → more “ → more “horror horror” ” – Pagebreaks Pagebreaks #10 #10 → only in paragrap → only in paragraphs hs

Various ODF-related issues.... Various ODF-related issues.... ● Validation using xmllint Validation using xmllint #19 #19 → fixed → fixed ● Lack of ODF support in 3rd party tools Lack of ODF support in 3rd party tools ● ODP is a whole different animal ODP is a whole different animal #30 #30

Your use-case is needed ! Your use-case is needed ! ● Join us at GitHub: Join us at GitHub: github.com/dagwieers/asciidoc-odf github.com/dagwieers/asciidoc-odf ● Discuss on the AsciiDoc list: Discuss on the AsciiDoc list: [email protected] [email protected] ● Tools mentioned in the presentation Tools mentioned in the presentation unoconv, pandoc, codiicsa, docbook2asciidoc unoconv, pandoc, codiicsa, docbook2asciidoc

Thank you for listening ! Thank you for listening !