jekyll 0.12.1 → 1.0.0.beta1

data/site/_posts/2012-07-01-usage.md

@@ -0,0 +1,38 @@
+---
+layout: docs
+title: Basic Usage
+prev_section: installation
+next_section: structure
+---
+
+The Jekyll gem makes a `jekyll` executable available to you in your Terminal window. You can use this command in a number of ways:
+
+{% highlight bash %}
+jekyll build
+#=> The current folder will get generated into ./_site
+jekyll build --destination <destination>
+#=> The current folder will get generated into <destination>
+jekyll build --source <source> --destination <destination>
+#=> The <source> folder will get generated into <destination>
+jekyll build --watch
+#=> The current folder will get generated into ./_site,
+#       and watch for changes and regenerate automatically.
+{% endhighlight %}
+
+Jekyll also comes with a built-in development server that will allow you to preview what the generated site will look like in your browser locally.
+
+{% highlight bash %}
+jekyll serve
+#=> A development server will run at http://localhost:4000/
+jekyll serve --watch
+#=> As above, but watch for changes and regenerate automatically too.
+{% endhighlight %}
+
+These are just some of the many [configuration options](../configuration) available. All configuration options can either be specified as flags on the command line, or alternatively (and more commonly) they can be specified in a `_config.yml` file at the root of the source directory. Jekyll will automatically configuration options from this file when run, so placing the following one line in the configuration file will mean that running `jekyll build` or `jekyll serve` would be equivalent to running `jekyll [build|serve] --source _source --destination _deploy`:
+
+{% highlight yaml %}
+source:      _source
+destination: _deploy
+{% endhighlight %}
+
+For more about the possible configuration options, see the [configuration](../configuration) page.

data/site/_posts/2012-07-01-variables.md

