version 0.0.1

willyum · Jan 11, 2012 · 4c18e3c · 4c18e3c
commit 4c18e3c
Show file tree

Hide file tree

Showing 44 changed files with 2,558 additions and 0 deletions.
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,6 @@
+_site/*
+
+Thumbs.db
+.DS_Store
+
+!.gitkeep
diff --git a/404.html b/404.html
@@ -0,0 +1 @@
+Sorry this page does not exist =(
diff --git a/README.md b/README.md
@@ -0,0 +1,41 @@
+# Jekyll-Bootstrap
+
+This is a clean install of the core Jekyll Bootstrap framework you can clone and run your Jekyll blog with.
+
+Jekyll-bootstrap is the quickest and most hassle-free way to get your new Jekyll powered website up and running.
+100% compatible with GitHub pages.
+
+## Usage
+
+For all usage and documentation please see: <http://jekyllbootstrap.com>
+
+## Version
+
+0.0.1 - stable but not versioned.
+
+This version is stable and readily deployable to GitHub Pages and production Jekyll installs.
+However, please expect fast updates that are not backwards compatible with older installs.
+When development reaches 0.1.0, version compatibility between releases will be respected.
+
+## Development
+
+Development is active! 
+
+## Contributing 
+
+This repository tracks 2 projects:
+
+- **Jekyll-Bootstrap Framework.**  
+  The framework for which users should clone and build their blog on top of is available in the master branch.
+  Please fork and contribute additions to the framework itself here.
+
+- **Jekyll-Bootstrap Documentation Website.**    
+  The documentation website at <http://jekyllbootstrap.com> is maintained in the gh-pages branch.
+  Please fork and contribute documentation additions to this branch only.
+
+The master and gh-pages branch do not share the same ancestry. Please treat them as completely separate git repositories!
+
+
+## License
+
+[Creative Commons](http://creativecommons.org/licenses/by-nc-sa/3.0/)
diff --git a/Rakefile b/Rakefile
@@ -0,0 +1,29 @@
+require "rubygems"
+require 'rake'
+
+desc "Switch between Jekyll-bootstrap themes."
+task :switch_theme, :theme do |t, args|
+  theme_path = File.join(File.dirname(__FILE__), "_includes", "themes", args.theme)
+  layouts_path = File.join(File.dirname(__FILE__), "_layouts")
+
+  abort("rake aborted: './_includes/themes/#{args.theme}' directory not found.") unless Dir.exists?(theme_path)
+  abort("rake aborted: './_layouts' directory not found.") unless Dir.exists?(layouts_path)
+
+  Dir.glob("#{theme_path}/*") do |filename|
+    puts "Generating '#{args.theme}' layout: #{File.basename(filename)}"
+
+    open("#{layouts_path}/#{File.basename(filename)}", 'w') do |page|
+      if File.basename(filename, ".html").downcase == "default"
+        page.puts "---"
+        page.puts "---"
+        page.puts "{% assign theme_asset_path = \"/assets/themes/#{args.theme}\" %}"
+      else
+        page.puts "---"
+        page.puts "layout: default"
+        page.puts "---"
+      end 
+      page.puts "{% include themes/#{args.theme}/#{File.basename(filename)} %}" 
+    end
+  end
+end # task :switch_theme
+
diff --git a/_config.yml b/_config.yml
@@ -0,0 +1,18 @@
+# This is the default format. 
+# For more see: https://github.com/mojombo/jekyll/wiki/Permalinks
+permalink: /:categories/:year/:month/:day/:title 
+auto: true
+pygments: true
+var:
+  archive_path: /archive.html
+  categories_path : /categories.html
+  tags_path : /tags.html
+
+production_url : http://username.github.com # or your custom domain name
+title : My Blog =)
+
+author :
+  name : Name Lastname
+  email : [email protected]
+  github : username
+  twitter : username
diff --git a/_includes/helpers/categories_list.html b/_includes/helpers/categories_list.html
@@ -0,0 +1,34 @@
+{% comment %}<!--
+The categories_list include is a listing helper for categories.
+Usage:
+  1) assign the 'categories_list' variable to a valid array of tags.
+  2) include helpers/categories_list.html.
+  example:
+    <ul>
+  	  {% assign categories_list = site.categories %}  
+  	  {% include helpers/categories_list.html %}
+  	</ul>
+  
+  Notes: 
+    Categories can be either a Hash of Category objects (hashes) or an Array of category-names (strings).
+    The encapsulating 'if' statement checks whether categories_list is a Hash or Array.
+    site.categories is a Hash while page.categories is an array.
+    
+  This helper can be seen in use at: ../_layouts/default.html
+-->{% endcomment %}
+
+{% if categories_list.first[0] == null %}
+  {% for category in categories_list %} 
+  	<li><a href="{{ site.var.categories_path }}#{{ category }}-ref">
+  		{{ category | join: "/" }} <span>{{ site.categories[category].size }}</span>
+  	</a></li>
+  {% endfor %}
+{% else %}
+  {% for category in categories_list %} 
+  	<li><a href="{{ site.var.categories_path }}#{{ category[0] }}-ref">
+  		{{ category[0] | join: "/" }} <span>{{ category[1].size }}</span>
+  	</a></li>
+  {% endfor %}
+{% endif %}
+
+{% assign categories_list = null %}
diff --git a/_includes/helpers/liquid_raw.html b/_includes/helpers/liquid_raw.html
@@ -0,0 +1,29 @@
+{% comment%}<!--
+The liquid_raw helper is a way to display raw liquid code, as opposed to parsing it.
+Normally you'd use Liquid's built in 'raw' tag. 
+The problem is GitHub Jekyll does not support the current Liquid release.
+GitHub Jekyll supports the deprecated 'literal' tag.
+Using one will break the other if you plan to deploy to GitHub pages.
+  see: https://github.com/mojombo/jekyll/issues/425
+
+Since I don't want to mess with Liquid versions, I'll just rewrite the way I 
+intend to give liquid examples. It's not an elegant by any means:
+
+Usage: 
+  1) Define a 'text' variable with the block of liquid code you intend to display.
+  2) Pass the text variable to include helpers/liquid_raw.html.
+
+  example:
+  {% capture text %}|.% for tag in tags_list %.|
+    <li><a href="|.{ site.var.tags_path }.||.{ tag[0] }.|-ref">|.{ tag[0] }.| <span>|.{tag[1].size}.|</span></a></li>
+  |.% endfor %.|
+
+  |.% assign tags_list = null %.|{% endcapture %}    
+  {% include helpers/liquid_raw.html %}
+  
+  As seen here, you must use "|." and ".|" as opening and closing brackets.
+-->{% endcomment%}
+
+<pre><code>{{text | replace:"|.", "&#123;" | replace:".|", "&#125;" | replace:">", "&gt;" | replace:"<", "&lt;" }}</code></pre>
+
+{% assign text = null %}
diff --git a/_includes/helpers/pages_list.html b/_includes/helpers/pages_list.html
@@ -0,0 +1,37 @@
+{% comment %}<!--
+The pages_list include is a listing helper.
+Usage:
+  1) assign the 'pages_list' variable to a valid array of pages or posts.
+  2) include helpers/pages_list.html.
+  example:
+    <ul>
+  	  {% assign pages_list = site.pages %}  
+  	  {% include helpers/pages_list.html %}
+  	</ul>
+  	
+  Grouping: (optional): 
+  	assign the 'group' variable to constrain the list to only pages/posts
+  	in the given group. Note you must define the group manually in the page/post
+  	meta-data to use this feature.
+  	Grouping is mainly helpful for non-post pages.
+  	If you want to group posts, it's easier/better to tag them, then pass the tagged posts array.
+  	i.e. site.tags.cool_tag (this returns an array of posts tagged: cool_tag)
+  	
+  This helper can be seen in use at: ../_layouts/default.html
+-->{% endcomment %}
+
+
+{% for node in pages_list %}
+  {% if group == null or group == node.group %}
+
+  	{% if page.url == node.url %}
+  	<li><a href="{{node.url}}" class="active">{{node.title}}</a></li>
+  	{% else %}
+  	<li><a href="{{node.url}}">{{node.title}}</a></li>
+  	{% endif %}
+
+  {% endif %}
+{% endfor %}
+
+{% assign pages_list = null %}
+{% assign group = null %}
diff --git a/_includes/helpers/posts_collate.html b/_includes/helpers/posts_collate.html
@@ -0,0 +1,52 @@
+{% comment %}<!--
+Collate_posts helper. Collated posts by year and month.
+Usage:
+  1) assign the 'posts_collate' variable to a valid array of posts.
+  2) include helpers/posts_collate.html.
+  example:
+    {% assign posts_collate = site.posts %}
+    {% include helpers/posts_collate.html %}
+
+  Ordering:
+    Posts are displayed in reverse chronological order.
+    For normal chronological order:
+      1) Change the for loop to this:
+        => 'for post in site.posts reversed'
+      2) Next make sure to change 'post.previous.date' to:
+        => 'post.next.date'
+        
+-->{% endcomment %}
+
+{% for post in posts_collate  %}
+  {% capture this_year %}{{ post.date | date: "%Y" }}{% endcapture %}
+  {% capture this_month %}{{ post.date | date: "%B" }}{% endcapture %}
+  {% capture next_year %}{{ post.previous.date | date: "%Y" }}{% endcapture %}
+  {% capture next_month %}{{ post.previous.date | date: "%B" }}{% endcapture %}
+
+  {% if forloop.first %}
+    <h2>{{this_year}}</h2>
+    <h3>{{this_month}}</h3>
+    <ul>
+  {% endif %}
+
+  <li><span>{{ post.date | date: "%B %e, %Y" }}</span> <a href="{{ post.url }}">{{ post.title }}</a></li>
+
+  {% if forloop.last %}
+    </ul>
+  {% else %}
+    {% if this_year != next_year %}
+      </ul>
+      <h2>{{next_year}}</h2>
+      <h3>{{next_month}}</h3>
+      <ul>
+    {% else %}    
+      {% if this_month != next_month %}
+        </ul>
+        <h3>{{next_month}}</h3>
+        <ul>
+      {% endif %}
+    {% endif %}
+  {% endif %}
+{% endfor %}
+
+{% assign posts_collate = null %}
diff --git a/_includes/helpers/tags_list.html b/_includes/helpers/tags_list.html
@@ -0,0 +1,30 @@
+{% comment %}<!--
+The tags_list include is a listing helper for tags.
+Usage:
+  1) assign the 'tags_list' variable to a valid array of tags.
+  2) include helpers/tags_list.html.
+  example:
+    <ul>
+  	  {% assign tags_list = site.tags %}  
+  	  {% include helpers/tags_list.html %}
+  	</ul>
+  
+  Notes: 
+    Tags can be either a Hash of tag objects (hashes) or an Array of tag-names (strings).
+    The encapsulating 'if' statement checks whether tags_list is a Hash or Array.
+    site.tags is a Hash while page.tags is an array.
+    
+  This helper can be seen in use at: ../_layouts/default.html
+-->{% endcomment %}
+
+{% if tags_list.first[0] == null %}
+  {% for tag in tags_list %} 
+  	<li><a href="{{ site.var.tags_path }}#{{ tag }}-ref">{{ tag }} <span>{{ site.tags[tag].size }}</span></a></li>
+  {% endfor %}
+{% else %}
+  {% for tag in tags_list %} 
+  	<li><a href="{{ site.var.tags_path }}#{{ tag[0] }}-ref">{{ tag[0] }} <span>{{ tag[1].size }}</span></a></li>
+  {% endfor %}
+{% endif %}
+
+{% assign tags_list = null %}
diff --git a/_includes/production/analytics.html b/_includes/production/analytics.html
@@ -0,0 +1,5 @@
+<!-- 
+ Drop your analytics in here.
+ This will only be included when published to GitHub.
+ We use "site.safe" variable which is true on GitHub.
+-->
diff --git a/_includes/themes/mark-reid/default.html b/_includes/themes/mark-reid/default.html
@@ -0,0 +1,75 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en-us">
+<head>
+   <meta http-equiv="content-type" content="text/html; charset=utf-8" />
+   <title>{{ page.title }} &larr; {{ page.top }}</title>
+   <meta name="author" content="{{ site.author.name }}" />
+
+   <link rel="start" href="/" />
+
+	{% if page.keywords %}
+	<meta name="keywords" content="{{ page.keywords }}">
+	{% endif %}
+
+	{% if page.feed %}
+  	<link rel="alternate" type="application/atom+xml" href="{{ page.feed }}" title="RSS feed" />
+	{% endif %}
+
+   <!-- syntax highlighting CSS -->
+   <link rel="stylesheet" href="{{ theme_asset_path }}/css/syntax.css" type="text/css" />
+
+   <!-- Homepage CSS -->
+   <link rel="stylesheet" href="{{ theme_asset_path }}/css/screen.css" type="text/css" />
+
+</head>
+<body id="{{ page.section }}">
+<div id="site">
+
+  <div id="header">
+    <h1>
+    	<a href="/" title="{{ site.title }}">{{ site.title }}</a>
+    	<span class="byline">&larr; <a href="/">{{ site.author.name }}</a></span>
+    </h1>
+    <ul class="nav">
+      <li><a class="home" href="/">Home</a></li>
+      <li><a  href="/archive.html">Archive</a></li>
+      <li><a  href="/pages.html">Pages</a></li>
+      <li><a  href="/categories.html">Categories</a></li>
+      <li><a  href="/tags.html">Tags</a></li>
+    </ul>
+  </div>
+
+  {{ content }}
+
+  <div id="footer">
+  	<address>
+  		<span class="copyright">
+  			Content by <a href="/info/site.html">{{ site.author.name }}</a>. Design by 
+  			<a href="http://mark.reid.name/">Mark Reid</a>
+  			<br/>
+  			(<a rel="licence" href="http://creativecommons.org/licenses/by-nc-sa/3.0/">Some rights reserved</a>)			
+  		</span>
+  		<span class="engine">
+  			Powered by <a href="http://github.com/mojombo/jekyll/" title="A static, minimalist CMS">Jekyll</a>
+  		</span>
+  	</address>
+  </div>
+
+</div>
+
+<!--[if IE 6]>
+<script type="text/javascript"> 
+	/*Load jQuery if not already loaded*/ if(typeof jQuery == 'undefined'){ document.write("<script type=\"text/javascript\"   src=\"http://ajax.googleapis.com/ajax/libs/jquery/1.3.2/jquery.min.js\"></"+"script>"); var __noconflict = true; } 
+	var IE6UPDATE_OPTIONS = {
+		icons_path: "http://static.ie6update.com/hosted/ie6update/images/"
+	}
+</script>
+<script type="text/javascript" src="http://static.ie6update.com/hosted/ie6update/ie6update.js"></script>
+<![endif]-->
+{% if site.safe %}
+  {% include production/analytics.html %}
+{% endif %}
+</body>
+</html>
diff --git a/_includes/themes/mark-reid/page.html b/_includes/themes/mark-reid/page.html
@@ -0,0 +1,6 @@
+<div id="page">
+
+<h1 class="emphnext">{{ page.title }}</h1>
+{{ content }}
+
+</div><!-- End Page -->