Merge pull request #1289 from mojombo/drafts-docs

Documentation for drafts

site/_includes/docs_contents.html

@@ -29,6 +29,9 @@
       <li class="{% if page.title == "Writing posts" %}current{% endif %}">
         <a href="{{ site.url }}/docs/posts">Writing posts</a>
       </li>
+      <li class="{% if page.title == "Working with drafts" %}current{% endif %}">
+        <a href="{{ site.url }}/docs/drafts">Working with drafts</a>
+      </li>
       <li class="{% if page.title == "Creating pages" %}current{% endif %}">
         <a href="{{ site.url }}/docs/pages">Creating pages</a>
       </li>

site/_includes/docs_contents_mobile.html

@@ -12,6 +12,7 @@
     <optgroup label="Your Content">
       <option value="{{ site.url }}/docs/frontmatter">Front-matter</option>
       <option value="{{ site.url }}/docs/posts">Writing posts</option>
+      <option value="{{ site.url }}/docs/drafts">Working with drafts</option>
       <option value="{{ site.url }}/docs/pages">Creating pages</option>
       <option value="{{ site.url }}/docs/variables">Variables</option>
       <option value="{{ site.url }}/docs/migrations">Blog migrations</option>

site/docs/drafts.md

@@ -0,0 +1,20 @@
+---
+layout: docs
+title: Working with drafts
+permalink: /docs/drafts/
+---
+
+Drafts are posts without a date. They're posts you're still working on and don't want to
+publish yet. To get up and running with drafts, create a `_drafts` folder in your site's
+root (as described in the [site structure](/docs/structure/) section) and create your
+first draft:
+
+{% highlight text %}
+|-- _drafts/
+|   |-- a-draft-post.md
+{% endhighlight %}
+
+To preview your site with drafts, simply run `jekyll serve` or `jekyll build` with
+the `--drafts` switch.  Each will be assigned the value of `Time.now`
+for its date, and thus you will see them generated as the latest posts.
+

site/docs/structure.md

@@ -19,6 +19,9 @@ A basic Jekyll site usually looks something like this:
 {% highlight bash %}
 .
 ├── _config.yml
+├── _drafts
+|   ├── begin-with-the-crazy-ideas.textile
+|   └── on-simplicity-in-technology.markdown
 ├── _includes
 |   ├── footer.html
 |   └── header.html