Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

CoolAJ86 on Github

branch: master
README.md

Jekyll-aid

Jekyll, the ruby-based blog-aware site builder has no default setup.

Jekyll-aid provides a nice "template" for a Jekyll-based site.

  • Disqus Comments
  • Google Analytics
  • categories for posts (in a tag-like fashion)
  • plays well with subdirectories

Usage

Add Jekyll-aid to your Jekyll-blog.

git remote add jekyll-aid git://github.com/coolaj86/jekyll-aid.git
git pull jekyll-aid gh-pages

You will have conflicts if you already had any content.

git mergetool
git checkout --ours ./path/to/file
git checkout --theirs ./path/to/file

git commit -a -m "now using jekyll-aid"

You Jekyll-aid!

./mkdocument 'Title of my Awesome-blog post!!!'
  • creates _posts/2010-10-14-title-of-my-awesome-blog-post.md
  • create link edit/title-of-my-awesome-blog-post.md
  • adds created_at timestamp
  • creates UUID (for disqus comments)
  • adds to unfinished category

Prepare

Accounts you'll need:

Files to edit:

  • all.html -- change the title
  • index.html -- change the title
  • _layouts/default.html -- replace ___YOUR_ID_HERE___ and ___YOUR_UA_HERE with your disqus id and google analytics id
  • _layouts/article.html -- replace ___YOUR_ID_HERE___ with your disqus id
  • _config.yml
    • change the destination
    • url_root to /your/subpath
  • CNAME -- if you're hosting on github and have a custom domain, enter it here (without the www prefix)

TODO

  • ./editdocument edit/title-of....

    • updates updated_at date automagically
  • join forces with / steal ideas from Jekyll-base

    • use jekyll-base format for url_root, ga_id, google_ajax_search in _config.yml
  • Post about this to the Jekyll mailing list

Something went wrong with that request. Please try again.