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.