x157.github.io

This is the source for x157.github.io

This site uses:

• Jekyll
• Jekyll Sitemap Plugin
• the Hacker GitHub Pages theme

Preferred Editor

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

• IntelliJ IDEA
  • Plugin: Liquid
  • Plugin: Markdown
  • Plugin: Ruby
  • Plugin: YAML

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 WSL - Linux on Windows
• requires Reboot

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