mirror/weewx
1
0
Fork 0
mirror of https://github.com/weewx/weewx.git synced 2026-04-19 00:56:54 -04:00
Code Issues Packages Projects Releases Wiki Activity

Noted that these commits address issue #341.

Browse Source
This commit is contained in:
Tom Keffer
2021-03-14 06:37:20 -07:00
parent 39b6e73ec9
commit d799faebd9
2 changed files with 11 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/changes.txt
View File

@@ -6,9 +6,9 @@ WeeWX change history
The utility wee_database has new options --add-column, --rename-column, and
--drop-columns for adding, renaming, and deleting columns in the database.
There is limited support for generating JSON in templates, particulary series.
Introduced limited support for generating JSON in templates, particulary series.
See the document series_tags.md in the docs subdirectory. This is still
experimental and subject to change!
experimental and subject to change! Addresses issue #341.
4.4.1 MM/DD/YYYY

19
docs/series_tags.md
View File

@@ -276,8 +276,8 @@ formatting. Here's an example:
</tr>
#for ($start, $stop, $data) in $month.outTemp.series(aggregation_type='max', aggregation_interval='day') ## 1
<tr>
<td>$start.format("%Y-%m-%d")</td> ## 2
<td>$data.format("%.2f")</td> ## 3
<td>$start.format("%Y-%m-%d")</td> ## 2
<td>$data.format("%.2f")</td> ## 3
</tr>
#end for
</table>
@@ -285,13 +285,11 @@ formatting. Here's an example:
Here, we create a table. Each row is individually formatted. Comments below refer to the marked
lines:
1. Normally, if the tag `$month.outTemp.series(aggregation_type='max', aggregation_interval='day')`
occurs in a document, Cheetah will try and convert it into a string in order to embed the
results in the generated file. However, if it is not converted into a string, the expression
actually returns a `SeriesHelper`, which internally holds the start and stop time of each
interval, as well as the aggregated data for the interval. We then _iterate_ over
the `SeriesHelper`. Iteration returns a 3-way tuple `start`, `stop`, and `data`. Each is an
instance of a `ValueHelper`, which can be formatted like any other `ValueHelper`.
1. Once evaluated, the tag `$month.outTemp.series(aggregation_type='max', aggregation_interval='day')`
returns a `SeriesHelper`. Normally, Cheetah would try to convert this into a string, in order to
embed the results in a document. However, in this case we are _iterating_ over the tag. Iteration
returns a 3-way tuple `start`, `stop`, and `data`, each an instance of `ValueHelper`, each of
which can be formatted like any other `ValueHelper`.
2. We will work only with the start times and data. On line 2, we apply a custom formatting for the
start times, so that only the date (no time) is shown.
@@ -331,7 +329,8 @@ The final results look like:
</tr>
</table>
```
This Markdown document cannot show rendered HTML, but it looks something like:
Unfortunately, this Markdown document cannot show rendered HTML but, once rendered, it would look
something like:
```
Start date Max temperature
2021-03-01 58.20°F