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

37 lines
1.6 KiB
Markdown
Raw Permalink 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)