Fixes #542: render each and render all

website/CHANGELOG.md

@@ -1,6 +1,13 @@
 An attempt at documenting the changes/new features introduced in each
 release.
 
+---
+## 0.5.4
+* Many styling fixes and improvements to [[Live Queries]] and [[Live Templates]]
+* Added a “source” button to [[Live Queries]] and [[Live Templates]] for better debugging (showing you the markdown code rendered by the template so you can more easily detect issues)
+* [[Live Queries]]:
+  * Support for `render all` where the entire result set is passed to a single template allowing you to e.g. dynamically build up tables, see [[Live Queries@render]] for an example.
+
 ---
 ## 0.5.3
 * Changes to [[Objects]]:

website/Live Queries.md

@@ -55,14 +55,25 @@ person
 where page = "{{@page.name}}"
 select name, age, age + 1 as nextYear
 ```
-### `render [[template]]`
-By default results are rendered as a table, to instead render each result item using [[Templates|a template]], use the `render` clause:
+### `render each [[template]]` and `render all [[template]]`
+$render
+By default results are rendered as a table, to instead render results using [[Templates|a template]], use the `render` clause, which comes in two shapes `render each` where the template is instantiated for _each_ result (the `each` keyword is optional):
 
 ```query
 person
 where page = "{{@page.name}}"
-render [[template/person]]
+render each [[template/person]]
 ```
+
+And `render all` where the entire result set is passed to the template as a list so the template can do its own iteration using `#each`, which you could then use to e.g. build a table (using this [[template/people]] template for instance):
+
+```query
+person
+where page = "{{@page.name}}"
+render all [[template/people]]
+```
+
+
 ## Expressions
 $expression
 

website/template/people.md

@@ -0,0 +1,5 @@
+| Name | Age |
+|----------|----------|
+{{#each .}}
+| **{{name}}** | {{age}} |
+{{/each}}