No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_includes
_layouts
_sass
css
github/_posts
.gitignore
CNAME
Gemfile
Gemfile.lock
README.md
_config.yml
favicon.ico
favicon.png
github-sync.rb
index.html
serve.sh

README.md

page title tags date
Github Pages with README Sync
github pages jekyll ruby
2016-05-02

idle.run

This website is designed to showcase interesting projects I'm working on which are hosted on Github.

The content of many posts on this site are synced from the README.md for the project repositories.

github-sync.rb

A custom Ruby script which does the following

  • Read the Jekyll site _config.yml to get my github username
  • Use the github API to list my public repositories
  • Sync the README.md from each repository to github/_posts/{date}-{reponame}.md

Note: the github/_posts directory indicates a Jekyll category of 'github' containing posts

README.md Requirements

Each public repository will be checked for a README.md The README.md must start with YAML frontmatter like the following

---
title: "Order VS Chaos AI"
tags: c++ ai
date: 2016-05-01
---

Layout

The sync adds to the YAML frontmatter to set a reponame attribute for linking and a page layout of "repo". My repo layout is available here: repo.html

Github Pages

Github Pages is a wonderful free service which hosts either plain HTML or a Jekyll 3 site out of a github repo pages.github.com. More details about setting up with Jekyll here