Merge pull request #41 from skylogic004/master

Fix links and description. And added an example.

publisher/api.json

@@ -6954,12 +6954,12 @@
       "AssetId": {
         "name": "asset_id",
         "in": "path",
-        "description": "Unique identifier for the asset.",
+        "description": "Unique identifier for the asset. Each asset in an episode's set of assets has an ID starting from 1 (e.g., the first asset has asset_id=1, the second asset has asset_id=2, and so on).",
         "required": true,
         "schema": {
           "type": "string"
         }
       }
     }
   }
-}
+}

publisher/guides/templates.mdx

@@ -133,6 +133,24 @@ To use them in another template, you need to import the macros before using them
 {% endraw %}
 ```
 
+### Filters
+
+Twig filters can be used to filter the list of episodes. For example, this filter selects only the episodes from the year 2024:
+
+```handlebars
+{% set filtered_episodes = podcast.episodes|filter(episode => episode.publicationDate.format('Y') == "2024") %}
+
+<ul>
+{% for episode in filtered_episodes %}
+  <li>
+    <a href="{{ episode.url }}">
+      {{ episode.title }}
+    </a> — {{ episode.subtitle }}
+  </li>
+{% endfor %}
+</ul>
+```
+
 ## Creating PHP Templates — For Theme Developers
 
 _Available from Podlove Publisher version 2.3_
@@ -254,7 +272,7 @@ echo get_podcast()->title();
 ?>
 ```
 
-[1]: http://twig.sensiolabs.org/
-[2]: http://twig.sensiolabs.org/doc/templates.html
+[1]: https://twig.symfony.com/
+[2]: https://twig.symfony.com/doc/3.x/templates.html
 [3]: /podlove-publisher/reference/templates/template-tags/podcast
-[4]: http://twig.sensiolabs.org/doc/tags/macro.html
+[4]: https://twig.symfony.com/doc/3.x/tags/macro.html