This site is build with Jeykll and hosted on GitHub Pages -- pushing the main branch will update the website.
- Check out this repo with
git clone
to your local computer. - Create a file in the
_posts
directory. The format of the file name is important! It should beYYYY-MM-DD-first-few-words-or-desc-of-post.md
. The date is the date that the blog post should appear to have been published on. - Add the following Jekyll "front matter" to the top of your new markdown file:
---
layout: post
title: This is the Title of Your Blog Post
tags: ready
---
- On the next empty line, compose your post. You can use Markdown tags like
**bold**
or even raw HTML. - Follow the steps in the rest of this README for local previewing ("Local development") and deployment of your post.
Install Ruby and then run:
gem install bundler
bundle
Note: the website integrates two other repos, which are each GitHub Pages themselves. They're built individually and then automatically available under the same domain.
If you want to make changes to those, work directly in these separate repos:
To run the site:
bundle exec jekyll serve
point your browser at: http://localhost:4000/
The website is automatically deployed upon changes merged to main. See GitHub documentation for more information.