Show HN: Docup – single-page documentation for your open source projects(docup.now.sh)
docup.now.sh
Show HN: Docup – single-page documentation for your open source projects
https://docup.now.sh/
6 comments
That command is essentially what I mean by "prerender".
I will add this feature to docup later, for people who want to have a static html file instead.
I will add this feature to docup later, for people who want to have a static html file instead.
So why all that extra work when in the end the only feature of Docup that would be used is the CSS which could also just be fed into pandoc?
First it's for people who don't want a build step, but they can prerender if they want.
And it does more than adding some CSS, JavaScript is also used for interactions.
And it does more than adding some CSS, JavaScript is also used for interactions.
Except that you (and everyone in your team/contributor) needs to have pandoc installed when updating the docs. I wrote mdwiki (http://mdwiki.info) ages ago to exactly avoid this.
How will it cope when content starts to grow? It will require a massive single request to fetch the content and then JS will have to build the interface.
Like other commented, better split pages and prefer pre-rendering. Documentation is something I usually need immediately and I really don't care how pretty it looks.
Like other commented, better split pages and prefer pre-rendering. Documentation is something I usually need immediately and I really don't care how pretty it looks.
Yea this is my thought. Any sizable project will have enough documentation to make this one page approach unwieldy IMO. MkDocs Material is all I'll ever need for documentation. https://squidfunk.github.io/mkdocs-material/getting-started/
[deleted]
works pretty well for lodash. https://lodash.com/docs/4.17.15
it's indeed a problem for large-scale docs, that's why I have another solution here https://docute.org/
Very nice. In a similar vein, I've used https://ricostacruz.com/flatdoc/ before, which is a bit more full featured and includes support for code samples.
Nice! this one is also quite good https://docsify.js.org/#/
Out of curiosity, is it search engine crawlable?
This one command does just that and you don't have to "prerender" your pages in an "additional build step" as suggested in the other comment.
pandoc -f markdown -t html5 -o output.html input.md -c style.css