https://traceypooh.github.io/slides/dweb-2022 (tracey talk at https://dwebcamp.org)
Site live at:
- Whenever you create or delete a post, we want your
sitemap
updated. - Whenever someone comments on your site, we run a small script.
Thus, we suggest you use our "pre commit" and "post merge" git
'hooks' to automate the above "housekeeping". You can set them up like this:
git config --local core.hooksPath bin/
If you'd like a RSS index.xml
file generated with the bin/sitemap script,
during each "pre commit" hook (above), you'll need to have the
yq script installed on your machine.
- /2022/01/i-baked-a-pie/
- /2022/01/i-baked-a-pie/index.html
- start with front matter
- including
comment: <script src="../theme.js" type="module" charset="utf-8"></script>
- including
- you can then have the nice url
https://example.com/2022/01/i-baked-a-pie/
where the included JS transforms the markdown to markup
- start with front matter
- your
/sitemap.xml
can reference each of your directory urls - manage your
/sitemap.xml
manually or run the/bin/sitemap
script any time your create or delete a post. The/bin/sitemap
script can be found on the blogtini website. - have
/theme.js
do animport
of whatever theme you desire
- /2022/01/i-baked-a-pie.md
jekyll
will automatically transform your markdown to markup and to an url likehttps://example.com/2022/01/i-baked-a-pie.html
- tracey is working with
jekyll
to get https://example.com/2022/01/i-baked-a-pie.md urls to also get copied in verbatim from your source -- so the original markdown with front matter can be used and parsed
safari
is nice, you can run the site locally by just
- Developer Tools enabled
Develop
menu- check
Disable Cross-Origin Restrictions
during development - reload html page
- uncheck
Disable Cross-Origin Restrictions
when done
- check
- example: file:///Users/tracey/dev/blogtini/index.html
(any basic static file webserver will do):
( sleep 3; open http://localhost:8000 ) &
python3 -m http.server
You can force a re-parse of posts & pages by adding optional CGI arg ?recache=1
If you use https://github.com or https://gitlab.com free 'Pages' integration, you will get urls you can like this:
You can choose to use your own domain name (typically ~$20 USD/year) for a shorter/nicer url that points to the Pages deployment above (this is what https://blogtini.com does)
git grep xxxxx
highest prioritiesgit grep xxx