rogernoden.github.io

Roger's blog hosted at https://rogernoden.com

You'll need a GitHub token for certain functionality

• Generate a personal access token with public_repo permissions
• Use that token to set the JEKYLL_GITHUB_TOKEN environment variable

This will allow the jekyll-github-metadata plugin to perform as expected and make things like edit links and the contributors page work correctly.

To Run

Install ruby, ruby devkit

• gem install bundler

cd to the project's root

• bundle install
• bundle exec jekyll serve should build the site and serve it at http://localhost:4000 --incremental.

For future posts, you can build with

• bundle exec jekyll serve --future true --incremental

To Run Checks Locally

For my own reference because I often forget how. 😄

Linting

• npm install -g markdownlint-cli
• Go to the root directory
• markdownlint _posts

Spellcheck

• npm install -g cspell
• cspell _posts/**/*.md