twardoch / mkdocs-combine

Convert an MkDocs Markdown source site to a single Markdown document
https://twardoch.github.io/mkdocs-combine/
Apache License 2.0
38 stars 17 forks source link

Empty output .pd #13

Open mightypanda opened 6 years ago

mightypanda commented 6 years ago

Hello, I am using mkdocs and mkdocs-combine in a Windows Bash shell, everything works well for mkdocs serve and build, as well as mkdocs-combine pip installation with pandoc. When i run mkdocs-combine i get an emtpy .pd file without any warning or notices. Is there a way to have debug info? Attached is the whole mkdocs project folder, consisting in a very minimal test site.

Thank you! mydocs.zip

altitude1326 commented 6 years ago

Same problem on mac, it does not process correctly mkdocs.yml pages hierarchy. It produces a pandoc file with only the uppermost sections.

twardoch commented 6 years ago

Since a few months ago, MkDocs introduced the ability to write plugins, I'm going to adopt this code

https://github.com/shauser/mkdocs-pdf-export-plugin

to replace mkdocs-combine. MkDocs plugins give a much greater reliability that everything is really processed the way it should be.

altitude1326 commented 6 years ago

Thank you @twardoch ! It work like a charm but create one pdf per markdown.

twardoch commented 6 years ago

Yeah, it needs to be adapted but it shows the principle well enough. I'll need to revisit it but if the code works as an MkDocs plugin then it'll have access to the same document tree as MkDocs proper, so combining it shouldn't be a problem. I still plan to just output one large Markdown file but it'll be more reliable, and possibly deal correctly with in-page links, something that the current code could never properly achieve.