Cutlery/calibre
1
0
Fork 0
mirror of https://github.com/kovidgoyal/calibre.git synced 2026-01-25 05:07:11 -05:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'master' of https://github.com/cbhaley/calibre

Browse Source
This commit is contained in:
Kovid Goyal 2025-09-15 18:41:11 +05:30
commit 1acde49ce5
No known key found for this signature in database
GPG Key ID: 06BC317B515ACE7C
1 changed files with 24 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
manual/template_lang.rst
View File

@ -279,6 +279,7 @@ General Program Mode
for_range ::= 'for' identifier 'in' range_expr ':' expression_list 'rof'
range_expr ::= 'range' '(' [ start_expr ',' ] stop_expr
[ ',' step_expr [ ',' limit_expr ] ] ')'
with_expr ::= 'with' top_expression ':' expression_list 'htiw'
list_expr ::= top_expression
break_expr ::= 'break'
continue_expr ::= 'continue'
@ -381,6 +382,29 @@ If the original Genre is `History.Military, Science Fiction.Alternate History, R
Note: the last line in the template, ``new_tags``, isn't strictly necessary in this case because ``for`` returns the value of the last top_expression in the expression list. The value of an assignment is the value of its expression, so the value of the ``for`` statement is what was assigned to ``new_tags``.
**with expressions**
The ``with`` expression:
#. changes the current book to the book with calibre book id (an integer) produced by valuating the ``top_expression``.
#. runs the ``expression_list``.
#. then resets the current book back to what it was.
The ``with`` expression returns the result of the last ``top_expression`` in the evaluated
``expression_list``, or the empty string if no expression list was evaluated.
For example, this template returns a list of the titles of each book selected in the GUI::
program:
res = '';
ids = selected_books();
for id in ids:
with id:
res = (if res then res & ', ' fi) & $title
htiw
rof;
res
**Return stmt**
Return the value of the ``expression``. If executed in a function then it returns the value of the expression to the caller. If executed in the outermost context (the template) then it sets the value of the template to the value of the expression and exits the template.