Documenter.jl: Export to other formats
It would be useful for Documenter to export to forgets other than HTML. Is this currently possible? If not, is there any quick workaround, for example to an intermediate form and then pandoc?
The particular year case I see is to make it easy to build an epub of the Julia documentation. I prefer this for anything that doesn't jump around too much, and I suspect it could be if interest to other users as well.
cscherrer
All 2 comments
Documenter can also export Markdown and LaTeX (which gets compiled to PDF right away). See also _Other Output Formats_ in the manual. The Markdown output can perhaps be used with pandoc.
To properly support e.g. EPUB (see also #371), a separate Writer plugin could be created as a package. Although, Documenter's internal representation of the document is not that plugin-friendly at the moment.
mortenpi
on 16 Dec 2018
Thanks @mortenpi. I was able to hack this together like so:
- Export Markdown, as you suggest. This required setting
strict=falsein themakedocsfunction - Build a separate text file containing the filenames from
PAGES(no no other structural information from that value) cat pages | xargs pandoc -o julia.epub
The result was viewable in Calibre, but I had to tweak things a bit (convert to .kepub) before it would load on my Kobo. I have no idea why that would be, and suspect I just messed up part of the sequence the first time through.
cscherrer
on 16 Dec 2018
Related issues
Datseris
路
4Comments
denizyuret
路
6Comments
carlobaldassi
路
5Comments
SimonEnsemble
路
3Comments
dkarrasch
路
5Comments
Most helpful comment
Thanks @mortenpi. I was able to hack this together like so:
strict=falsein themakedocsfunctionPAGES(no no other structural information from that value)cat pages | xargs pandoc -o julia.epubThe result was viewable in Calibre, but I had to tweak things a bit (convert to .kepub) before it would load on my Kobo. I have no idea why that would be, and suspect I just messed up part of the sequence the first time through.