Cutlery/calibre
1
0
Fork 0
mirror of https://github.com/kovidgoyal/calibre.git synced 2025-10-31 02:27:01 -04:00
Code Issues Packages Projects Releases Wiki Activity

manual formatting

Browse Source
This commit is contained in:
Kovid Goyal 2020-12-24 09:58:26 +05:30
parent dfc888ef47
commit 1e123e35cf
No known key found for this signature in database
GPG Key ID: 06BC317B515ACE7C
1 changed files with 5 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
manual/template_lang.rst
View File

@ -401,19 +401,19 @@ An ``if`` produces a value like any other language expression. This means that a
* ``program: a = if field('series') then 'foo' else 'bar' fi; a`` * ``program: a = if field('series') then 'foo' else 'bar' fi; a``
* ``program: a = field(if field('series') then 'series' else 'title' fi); a`` * ``program: a = field(if field('series') then 'series' else 'title' fi); a``
The template language supports **``for`` expressions** with the following syntax: The template language supports **``for`` expressions** with the following syntax::
for <<id>> in <<expression>>: for <<id>> in <<expression>>:
<<expression_list>> <<expression_list>>
rof rof
The expression must evaluate to either a metadata field lookup key, for example ``tags`` or ``#genre``, or a comma-separated list of The expression must evaluate to either a metadata field lookup key, for example ``tags`` or ``#genre``, or a comma-separated list of
values. If the result is a valid lookup name then the field's value is fetched, otherwise the list is broken into its values. If the result is a valid lookup name then the field's value is fetched, otherwise the list is broken into its
individual values. Each resulting value in the list is assigned to the variable ``id`` then the ``expression_list`` individual values. Each resulting value in the list is assigned to the variable ``id`` then the ``expression_list``
is evaluated. is evaluated.
Example: This template removes the first hierarchical name for each value in Genre (``#genre``), constructing a list with Example: This template removes the first hierarchical name for each value in Genre (``#genre``), constructing a list with
the new names. the new names::
program: program:
new_tags = ''; new_tags = '';
@ -481,7 +481,7 @@ The full method signature is:
column_name=None, template_cache=None, column_name=None, template_cache=None,
strip_results=True, template_functions=None, strip_results=True, template_functions=None,
global_vars={}) global_vars={})
**Template writer: how to access the additional information** **Template writer: how to access the additional information**
@ -509,7 +509,7 @@ Example: the following SFM template returns either the series name or the string
The equivalent template in TPM is :: The equivalent template in TPM is ::
``{series:'ifempty($, 'no series')'}`` ``{series:'ifempty($, 'no series')'}``
The equivalent template in GPM is:: The equivalent template in GPM is::
``program: ifempty(field('series'), 'no series')`` ``program: ifempty(field('series'), 'no series')``