Difference between revisions of "Inside ConTeXt"

From ConTeXt wiki
(Fixed links to renamed "command" pages, added link to "with optional arguments" page.)
(a paragraph about \protect added)
Line 1: Line 1:
 
< [[Main Page]]
 
< [[Main Page]]
  
Using variables:
+
== Using variables ==
  
 
  \setvariables[namespace][key=value]
 
  \setvariables[namespace][key=value]
 
  \getvariable{namespace}{key}
 
  \getvariable{namespace}{key}
  
Defining new commands:
+
== Defining new commands ==
 +
'''Special characters in command names'''
 +
 
 +
Some commands have special characters in their names, that TeX normally does not consider to be
 +
letters: <tt>@</tt>, <tt>!</tt> and <tt>?</tt>.
 +
Before and after the use or definition of such protected commands in your input files, the catcode of these
 +
characters has to be changed. This is done by <tt>\unprotect</tt> and <tt>\protect</tt>:
 +
 
 +
\unprotect
 +
\def\!test{alfa}
 +
\protect
 +
 
 +
The newly defined command <tt>\!test</tt> can of course only be called upon when we are in the \unprotect ed state, otherwise TEX reads the command <tt>\!</tt>, followed by the word <tt>test</tt> (and probably complains loudly about not being in math mode). These protection/unprotection commands can be nested.  When the nesting becomes deeper than one level, the system reports the current protection level. It is a good habit to always start your macro files with <tt>\unprotect</tt> and end them with <tt>\protect</tt>.
 +
 
  
 
[[Commands with KeyVal arguments|Commands with Key=Value arguments]].
 
[[Commands with KeyVal arguments|Commands with Key=Value arguments]].
  
 
[[Commands with optional arguments]].
 
[[Commands with optional arguments]].

Revision as of 12:21, 10 August 2004

< Main Page

Using variables

\setvariables[namespace][key=value]
\getvariable{namespace}{key}

Defining new commands

Special characters in command names

Some commands have special characters in their names, that TeX normally does not consider to be letters: @, ! and ?. Before and after the use or definition of such protected commands in your input files, the catcode of these characters has to be changed. This is done by \unprotect and \protect:

\unprotect
\def\!test{alfa} 
\protect 

The newly defined command \!test can of course only be called upon when we are in the \unprotect ed state, otherwise TEX reads the command \!, followed by the word test (and probably complains loudly about not being in math mode). These protection/unprotection commands can be nested. When the nesting becomes deeper than one level, the system reports the current protection level. It is a good habit to always start your macro files with \unprotect and end them with \protect.


Commands with Key=Value arguments.

Commands with optional arguments.