Making Pages

General workflow:

  1. Head to GitHub and login to your account.
  2. Follow along with the basic set up at GitHub’s documentation for User/Organization Pages development
    • Leave your new repository open, as we’ll clone it in the near future.
  3. Check if you have Ruby installed on your computer by opening a terminal and typing: ruby -v
    1. If you see a version listing of 2.4.0 or greater, then continue. If it’s lower than 2.4.0 than you can upgrade it (doubt this will come up, but stop me if so).
    2. If you get an error, than you must install Ruby development environment:
      1. Windows Installers - Pick the version that has a bold link (newest and most compatible)
        • Confirm it worked by running ruby -v in GitBash terminal (Press Windows-Key then search for git-bash.exe)
      2. Mac installation:
        • Enter these commands into terminal:
         # First, you need to install the command-line tools to be able to compile native extensions, open a terminal and run:
         xcode-select --install
                    
         # Install Homebrew
         /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
         # Install Ruby via Homebrew
         brew install ruby
        
         # Add the brew ruby path to your shell config
         export PATH=/usr/local/opt/ruby/bin:$PATH
        
         # Check to make sure everything installed correctly
         which ruby
         # Should see something like:
         # /usr/local/opt/ruby/bin/ruby
        
         ruby -v
         # Should see something like:
         # ruby 2.6.2p47 (2019-03-13 revision 67232) [x86_64-darwin18]
        
      3. Linux (Ubuntu) installation:
        • Enter these commands into terminal:
         echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
         echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
         echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
         source ~/.bashrc
        
  4. Install Jekyll
    1. Windows: in GitBash terminal (Press Windows-Key then search for git-bash.exe),
    2. Mac: in terminal,
    3. Linux: in terminal,
      • Enter the following command: gem install jekyll bundler
  5. If you’re not sure how to clone a repo, check this page out for quick rundown: GitHub Cloning tutorial
  6. Clone your website repository from GitHub by issuing the command in you command line: git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY
  7. You now have a fully functional website repo, now let’s dig in!
  8. Setting up a local Jeckyll website

Invaluable resources:

  1. GitHub guide to creating GitHub Pages with Jekyll
  2. Markdown Cheatsheet