x157.github.io

This is the source for x157.github.io

This site uses:

Preferred Editor

I'm a JetBrains fanboi. I edit this repository with:

Local Testing

I'm now able to locally test x157.github.io on my Windows workstation thanks to WSL. It's amazing to have Linux on Windows. Thanks WSL!

To set it up, follow the steps below. For additional reading, consider: Testing your GitHub Pages site locally with Jekyll

Set up WSL - Windows Linux Subsystem

Install Jekyll

  • requires Ruby:
    • install rbenv
    • install ruby + headers (required)
    sudo apt install rbenv
    sudo apt install ruby-dev
  • requires github-pages gem
    • to install:
      gem install github-pages
      gem install jekyll-theme-hacker
    • Update these gems whenever you get out of sync with Github
      gem update github-pages jekyll-theme-hacker

Clone this repo

  • Repo MUST BE:
    • Owned by your Linux user
    • On your Linux filesystem
  • Must initialize it the first time:
    git clone https://github.com/x157/x157.github.io
    cd x157.github.io
    ./script/bootstrap
    • While bootstrap fails, find + fix errors + try again.

View your local copy

cd x157.github.io
bundle exec jekyll serve
  • Open browser to http://localhost:4000
  • Notice: You may need to restart Jekyll each time you save a file in order to see the change.
    • If so, try jekyll serve --livereload