Difference between revisions of "Command/defineblock"

From Wiki
Jump to navigation Jump to search
m (moved Reference/en/defineblock to Command/defineblock: Text replace - "Reference/en/" to "Command/")
 
(12 intermediate revisions by 3 users not shown)
Line 4: Line 4:
 
}}
 
}}
  
 +
== [[Help:Reference|Syntax]] (autogenerated) ==
 +
<syntax>defineblock</syntax>
 
== [[Help:Reference|Syntax]] ==
 
== [[Help:Reference|Syntax]] ==
 
<table cellspacing="4" cellpadding="2" class="cmd">
 
<table cellspacing="4" cellpadding="2" class="cmd">
Line 11: Line 13:
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
 
     <td class="cmd">[...]</td>
 
     <td class="cmd">[...]</td>
     <td>name </td>
+
     <td>''name of block type''</td>
 
   </tr>
 
   </tr>
 
</table>
 
</table>
  
 +
== Description ==
 +
Blocks are reusable pieces of text. Once a block type is defined with <code>\defineblock[''name'']</code>, the blocks can be defined (with or without displaying them) using <code>\begin''name''[''tags'']</code> ... <code>\end''name''</code>. (Yes, that is <code>\begin...</code> and <code>\end...</code>, not <code>\start...</code> and <code>\stop...</code>.) There are a number of commands to display all or some of the blocks defined in the document; see the See Also section for a list with descriptions.
 +
 +
== Example ==
 +
<context source=yes text="This gives:>
 +
\defineblock[question]
 +
\hideblocks[question] % We don't want to print blocks where we define them
  
== Description ==
+
\beginquestion[first]
 +
To be, or not to be?
 +
\endquestion
 +
 
 +
\section{Let's see what blocks we've got.}
 +
\useblocks[question]
  
 +
\section{We've seen what blocks we've got. Let's take another look at that first question.}
 +
\useblocks[question][first]
  
 +
\beginquestion[last]
 +
Mais o\`u sont les neiges d'antan?
 +
\endquestion
  
== Example ==
+
</context>
<!-- Please fill in an example if you can -->
 
  
 
== See also ==
 
== See also ==
<!-- something like [[cmd:goto|\goto]] -->
+
* {{cmd|defineblock}} to define a new kind of block.
 +
* {{cmd|setupblock}} to set up block style.
 +
* {{cmd|keepblocks}} to start displaying blocks where they are defined.
 +
* {{cmd|hideblocks}} to stop displaying blocks where they are defined.
 +
* {{cmd|useblocks}} to display blocks.
 +
* {{cmd|selectblocks}} to display only blocks mentioned in the current section.
 +
* {{cmd|processblocks}} to process blocks without printing them.
 +
* {{cmd|forceblocks}}
 +
* {{cmd|nomoreblocks}} to allow one-pass compilation under certain conditions.
 +
 
 +
== Help from ConTeXt-Mailinglist/Forum ==
 +
All issues with:
 +
{{Forum|{{SUBPAGENAME}}}}
  
[[Category:Commands|defineblock]]
+
[[Category:Command/Blocks|defineblock]]

Latest revision as of 13:23, 13 October 2019

\defineblock

Syntax (autogenerated)

\defineblock[...][...][...=...,...]
[...]name
[...]name
...=...,...inherits from \setupblock


Syntax

\defineblock[...]
[...] name of block type

Description

Blocks are reusable pieces of text. Once a block type is defined with \defineblock[name], the blocks can be defined (with or without displaying them) using \beginname[tags] ... \endname. (Yes, that is \begin... and \end..., not \start... and \stop....) There are a number of commands to display all or some of the blocks defined in the document; see the See Also section for a list with descriptions.

Example

\defineblock[question]
\hideblocks[question] % We don't want to print blocks where we define them

\beginquestion[first]
To be, or not to be?
\endquestion

\section{Let's see what blocks we've got.}
\useblocks[question]

\section{We've seen what blocks we've got. Let's take another look at that first question.}
\useblocks[question][first]

\beginquestion[last]
Mais o\`u sont les neiges d'antan?
\endquestion

This gives:

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: