personal_site/README.md
2025-05-30 10:33:06 +02:00

37 lines
1.6 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Generates my personal website.
## Installing Ruby
You probably want to run ruby from a version manager like `chruby`, see [here](https://jekyllrb.com/docs/installation/macos/).
## Changes checklist
A list of things to check once in a while to make sure I haven't broken them inadvertently.
- Mobile and web layouts looks ok.
- Dark mode and light mode both look ok.
- OG tags render nicely, use https://www.opengraph.xyz/
- Check the rss feed https://validator.w3.org/feed/check.cgi?url=https%3A%2F%2Fthomashodson.com%2Ffeed.xml
## Todo
- consider [glsify](https://github.com/glslify/glslify) for loading shader code
- add svgo https://github.com/svg/svgo
- Figure out a JS bundling script so that I don't have to include node_modules in the deployed site
- change the OG image used for the landing page so it's not just my face.
- add humans.txt https://humanstxt.org/
- fix the OG tags so that https://cards-dev.twitter.com/validator works
- consider switching to using pandoc as a markdown renderer
- make the light dark mode toggle work without js
- make sure the above works with the thesis section, will probably require stripping the html tag.
- add json-ld metadata https://csvbase.com/blog/13
## Validators
- [blacklight](https://themarkup.org/blacklight)
- https://lens.rknight.me/
## Notes
[Installation](https://jekyllrb.com/docs/installation/macos/)
`bundle install`
Then
Use `./run.sh` to do local development of this site
## Past and future inspirations
[Blog Microfeatures](https://danilafe.com/blog/blog_microfeatures/)
[Nice code blocks](https://staniks.github.io/articles/serious-engine-networking-analysis#overview)