Recent searches
Search options
After trying to use #mdbook for in-project #documentation, I decided that I'm using it wrong.
I want the docs to be readable both from git browsers and generated HTML. mdbook does that by converting ".md" to ".html" in links.
But then, I have a couple of .md files that should be linked but don't need to be in the index, like "COPYING.md". I don't think mdbook can do that.
I have to modify selected links (to source documentation), and it's a miss here too.
mdbook is really for books.
I'm considering if I should throw away the awful sed scripts to modify markdown links and replace them with my homegrown static site generator (I already use it for my #blog .
Not sure which would be worse to maintain.