site/docs/posts.md in jekyll-1.1.2 vs site/docs/posts.md in jekyll-1.2.0

- old
+ new

@@ -13,15 +13,15 @@ your computer. Compared to the hassle of configuring and maintaining databases and web-based CMS systems, this will be a welcome change! ## The Posts Folder -As explained on the [directory structure](../structure) page, the `_posts` +As explained on the [directory structure](../structure/) page, the `_posts` folder is where your blog posts will live. These files can be either [Markdown](http://daringfireball.net/projects/markdown/) or [Textile](http://textile.sitemonks.com/) formatted text files, and as long as -they have [YAML front-matter](../frontmatter), they will be converted from their +they have [YAML front-matter](../frontmatter/), they will be converted from their source format into an HTML page that is part of your static site. ### Creating Post Files To create a new post, all you need to do is create a new file in the `_posts` @@ -41,11 +41,11 @@ 2012-09-12-how-to-write-a-blog.textile {% endhighlight %} ### Content Formats -All blog post files must begin with [YAML front- matter](../frontmatter). After +All blog post files must begin with [YAML front- matter](../frontmatter/). After that, it's simply a matter of deciding which format you prefer. Jekyll supports two popular content markup formats: [Markdown](http://daringfireball.net/projects/markdown/) and [Textile](http://textile.sitemonks.com/). These formats each have their own way of marking up different types of content within a post, so you should @@ -93,11 +93,11 @@ ## Displaying an index of posts It’s all well and good to have posts in a folder, but a blog is no use unless you have a list of posts somewhere. Creating an index of posts on another page -(or in a [template](../templates)) is easy, thanks to the [Liquid template +(or in a [template](../templates/)) is easy, thanks to the [Liquid template language](http://wiki.shopify.com/Liquid) and its tags. Here’s a basic example of how to create a list of links to your blog posts: {% highlight html %} <ul> @@ -109,11 +109,11 @@ </ul> {% endhighlight %} Of course, you have full control over how (and where) you display your posts, and how you structure your site. You should read more about [how templates -work](../templates) with Jekyll if you want to know more. +work](../templates/) with Jekyll if you want to know more. ## Post excerpts Each post automatically takes the first block of text, from the beginning of the content to the first occurrence of `excerpt_separator`, and sets it as the `post.excerpt`. @@ -131,11 +131,12 @@ {% raw %}{% endfor %}{% endraw %} </ul> {% endhighlight %} If you don't like the automatically-generated post excerpt, it can be overridden by adding -`excerpt` to your post's YAML front-matter. +`excerpt` to your post's YAML front-matter. Completely disable it by setting +your `excerpt_separator` to `""`. ## Highlighting code snippets Jekyll also has built-in support for syntax highlighting of code snippets using Pygments, and including a code snippet in any post is easy. Just use the @@ -174,7 +175,7 @@ </p> </div> These basics should be enough to get you started writing your first posts. When you’re ready to dig into what else is possible, you might be interested in doing -things like [customizing post permalinks](../permalinks) or using [custom -variables](../variables) in your posts and elsewhere on your site. +things like [customizing post permalinks](../permalinks/) or using [custom +variables](../variables/) in your posts and elsewhere on your site.