This is a super simple static site blog based on:
https://docs.github.com/en/pages/quickstart
This site uses Jekyll and GitHub Pages. While GitHub Pages uses Ruby 3.3.4 in production, locally we're using Ruby 3.3.0 which works fine for development.
- Ruby 3.3.0 (install via your preferred version manager)
- Bundler
cd to directroy root: cd /Users/mattsly/Sites/GitHub/mattsly.github.io
bundle
bundle exec jekyll serve
it will starting running at http://127.0.0.1:4000
On deploy, it will automatically publish to https://mattsly.github.io/mattsly.com/
Domain configuration is in the repo settings on GitHub
For now, I'm just committing everything to main. Once it's pushed to GitHub it will automatically deploy. namecheap.com is where the domain is registered and the DNS is set up (previously mattsly.com was hosted on S3)
To override a Jekyll theme default, copy the related file from the gem to the corresponding directory (this is what I've done for layouts/home and includes/footer)
To find the defaults run bundle info --path minima
...and then open in Finder and copy to the same path in this repo
- Verify domain here: https://github.com/settings/pages
- Need to use https://github.com/mattsly/mattsly.github.io - which is set up at the root of mattsly.github.io (originally I created a new project for mattsly.com which was serving at mattsly.github.io/mattsly.com - i.e. repo name...)
- All external links automatically open in a new tab thanks to the
jekyll-target-blankplugin - To add new posts, create markdown files in the
_postsdirectory following the naming conventionYYYY-MM-DD-title.md - Images should be placed in the
/assets/directory
https://www.markdownguide.org/cheat-sheet/
bold text
italicized text
blockquote
- First item
- Second item
- Third item
- First item
- Second item
- Third item
code