Difference between revisions of "Command/keepblocks"
< Command
Jump to navigation
Jump to search
(Description, example, category) |
|||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 4: | Line 4: | ||
}} | }} | ||
| + | == [[Help:Reference|Syntax]] (autogenerated) == | ||
| + | <syntax>keepblocks</syntax> | ||
== [[Help:Reference|Syntax]] == | == [[Help:Reference|Syntax]] == | ||
<table cellspacing="4" cellpadding="2" class="cmd"> | <table cellspacing="4" cellpadding="2" class="cmd"> | ||
| Line 18: | Line 20: | ||
</tr> | </tr> | ||
</table> | </table> | ||
| − | |||
== Description == | == Description == | ||
| − | From here on | + | From here on typeset blocks where they are defined, as well as when they are recalled. This is on by default in mkii, and off by default in mkiv. |
| − | |||
== Example == | == Example == | ||
| − | <context source=yes text=gives> | + | <context source=yes text="This gives:"> |
\starttext | \starttext | ||
\defineblock[myblock] | \defineblock[myblock] | ||
| − | |||
\section{Defining blocks} | \section{Defining blocks} | ||
| Line 59: | Line 58: | ||
* {{cmd|keepblocks}} to start displaying blocks where they are defined. | * {{cmd|keepblocks}} to start displaying blocks where they are defined. | ||
* {{cmd|hideblocks}} to stop displaying blocks where they are defined. | * {{cmd|hideblocks}} to stop displaying blocks where they are defined. | ||
| − | * {{cmd|useblocks}} to display blocks. | + | * {{cmd|useblocks}} to display previously defined blocks. |
* {{cmd|selectblocks}} to display only blocks mentioned in the current section. | * {{cmd|selectblocks}} to display only blocks mentioned in the current section. | ||
* {{cmd|processblocks}} to process blocks without printing them. | * {{cmd|processblocks}} to process blocks without printing them. | ||
Latest revision as of 13:24, 13 October 2019
\keepblocks
Syntax (autogenerated)
| \keepblocks[...,...][...,...] | |
| [...,...] | name |
| [...,...] | name |
Syntax
| \keepblocks[...,...,...][...,...,...] | |
| [...,...,...] | names of block classes (defined with \defineblock) |
| [...,...,...] | tags to keep, or keyword all |
Description
From here on typeset blocks where they are defined, as well as when they are recalled. This is on by default in mkii, and off by default in mkiv.
Example
\starttext \defineblock[myblock] \section{Defining blocks} \beginmyblock In Mk II, blocks are kept by default; in Mk IV, blocks are hidden by default. \endmyblock \hideblocks[myblock] \beginmyblock Potato (first, hidden where defined) \endmyblock \keepblocks[myblock] \beginmyblock Tomato (second, shown where defined) \endmyblock \section{Recalling blocks} \useblocks[myblock] \stoptext
This gives:
See also
- \defineblock to define a new kind of block.
- \setupblock to set up block style.
- \keepblocks to start displaying blocks where they are defined.
- \hideblocks to stop displaying blocks where they are defined.
- \useblocks to display previously defined blocks.
- \selectblocks to display only blocks mentioned in the current section.
- \processblocks to process blocks without printing them.
- \forceblocks
- \nomoreblocks to allow one-pass compilation under certain conditions.
Help from ConTeXt-Mailinglist/Forum
All issues with:
