Home Blog CV Projects Patterns Notes Book Colophon Search

GitHub Pages

4 Feb, 2017

Set up an SSH key and a repo.

ssh-keygen -t rsa -b 4096 -C "james@exmaple.com"
# Choose jimmyg as the key name and add a password
mv jimmyg ~/.ssh/
mv jimmyg.pub ~/.ssh/
ssh-add ~/.ssh/jimmyg
cat ~/.ssh/jimmg.pub

Add the key in the GitHub settings.

Then for an ordinary repo at a path:

git init
git checkout -b gh-pages
git add .
git rm -r --cached .well-known/acme-challenge/
git status
git commit -m "Current"
git remote add origin git@github.com:thejimmyg/datacanspeak-site.git
git push origin gh-pages

Visit the site at https://thejimmyg.github.io/datacanspeak-site/

Then add a meta redirect template from the old site.

For a main organisation site:

git init
git add .
git rm -r --cached .well-known/acme-challenge/
git status
git commit -m "Current"
git remote add origin git@github.com:datacanspeak/datacanspeak.github.io.git
git push -u origin master

Then set the site custom domain to datacanspeak.com in the repo settings.

Make sure your A records are set up like this:

$ dig +noall +answer datacanspeak.com
;datacanspeak.com.
datacanspeak.com. 73 IN A 192.30.252.153
datacanspeak.com. 73 IN A 192.30.252.154

Then you should be all sorted!