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.