@@ -0,0 +1,166 @@
+---
+layout: docs
+title: Variables
+prev_section: pages
+next_section: migrations
+---
+
+Jekyll traverses your site looking for files to process. Any files with [YAML Front Matter](../frontmatter) are subject to processing. For each of these files, Jekyll makes a variety of data available to the pages via the [Liquid templating system](http://wiki.github.com/shopify/liquid/liquid-for-designers). The following is a reference of the available data.
+
+## Global Variables
+
+<table>
+  <thead>
+    <tr>
+      <td>Variable</td>
+      <td>Description</td>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><p><code>site</code></p></td>
+      <td><p>Sitewide information + Configuration settings from <code>_config.yml</code></p></td>
+    </tr>
+    <tr>
+      <td><p><code>page</code></p></td>
+      <td><p>This is just the <a href="../frontmatter">YAML Front Matter</a> with 2 additions: <code>url</code> and <code>content</code>.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>content</code></p></td>
+      <td><p>In layout files, this contains the content of the subview(s). This is the variable used to insert the rendered content into the layout. This is not used in post files or page files.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>paginator</code></p></td>
+      <td><p>When the <code>paginate</code> configuration option is set, this variable becomes available for use.</p></td>
+    </tr>
+  </tbody>
+</table>
+
+## Site Variables
+
+<table>
+  <thead>
+    <tr>
+      <td>Variable</td>
+      <td>Description</td>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><p><code>site.time</code></p></td>
+      <td><p>The current time (when you run the <code>jekyll</code> command).</p></td>
+    </tr>
+    <tr>
+      <td><p><code>site.posts</code></p></td>
+      <td><p>A reverse chronological list of all Posts.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>site.related_posts</code></p></td>
+      <td><p>If the page being processed is a Post, this contains a list of up to ten related Posts. By default, these are low quality but fast to compute. For high quality but slow to compute results, run the <code>jekyll</code> command with the <code>--lsi</code> (latent semantic indexing) option.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>site.categories.CATEGORY</code></p></td>
+      <td><p>The list of all Posts in category <code>CATEGORY</code>.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>site.tags.TAG</code></p></td>
+      <td><p>The list of all Posts with tag <code>TAG</code>.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>site.[CONFIGURATION_DATA]</code></p></td>
+      <td><p>All variables set in your <code>_config.yml</code> are available through the <code>site</code> variable. For example, if you have <code>url: http://mysite.com</code> in your configuration file, then in your posts and pages it can be accessed using <code>{{ "{{ site.url " }}}}</code>. Jekyll does not parse changes to <code>_config.yml</code> in <code>watch</code> mode, you have to restart Jekyll to see changes to variables.</p></td>
+    </tr>
+  </tbody>
+</table>
+
+## Page Variables
+
+<table>
+  <thead>
+    <tr>
+      <td>Variable</td>
+      <td>Description</td>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><p><code>page.content</code></p></td>
+      <td><p>The un-rendered content of the Page.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>page.title</code></p></td>
+      <td><p>The title of the Post.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>page.url</code></p></td>
+      <td><p>The URL of the Post without the domain. e.g. <code>/2008/12/14/my-post.html</code></p></td>
+    </tr>
+    <tr>
+      <td><p><code>page.date</code></p></td>
+      <td><p>The Date assigned to the Post. This can be overridden in a post’s front matter by specifying a new date/time in the format <code>YYYY-MM-DD HH:MM:SS</code></p></td>
+    </tr>
+    <tr>
+      <td><p><code>page.id</code></p></td>
+      <td><p>An identifier unique to the Post (useful in RSS feeds). e.g. <code>/2008/12/14/my-post</code></p></td>
+    </tr>
+    <tr>
+      <td><p><code>page.categories</code></p></td>
+      <td><p>The list of categories to which this post belongs. Categories are derived from the directory structure above the <code>_posts</code> directory. For example, a post at <code>/work/code/_posts/2008-12-24-closures.textile</code> would have this field set to <code>['work', 'code']</code>. These can also be specified in the <a href="../frontmatter">YAML Front Matter</a>.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>page.tags</code></p></td>
+      <td><p>The list of tags to which this post belongs. These can be specified in the <a href="../frontmatter">YAML Front Matter</a></p></td>
+    </tr>
+  </tbody>
+</table>
+
+<div class="note">
+  <h5>ProTip™: Use custom front-matter</h5>
+  <p>Any custom front matter that you specify will be available under <code>page</code>. For example, if you specify <code>custom_css: true</code> in a page’s front matter, that value will be available in templates as <code>page.custom_css</code>.</p>
+</div>
+
+## Paginator
+
+<table>
+  <thead>
+    <tr>
+      <td>Variable</td>
+      <td>Description</td>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><p><code>paginator.per_page</code></p></td>
+      <td><p>Number of posts per page.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>paginator.posts</code></p></td>
+      <td><p>Posts available for that page.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>paginator.total_posts</code></p></td>
+      <td><p>Total number of posts.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>paginator.total_pages</code></p></td>
+      <td><p>Total number of pages.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>paginator.page</code></p></td>
+      <td><p>The number of the current page.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>paginator.previous_page</code></p></td>
+      <td><p>The number of the previous page.</p></td>
+    </tr>
+    <tr>
+      <td><p><code>paginator.next_page</code></p></td>
+      <td><p>The number of the next page.</p></td>
+    </tr>
+  </tbody>
+</table>
+
+<div class="note info">
+  <h5>Paginator variable availability</h5>
+  <p>These are only available in index files, however they can be located in a subdirectory, such as <code>/blog/index.html</code>.</p>
+</div>

data/site/css/grid.css

@@ -0,0 +1,62 @@
+.content {
+  width: 978px;
+  margin: 0 auto;
+}
+.grid1, .grid2, .grid3, .grid4, .grid5, .grid6, .grid7, .grid8, .grid9, .grid10, .grid11 {
+  float: left;
+  display: inline;
+  margin-left: 30px;
+}
+.grid1 {
+  width: 54px;
+}
+.grid2 {
+  width: 138px;
+}
+.grid3 {
+  width: 222px;
+}
+.grid4 {
+  width: 306px;
+}
+.grid5 {
+  width: 390px;
+}
+.grid6 {
+  width: 474px;
+}
+.grid7 {
+  width: 558px;
+}
+.grid8 {
+  width: 642px;
+}
+.grid9 {
+  width: 726px;
+}
+.grid10 {
+  width: 810px;
+}
+.grid11 {
+  width: 894px;
+}
+.first {
+  margin-left: 0;
+  clear: left;
+}
+
+/* clearfix */
+.clear:after {
+  visibility: hidden;
+  display: block;
+  font-size: 0;
+  content: " ";
+  clear: both;
+  height: 0;
+}
+* html .clear {
+  zoom: 1;
+} /* IE6 */
+*:first-child+html .clear {
+  zoom: 1;
+} /* IE7 */

data/site/css/normalize.css

@@ -0,0 +1,504 @@
+/*! normalize.css 2012-03-11T12:53 UTC - http://github.com/necolas/normalize.css */
+
+/* =============================================================================
+   HTML5 display definitions
+   ========================================================================== */
+
+/*
+ * Corrects block display not defined in IE6/7/8/9 & FF3
+ */
+
+article,
+aside,
+details,
+figcaption,
+figure,
+footer,
+header,
+hgroup,
+nav,
+section,
+summary {
+    display: block;
+}
+
+/*
+ * Corrects inline-block display not defined in IE6/7/8/9 & FF3
+ */
+
+audio,
+canvas,
+video {
+    display: inline-block;
+    *display: inline;
+    *zoom: 1;
+}
+
+/*
+ * Prevents modern browsers from displaying 'audio' without controls
+ * Remove excess height in iOS5 devices
+ */
+
+audio:not([controls]) {
+    display: none;
+    height: 0;
+}
+
+/*
+ * Addresses styling for 'hidden' attribute not present in IE7/8/9, FF3, S4
+ * Known issue: no IE6 support
+ */
+
+[hidden] {
+    display: none;
+}
+
+
+/* =============================================================================
+   Base
+   ========================================================================== */
+
+/*
+ * 1. Corrects text resizing oddly in IE6/7 when body font-size is set using em units
+ *    http://clagnut.com/blog/348/#c790
+ * 2. Prevents iOS text size adjust after orientation change, without disabling user zoom
+ *    www.456bereastreet.com/archive/201012/controlling_text_size_in_safari_for_ios_without_disabling_user_zoom/
+ */
+
+html {
+    font-size: 100%; /* 1 */
+    -webkit-text-size-adjust: 100%; /* 2 */
+    -ms-text-size-adjust: 100%; /* 2 */
+}
+
+/*
+ * Addresses font-family inconsistency between 'textarea' and other form elements.
+ */
+
+html,
+button,
+input,
+select,
+textarea {
+    font-family: sans-serif;
+}
+
+/*
+ * Addresses margins handled incorrectly in IE6/7
+ */
+
+body {
+    margin: 0;
+}
+
+
+/* =============================================================================
+   Links
+   ========================================================================== */
+
+/*
+ * Addresses outline displayed oddly in Chrome
+ */
+
+a:focus {
+    outline: thin dotted;
+}
+
+/*
+ * Improves readability when focused and also mouse hovered in all browsers
+ * people.opera.com/patrickl/experiments/keyboard/test
+ */
+
+a:hover,
+a:active {
+    outline: 0;
+}
+
+
+/* =============================================================================
+   Typography
+   ========================================================================== */
+
+/*
+ * Addresses font sizes and margins set differently in IE6/7
+ * Addresses font sizes within 'section' and 'article' in FF4+, Chrome, S5
+ */
+
+h1 {
+    font-size: 2em;
+    margin: 0.67em 0;
+}
+
+h2 {
+    font-size: 1.5em;
+    margin: 0.83em 0;
+}
+
+h3 {
+    font-size: 1.17em;
+    margin: 1em 0;
+}
+
+h4 {
+    font-size: 1em;
+    margin: 1.33em 0;
+}
+
+h5 {
+    font-size: 0.83em;
+    margin: 1.67em 0;
+}
+
+h6 {
+    font-size: 0.75em;
+    margin: 2.33em 0;
+}
+
+/*
+ * Addresses styling not present in IE7/8/9, S5, Chrome
+ */
+
+abbr[title] {
+    border-bottom: 1px dotted;
+}
+
+/*
+ * Addresses style set to 'bolder' in FF3+, S4/5, Chrome
+*/
+
+b,
+strong {
+    font-weight: bold;
+}
+
+blockquote {
+    margin: 1em 40px;
+}
+
+/*
+ * Addresses styling not present in S5, Chrome
+ */
+
+dfn {
+    font-style: italic;
+}
+
+/*
+ * Addresses styling not present in IE6/7/8/9
+ */
+
+mark {
+    background: #ff0;
+    color: #000;
+}
+
+/*
+ * Addresses margins set differently in IE6/7
+ */
+
+p,
+pre {
+    margin: 1em 0;
+}
+
+/*
+ * Corrects font family set oddly in IE6, S4/5, Chrome
+ * en.wikipedia.org/wiki/User:Davidgothberg/Test59
+ */
+
+pre,
+code,
+kbd,
+samp {
+    font-family: monospace, serif;
+    _font-family: 'courier new', monospace;
+    font-size: 1em;
+}
+
+/*
+ * Improves readability of pre-formatted text in all browsers
+ */
+
+pre {
+    white-space: pre;
+    white-space: pre-wrap;
+    word-wrap: break-word;
+}
+
+/*
+ * 1. Addresses CSS quotes not supported in IE6/7
+ * 2. Addresses quote property not supported in S4
+ */
+
+/* 1 */
+
+q {
+    quotes: none;
+}
+
+/* 2 */
+
+q:before,
+q:after {
+    content: '';
+    content: none;
+}
+
+small {
+    font-size: 75%;
+}
+
+/*
+ * Prevents sub and sup affecting line-height in all browsers
+ * gist.github.com/413930
+ */
+
+sub,
+sup {
+    font-size: 75%;
+    line-height: 0;
+    position: relative;
+    vertical-align: baseline;
+}
+
+sup {
+    top: -0.5em;
+}
+
+sub {
+    bottom: -0.25em;
+}
+
+
+/* =============================================================================
+   Lists
+   ========================================================================== */
+
+/*
+ * Addresses margins set differently in IE6/7
+ */
+
+dl,
+menu,
+ol,
+ul {
+    margin: 1em 0;
+}
+
+dd {
+    margin: 0 0 0 40px;
+}
+
+/*
+ * Addresses paddings set differently in IE6/7
+ */
+
+menu,
+ol,
+ul {
+    padding: 0 0 0 40px;
+}
+
+/*
+ * Corrects list images handled incorrectly in IE7
+ */
+
+nav ul,
+nav ol {
+    list-style: none;
+    list-style-image: none;
+}
+
+
+/* =============================================================================
+   Embedded content
+   ========================================================================== */
+
+/*
+ * 1. Removes border when inside 'a' element in IE6/7/8/9, FF3
+ * 2. Improves image quality when scaled in IE7
+ *    code.flickr.com/blog/2008/11/12/on-ui-quality-the-little-things-client-side-image-resizing/
+ */
+
+img {
+    border: 0; /* 1 */
+    -ms-interpolation-mode: bicubic; /* 2 */
+}
+
+/*
+ * Corrects overflow displayed oddly in IE9
+ */
+
+svg:not(:root) {
+    overflow: hidden;
+}
+
+
+/* =============================================================================
+   Figures
+   ========================================================================== */
+
+/*
+ * Addresses margin not present in IE6/7/8/9, S5, O11
+ */
+
+figure {
+    margin: 0;
+}
+
+
+/* =============================================================================
+   Forms
+   ========================================================================== */
+
+/*
+ * Corrects margin displayed oddly in IE6/7
+ */
+
+form {
+    margin: 0;
+}
+
+/*
+ * Define consistent border, margin, and padding
+ */
+
+fieldset {
+    border: 1px solid #c0c0c0;
+    margin: 0 2px;
+    padding: 0.35em 0.625em 0.75em;
+}
+
+/*
+ * 1. Corrects color not being inherited in IE6/7/8/9
+ * 2. Corrects text not wrapping in FF3
+ * 3. Corrects alignment displayed oddly in IE6/7
+ */
+
+legend {
+    border: 0; /* 1 */
+    padding: 0;
+    white-space: normal; /* 2 */
+    *margin-left: -7px; /* 3 */
+}
+
+/*
+ * 1. Corrects font size not being inherited in all browsers
+ * 2. Addresses margins set differently in IE6/7, FF3+, S5, Chrome
+ * 3. Improves appearance and consistency in all browsers
+ */
+
+button,
+input,
+select,
+textarea {
+    font-size: 100%; /* 1 */
+    margin: 0; /* 2 */
+    vertical-align: baseline; /* 3 */
+    *vertical-align: middle; /* 3 */
+}
+
+/*
+ * Addresses FF3/4 setting line-height on 'input' using !important in the UA stylesheet
+ */
+
+button,
+input {
+    line-height: normal; /* 1 */
+}
+
+/*
+ * 1. Improves usability and consistency of cursor style between image-type 'input' and others
+ * 2. Corrects inability to style clickable 'input' types in iOS
+ * 3. Removes inner spacing in IE7 without affecting normal text inputs
+ *    Known issue: inner spacing remains in IE6
+ */
+
+button,
+input[type="button"],
+input[type="reset"],
+input[type="submit"] {
+    cursor: pointer; /* 1 */
+    -webkit-appearance: button; /* 2 */
+    *overflow: visible;  /* 3 */
+}
+
+/*
+ * Re-set default cursor for disabled elements
+ */
+
+button[disabled],
+input[disabled] {
+    cursor: default;
+}
+
+/*
+ * 1. Addresses box sizing set to content-box in IE8/9
+ * 2. Removes excess padding in IE8/9
+ * 3. Removes excess padding in IE7
+      Known issue: excess padding remains in IE6
+ */
+
+input[type="checkbox"],
+input[type="radio"] {
+    box-sizing: border-box; /* 1 */
+    padding: 0; /* 2 */
+    *height: 13px; /* 3 */
+    *width: 13px; /* 3 */
+}
+
+/*
+ * 1. Addresses appearance set to searchfield in S5, Chrome
+ * 2. Addresses box-sizing set to border-box in S5, Chrome (include -moz to future-proof)
+ */
+
+input[type="search"] {
+    -webkit-appearance: textfield; /* 1 */
+    -moz-box-sizing: content-box;
+    -webkit-box-sizing: content-box; /* 2 */
+    box-sizing: content-box;
+}
+
+/*
+ * Removes inner padding and search cancel button in S5, Chrome on OS X
+ */
+
+input[type="search"]::-webkit-search-decoration,
+input[type="search"]::-webkit-search-cancel-button {
+    -webkit-appearance: none;
+}
+
+/*
+ * Removes inner padding and border in FF3+
+ * www.sitepen.com/blog/2008/05/14/the-devils-in-the-details-fixing-dojos-toolbar-buttons/
+ */
+
+button::-moz-focus-inner,
+input::-moz-focus-inner {
+    border: 0;
+    padding: 0;
+}
+
+/*
+ * 1. Removes default vertical scrollbar in IE6/7/8/9
+ * 2. Improves readability and alignment in all browsers
+ */
+
+textarea {
+    overflow: auto; /* 1 */
+    vertical-align: top; /* 2 */
+}
+
+
+/* =============================================================================
+   Tables
+   ========================================================================== */
+
+/*
+ * Remove most spacing between table cells
+ */
+
+table {
+    border-collapse: collapse;
+    border-spacing: 0;
+}