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