Original "super minimal recipe website" by Jeff Thompson and then modified by kvpsky to be used with GitHub Pages, then slightly tweaked be me and deployed via Netlify. Credit also to AN0DA.
Other examples:
- Original - https://jeffreythompson.org/recipes/
- GitHub Pages - https://kvpsky.github.io/Recipes-GHPages
Add markdown files to the recipes folder. You can copy an existing recipe or use template.md
as a guide.
# runs the build script, then starts a simple python http server
$ ./serve.sh
You have to cancel and restart the script to rebuild and see changes.
It's also a good idea to open up the developer console and make sure there are no hidden errors loading content.
The original website was a php website that dynamically generated pages from the markdown in the recipes folder. It was cleverly converted by kvpsky into an html site with some javascript modifications and the addition of the generate.py
script. This eliminates the need for server-side php and allows the site to be published as a static site with tools like GitHub Pages or Netlify.
Steps taken from A Step-by-Step Guide: Deploying on Netlify:
- Log into Netlify and select
New Site from Git
- Select GitHub, Authorize Netlify, select the repo, and point to the main repo
- Configure Your Settings (the important part)
- Build command:
python3 generate.py
- Publish directory:
build
- Build command:
That should be it assuming there are no errors with the build. It will rebuild every time you push to main.
If you did not purchase your domain with Netlify, you'll need to log into your domain registrar's website and point your domain's DNS nameservers to Netlify. You can find the Netlify nameservers in the DNS settings menu of the site you just setup. It might take awhile when you first set it up (24 hours to full propagate). Netlify will also give you an SSL/TLS certificate for free (made possible by Let's Encrypt).