Hacker Storytelling is my way for telling stories using the Internet, in a way that is open by default. Hacker Storytelling uses several tools to help me tell stories, that is completely stored and operating using Github.
There are several key technologies that I employ:
- Jekyll - Jekyll is a simple, blog aware, static site generator. It takes a template directory (representing the raw form of a website), runs it through Textile or Markdown and Liquid converters, and spits out a complete, static website.
- Mustache Templates - A simple way to render structured data from JSON files, using basic HTML templates for displaying--instead of pulling directly from database.
- Gists - Gist is a simple way to share snippets and pastes with others. All gists are git repositories, so they are automatically versioned, forkable and usable as a git repository.
These technologies provide a simple, client-side toolbox for telling stories using:
- Pages - Static HTML pages, using the Jekyll framework
- Blog - Chronological blog posts, using the Jekyll blog
- Data - Structured data lists and detail pages
- Presentations - Simple, flowing presentations
- Code - Code samples and snippets in Github Gists.
- Journeys - Static publishing of pages, using the prev / next format.
I'm looking to push the boundaries of how I use Github, and employ some unique approaches to running sites and applications on the social coding platform. I use this combination to drive my apps:
- master repo - I store the backend of applications in private github repositories.
- gh-pages repo - I store the public website for any project in the gh-pages repository.
- github api - I use the Github API to add, update, and manage pages, data, and other elemtents.
- oauth.io - I use OAuth.io to authenticate with the Github API, and manage application / project access.
These basic tools, plus the open, browser-based hosting environment introduced by Github, makes for a rich, online storytelling format. This new approach to storytelling is not just about words, Hacker Storytelling is about weaving in data and code, to make my stories richer and more meaningful.
You can see this in action, running the many different projects that make up the API Evangelist network of research. Everything runs as separate Github repositories, with individual subdomains for each project.