Re:Show HN: Turn markdown files into a beautiful documentati...
by sudosushi on Monday April 04, 2016 @11:01AM
(#11422362)
Interesting project, but any reason you went for a nodejs build of jekyll? Jekyll doesn't require sudo for npm, doesn't require dependences, like nodejs in the first place, and would require very little setup. Even something like octopress could have been used better here.
[ Parent
| on HN ]
Re:Show HN: Turn markdown files into a beautiful documentati...
by 0942v8653 on Monday April 04, 2016 @04:18PM
(#11425191)
> Jekyll [...] doesn't require dependences
What? Doesn't it need Ruby and a bunch of gems? (I have been unable to install it on Windows/msys2 properly because a dependency's native extensions won't compile, so if there's an easier way I would like to know.)
Edit: or are you talking about serving the static, generated site? If so, nevermind.
Re:Show HN: Turn markdown files into a beautiful documentati...
by sidi on Monday April 04, 2016 @11:13AM
(#11422483)
Jekyll is a general purpose site generator, docbase is specific for generating documentation sites. It can show github contributors on a page, allow collaborative editing, create an offline search index, support docs versioning and so on.
Creating beautiful documentation is hard, and there are tons of things we don't do yet.