Static Websites

Building a website from scratch can be onerous. Using a system like Wordpress or Squarespace etc can leave you locked in to someone else’s platform (and any security issues that might entail).

Here, we’re going to build a simple website that uses nothing but text files as its source; these text files will always be readable into the future, and you can also copy them to your own machine so that they’re always handy, ready to be transformed into something else.

I’m talking about static site building; there are many different generators out there that will take your text files, pump them through some templates, and spit out flat html on the other side. At The Programming Historian, there is a lesson by Amanda Visconti on using Jekyll and Github Pages to make a site; we’re going to do something much easier.

In essence, you are going to create a new repository in your Github account called your-username.github.io; you’re going to make a file in there called index.md and you’re going to write something in that file, eg,

## My Quick Static Site

This is a site I build with gh-pages. **Wow**

It reads [markdown](https://www.markdownguide.org/) and turns it into html.

![gif ftw](https://media.giphy.com/media/nXxOjZrbnbRxS/200w_d.gif)

Commit that file. Then, hit the gear wheel icon for the repo settings and scroll down to the Github Pages section. Github will run your text files through the Jekyll site builder for you; here you can select from some of their templates.

Boom! The full process is on this site with screenshots.

Customize your new site to be a ‘front page’ to all of your journal entries from these last few weeks.

Now, there’s a lot more to static websites than this. This course site is generated with Hugo; a site generator for building exhibitions, called ‘Wax’, is available here. (Speaking of exhibits, here’s information about building them with Omeka.net.)

What's on this Page