Hacker News new | ask | show | jobs
by drew-y 3251 days ago
Looks great! One thing that would be nice would be the ability for Raneto to act as a static Docs generator. Looks like you have to use nodejs as the server as it stands. I'd like to be able to use a simple static http-server.
3 comments

I've been using Phenomic https://phenomic.io for my personal site https://www.aizatto.com
It looks like something that could be handled just as well using Heckle by Marijn Haverbeke. It reads content and layouts from a Jekyll-like directory structure. Naturally, it uses CodeMirror for syntax highlighting.

http://marijnhaverbeke.nl/blog/heckle.html

There are loads of options for static site generators (here[0] is a good list of ~200), but it doesn't solve all problems. One question, for example, is how to get search functionality.

[0] https://www.staticgen.com/

Yeah that be a great addition
Hugo with a theme like docdock is pretty neat (http://gohugo.io/ & http://docdock.netlify.com/)
how would you add a new post (for a blog) edit a file, and upload it to the site?
What works for me with Hugo (because I'm already using these tools all day anyway) is to keep the site in a Github repository.

Then when I make a change it triggers TravisCI to do a full site rebuild. (Takes longer to install Hugo than to actually run it)

Then once it's built, Travis has built in support for uploading to S3, and away we go.

Doesn't work for everyone, but it's really smooth and simple for me, I can even just go to Github, create a new page, and save it right there from the site. Which means I can edit from any device I want.

Netlify CMS can be a good choice if you are looking for admin section, it nicely integrates with GitHub.