diff --git a/content-sample/index.md b/content-sample/index.md index beb5ea9..04b77a0 100644 --- a/content-sample/index.md +++ b/content-sample/index.md @@ -140,16 +140,15 @@ If you want to use Pico as a blogging software, you probably want to do something like the following: 1. Put all your blog articles in a separate `blog` folder in your `content` - directory. All these articles should have both a `Date` and `Template` meta - header, the latter with e.g. `blog-post` as value (see Step 2). -2. Create a new Twig template called `blog-post.twig` (this must match the - `Template` meta header from Step 1) in your theme directory. This template - probably isn't very different from your default `index.twig`, it specifies - how your article pages will look like. -3. Create a `blog.md` in your `content` folder and set its `Template` meta - header to e.g. `blog`. Also create a `blog.twig` in your theme directory. - This template will show a list of your articles, so you probably want to - do something like this: + directory. All these articles should have a `Date` meta header. +2. Create a `blog.md` or `blog/index.md` in your `content` directory. Add + `Template: blog-index` to the YAML header of this page. It will later show a + list of all your blog articles (see step 3). +3. Create the new Twig template `blog-index.twig` (the file name must match the + `Template` meta header from Step 2) in your theme directory. This template + probably isn't very different from your default `index.twig` (i.e. copy + `index.twig`), it will create a list of all your blog articles. Add the + following Twig snippet to `blog-index.twig` near `{{ content }}`: ``` {% for page in pages|sort_by("time")|reverse %} {% if page.id starts with "blog/" and not page.hidden %} @@ -161,10 +160,6 @@ something like the following: {% endif %} {% endfor %} ``` -4. Make sure to exclude blog articles from your page navigation. You can achieve - this by adding `{% if not (page.id starts with "blog/") %}...{% endif %}` - to the navigation loop (`{% for page in pages %}...{% endfor %}`) in your - theme's `index.twig`. ## Customization