kwangkim / fibo.github.io

My digital copybook

My digital copybook

This is my web book! Gianluca Casati writes here :)

Domain

The domain for this site is g14n.info registered on namecheap; thanks to CloudFlare it is a naked domain and has SSL: both http and https schemes are available.

Debug

It is highly recommended to install Jekyll to preview your site and avoid build errors before publishing it.

Install Jekyll

Instructions work great on a Codio box like this.

1. Create a Gemfile with the following content

source 'https://rubygems.org'
gem 'github-pages'

2. Add these lines to your .gitignore

_site/
.codio
Gemfile*

3. Install bundler

gem install bundler

4. Install dependencies

bundle install

See Using Jekyll with Pages as a reference.

Run Jekyll

Test content generation running

jekyll serve --watch

Static content is served here.

Readme driven development

Inspired by Tom Preston's article documentation about my projects is contained in their README.md file.

Get repo foo.

$ mkdir -p _projects/_repos/foo
$ git clone https://github.com/fibo/foo _projects/_repos/foo

Store YAML front matter in a separate homonym .yaml file, which is ignored by Jekyll.

---
title: foo
layout: project
---

Concatenate README.md and its YAML front matter into foo/index.md

cat _projects/foo/index.yaml _projects/_repos/foo/README.md >> _projects/foo/index.md