README.md in octopress-3.0.0.rc.27 vs README.md in octopress-3.0.0.rc.28

- old
+ new

@@ -29,11 +29,11 @@ new post <TITLE> # Add a new post to your site new page <PATH> # Add a new page to your site new draft <TITLE> # Add a new draft post to your site publish <POST> # Publish a draft from _drafts to _posts unpublish <POST> # Search for a post and convert it into a draft -isolate [POST] # Stash all posts but the one you're workign on for a faster build +isolate [POST] # Stash all posts but the one you're working on for a faster build integrate # Restores all posts, doing the opposite of the isolate command ``` Run `octopress --help` to list sub commands and `octopress <subcommand> --help` to learn more about any subcommand and see its options. @@ -123,11 +123,11 @@ | Option | Description | |:-------------------|:------------------------------------------| | `--template PATH` | Use a template from <path> | | `--date DATE` | The date for the draft. Should be parseable by [Time#parse](http://ruby-doc.org/stdlib-2.1.0/libdoc/time/rdoc/Time.html#method-i-parse) (defaults to Time.now) | | `--slug SLUG` | The slug for the new post. | -| `--force` | Overwrite exsiting file. | +| `--force` | Overwrite existing file. | ### Publish a draft Use the `publish` command to publish a draft to the `_posts` folder. This will also rename the file with the proper date format. @@ -185,16 +185,28 @@ | `year` | The date's year | | `month` | The date's month, MM | | `day` | The date's day, DD | By default Octopress has templates for pages, posts and drafts. You can change them or create new ones for different types of content. -To create linkposts template, add a file at `_templates/linkpost` and use it with a new post like this: +To create linkposts template, add a file at `_templates/linkpost`, such as: +``` +--- +title: {{ title }} +external-url: {{ url }} +--- +``` + +Then you can use it with a new post like this: + ```sh -$ octopress new post --template _templates/linkpost +$ octopress new post "Some title" --template linkpost +$ octopress new post "Some title" -tm _templates/linkpost ``` -File name extensions are unnecessary since they're just plain text anyway. +In the second example, I'm passing the full template file path. This way I can use my shell's tab to auto-complete feature. + +When creating templates, file name extensions are unnecessary since the files are just plain text anyway. ## Isolate The `isolate` command will allow you to stash posts in `_posts/_exile` where they will be ignored by Jekyll during the build process. Run `octopress integrate` to restore all exiled posts. This can be helpful if you have a very large site and you want to quickly preview a build