Why not make my first post be a description of how I put together this website? It will help me when I come back and wonder what I did.
My overall goals are to:
- host it on github
- don’t hard code it in html/css/js
- have it look a little cool
- make a website that has my picture, info, and a blog
The github part is quite easy, I just made a repo named
and placed an
index.html file in it.
After making the repo all I had to do was:
This made the address https://ianbriggs.github.io/ look like this:
Yay! I have a website on github. Let’s move on to using jekyll.
Static site generator
I am loosely following the github guide for using jekyll. So I am making this on a Mac, which means when I try to install jekyll using gem it errors out due to permissions.
I could run it with
sudo, but I have destroyed enough systems to have a
pathological fear of the power given by that particular command.
To get around this I use brew to get a non Apple ruby
install and then refresh my zsh environment:
Now when I call
gem it will give me the brewed one.
Onward to victory!
With that out off the way I can install jekyll and build an example website.
Now github will magically build the website for me, which takes a little while.
Note: I stopped following the guide at this point and had to come back here.
The website still builds, but I would like it to use github’s gems.
To do this I commented out the
gem "jekyll" line, uncommented the line with
gem "github-pages", then added
My shiny new statically generated website looks like this:
That is good for when I want to deploy, I can push and have the system build and
update, but not so good for playing around.
For that I need my local machine setup to run it, first I add
I’m running Ruby newer than 3.0.
Github has a short list of approved themes.
For now I will chose one and cross my fingers that it works.
It seems like the best thing to do is download
minima and modify things.
I moved over
To get rid of the RSS button I commented out the section of
I’ll have to come back to this later to customize the look, since CSS is not my
Moving onto adding my information.
Changing the defaults looks to be as easy as editing
After editing I relaunch
bundle exec jekyll serve to see the updates locally.
For some reason this is one of the few files that don’t automatically get
updated when running the server.
I don’t really want a seperate “About” page, so I will remove
just put that information in
- I’ve renamed all
- I place images in
assets/then can display them in here via the markdown
![<description>](/assets/<image>). The leading slash is important.
- For more control the images can be placed using html.