Skip to main content

Digital History, Digital Archaeology, Simulations, Games, AR, Romans. Method & Theory.

Guiding the MA in Digital Humanities 2015/2016 Programme at Carleton University


An Open Notebook

2 min read

There might be times when having an open online notebook for a digital humanities project makes a lot of sense. Tonight, I came across another static site generator that turns your folder of markdown files into a searchable wiki-style site, with rss feeds (rss is a way of piping all of your content out of your site so that it can be resused in different ways. For instance, you could create a twitter robot - yes, you can! - that tweets every time your site is updated with new content, tweeting links to the specific pieces. Originally, RSS was a way of reading in one place all of your favourite content by 'subscribing' to various websites' feeds).

But I digress.

I've written it all up over on my research blog , a slightly more complicated combination of notetaking and website making. The simple version:

The site generator is called 'Pykwiki': . In essence, once it's installed, you put all of your md files in the 'source' folder. Then, you give the command:

pykwiki cache

Your totally functional website will be generated in the 'docroot' folder. To put the site online, you'd just move those files into a github repository (or put it on your own server, if you have one) on a gh-pages branch. 

Ta da! 

(You'll have to look up how to make a gh-pages branch :)