5 ms·

OT, but what is the best static site generator for mostly standalone pages except Jekyll (which broke Netlify)?

imron 9y ago
Hugo!
bachmeier 9y ago
I don't want to get into any arguments about "best", but what works best for me is to write the pages in Markdown and use a Makefile to convert them all to html. There's always overhead with projects like Hugo, concerns about upgrading, and rough edges with respect to customization. If you just want to create standalone pages, a Makefile and Pandoc is about as simple and flexible as you can get. Edit: Here's the full code from one of my Makefiles: files := $(patsubst %.md,%,$(wildcard *.md)) all: for f in $(files); do \ pandoc -s -o $$f.html --template=template.html $$f.md; \ done
- Scarbutt 9y ago
  Does that template.html has some css links? if so, is that something that comes with pandoc?
  - bachmeier 9y ago
    It's a modification of the default Pandoc template. I add css to it directly, but it can load css files if you wish. Think of it like this - there's a $body$ statement in the middle of the template. The html generated by Pandoc goes there. Everything else in the template file stays there. You can view the Pandoc html5 default here: https://github.com/jgm/pandoc/blob/master/data/templates/default.html5 https://github.com/jgm/pandoc/blob/master/data/templates/def...
- ubercow 9y ago
  If you want something a little more involved, https://jaspervdj.be/hakyll/ https://jaspervdj.be/hakyll/ is a static site generator that uses pandoc under the hood. Uses a Haskell DSL
bobfunk 9y ago
Jekyll works well with Netlify - you might just have needed a Gemfile or the like?
- tyteen4a03 9y ago
  Under very specific circumstances my standard build setup, which works on my machine, their machine and one of their website plans, fails on another plan - some pathing issues I think. They gave me the Docker image to debug but it's useless because without sudo access, I can't do anything useful.
fiatjaf 9y ago
My https://github.com/fiatjaf/react-site https://github.com/fiatjaf/react-site is imperative instead of declarative, maybe that will suit you. By that I mean you write generator script[1] and use the helper functions `listFiles`, `generatePage` and `copyStatic` to generate the pages you want with the template/configuration you want at the path you want. That means you can render content not only markdown files, but any source whatsoever, and combine the sources in any way you like. [1]: https://github.com/fiatjaf/levypla/blob/1407b110228387e4a4b764c35439328ce4c4181b/generate.js#L4 https://github.com/fiatjaf/levypla/blob/1407b110228387e4a4b7...
Per_Bothner 9y ago
I use ikiwiki (https://ikiwiki.info/ https://ikiwiki.info/) for my blog (http://per.bothner.com/blog http://per.bothner.com/blog).
sandGorgon 9y ago
Hugo is a single binary that works on Linux, windows and osx. That's a godsend compared to setting up Jekyll - which needs you to setup ruby and then install all dependencies. It is also many times faster than Jekyll. Both were the reason,we chose Hugo.

Hugo!

I don't want to get into any arguments about "best", but what works best for me is to write the pages in Markdown and use a Makefile to convert them all to html. There's always overhead with projects like Hugo, concerns about upgrading, and rough edges with respect to customization. If you just want to create standalone pages, a Makefile and Pandoc is about as simple and flexible as you can get. Edit: Here's the full code from one of my Makefiles: files := $(patsubst %.md,%,$(wildcard *.md)) all: for f in $(files); do \ pandoc -s -o $$f.html --template=template.html $$f.md; \ done

Scarbutt 9y ago
Does that template.html has some css links? if so, is that something that comes with pandoc?
- bachmeier 9y ago
  It's a modification of the default Pandoc template. I add css to it directly, but it can load css files if you wish. Think of it like this - there's a $body$ statement in the middle of the template. The html generated by Pandoc goes there. Everything else in the template file stays there. You can view the Pandoc html5 default here: https://github.com/jgm/pandoc/blob/master/data/templates/default.html5 https://github.com/jgm/pandoc/blob/master/data/templates/def...
ubercow 9y ago
If you want something a little more involved, https://jaspervdj.be/hakyll/ https://jaspervdj.be/hakyll/ is a static site generator that uses pandoc under the hood. Uses a Haskell DSL

bobfunk 9y ago

Jekyll works well with Netlify - you might just have needed a Gemfile or the like?

tyteen4a03 9y ago
Under very specific circumstances my standard build setup, which works on my machine, their machine and one of their website plans, fails on another plan - some pathing issues I think. They gave me the Docker image to debug but it's useless because without sudo access, I can't do anything useful.

fiatjaf 9y ago

My https://github.com/fiatjaf/react-site https://github.com/fiatjaf/react-site is imperative instead of declarative, maybe that will suit you. By that I mean you write generator script[1] and use the helper functions `listFiles`, `generatePage` and `copyStatic` to generate the pages you want with the template/configuration you want at the path you want. That means you can render content not only markdown files, but any source whatsoever, and combine the sources in any way you like. [1]: https://github.com/fiatjaf/levypla/blob/1407b110228387e4a4b764c35439328ce4c4181b/generate.js#L4 https://github.com/fiatjaf/levypla/blob/1407b110228387e4a4b7...

Per_Bothner 9y ago

I use ikiwiki (https://ikiwiki.info/ https://ikiwiki.info/) for my blog (http://per.bothner.com/blog http://per.bothner.com/blog).

sandGorgon 9y ago

Hugo is a single binary that works on Linux, windows and osx. That's a godsend compared to setting up Jekyll - which needs you to setup ruby and then install all dependencies. It is also many times faster than Jekyll. Both were the reason,we chose Hugo.