assets/docs/index.markdown in octopress-3.0.0.rc.11 vs assets/docs/index.markdown in octopress-3.0.0.rc.12
- old
+ new
@@ -1,20 +1,19 @@
---
title: "Octopress"
---
-
Octopress is an obsessively designed toolkit for writing and deploying Jekyll blogs. Pretty sweet, huh?
<!--[![Gem Version](https://badge.fury.io/rb/octopress.png)](http://badge.fury.io/rb/octopress)-->
[![Build Status](https://travis-ci.org/octopress/octopress.png?branch=master)](https://travis-ci.org/octopress/octopress)
## Installation
Add this line to your application's Gemfile:
- gem 'octopress', '~> 3.0.0.rc.11'
+ gem 'octopress', '~> 3.0.0.rc.12'
And then execute:
$ bundle
@@ -96,19 +95,19 @@
layout: post
title: "My Title"
date: YYYY-MM-DDTHH:MM:SS-00:00
```
-"Ok, great? What else can I do?" Great question! Check out these other options:
+"OK, great? What else can I do?" Great question! Check out these other options:
| Option | Description |
|:---------------------|:----------------------------------------|
| `--template PATH` | Use a template from <path> |
| `--date DATE` | The date for the post. Should be parseable by [Time#parse](http://ruby-doc.org/stdlib-2.1.0/libdoc/time/rdoc/Time.html#method-i-parse) |
| `--slug SLUG` | Slug for the new post. |
| `--dir DIR` | Create post at _posts/DIR/. |
-| `--force` | Overwrite exsiting file. |
+| `--force` | Overwrite existing file. |
### New Page
```
$ octopress new page some-page # ./some-page.html
@@ -119,12 +118,16 @@
| Option | Description |
|:---------------------|:----------------------------------------|
| `--template PATH` | Use a template from <path> |
| `--title TITLE` | The title of the new page |
| `--date DATE` | The date for the page. Should be parseable by [Time#parse](http://ruby-doc.org/stdlib-2.1.0/libdoc/time/rdoc/Time.html#method-i-parse) |
-| `--force` | Overwrite exsiting file. |
+| `--force` | Overwrite existing file. |
+Note: The default page template doesn't expect a date. If you want to add dates
+to your posts, consider adding `date: {{ date }}` to the default template
+`_templates/page`, or create a new template to use for dated pages.
+
### New Draft
```sh
$ octopress new draft "My Title"
```
@@ -149,11 +152,11 @@
| Option | Description |
|:-------------------|:------------------------------------------|
| `--date DATE` | The date for the post. Should be parseable by [Time#parse](http://ruby-doc.org/stdlib-2.1.0/libdoc/time/rdoc/Time.html#method-i-parse) |
| `--slug SLUG` | Change the slug for the new post. |
| `--dir DIR` | Create post at _posts/DIR/. |
-| `--force` | Overwrite exsiting file. |
+| `--force` | Overwrite existing file. |
When publishing a draft, the new post will use the draft's date. Pass the option `--date now` to the publish command to set the new post date from your system clock. As usual, you can pass any compatible date string as well.
### Templates for Posts and pages
@@ -161,10 +164,9 @@
```
---
layout: {{ layout }}
title: {{ title }}
-date: {{ date }}
---
```
The YAML variables will be replaced with the correct content when you create a page or post. To modify this template create a `_templates/post` file and change it as you wish. You can add additional YAML front-matter or content, and you can even create multiple templates. Choose a custom template when creating a new post or page like this.