Difference between revisions of "Command/definehighlight"

From Wiki
Jump to navigation Jump to search
(initial page)
 
(6 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
|attributes=
 
|attributes=
 
}}
 
}}
 +
 +
== [[Help:Reference|Syntax]] (autogenerated) ==
 +
<syntax>definehighlight</syntax>
  
 
== [[Help:Reference|Syntax]] ==
 
== [[Help:Reference|Syntax]] ==
Line 19: Line 22:
 
   </tr>
 
   </tr>
 
</table>
 
</table>
 
  
 
== Description ==  
 
== Description ==  
  
 +
(MkIV only)
 
''Highlights'' are a generic facility for defining and maintaining
 
''Highlights'' are a generic facility for defining and maintaining
 
different emphases.
 
different emphases.
<texcode>
+
 
 +
Highlights are respected by the XML export (see {{cmd|setupbackend}}),
 +
resulting in a tag {{code|highlight}}, with the respective names as
 +
argument to the attribute ''detail''.
 +
 
 +
When converting from font switches (as {{code|{\bf text}}} to defined highlights,
 +
be sure to convert the syntax to command syntax ( {{code|\important{text}}} ).
 +
 
 +
== Example ==
 +
 
 +
<context source=yes mode=mkiv>
 
\definehighlight [important]      [style=bold] %% define a highlight
 
\definehighlight [important]      [style=bold] %% define a highlight
 
\definehighlight [reallyimportant] [important]  %% inherit setups
 
\definehighlight [reallyimportant] [important]  %% inherit setups
Line 33: Line 46:
 
This, however, \reallyimportant{everybody} needs to know!
 
This, however, \reallyimportant{everybody} needs to know!
 
\stoptext
 
\stoptext
</texcode>
+
</context>
Highlights are respected by the
+
 
[[Command/setupbackend|XML export]],
 
resulting in a tag <code>highlight</code>, with the respective names as
 
Argument to the attribute ''detail''.
 
 
<xmlcode>
 
<xmlcode>
<document language="en" file="example-highlight" date="Sat Jun 16 12:20:48 2012" context="2012.06.13 23:46" version="0.30" xmlns:m="http://www.w3.org/1998/Math/MathML">
+
<document language="en" file="example-highlight" date="Sat Jun 16 12:20:48 2012"  
 +
          context="2012.06.13 23:46" version="0.30" xmlns:m="http://www.w3.org/1998/Math/MathML">
 
This <highlight detail="important">you</highlight> need to know.
 
This <highlight detail="important">you</highlight> need to know.
 
   <break/>
 
   <break/>
Line 45: Line 56:
 
</document>
 
</document>
 
</xmlcode>
 
</xmlcode>
The functionality is implemented in
 
[http://repo.or.cz/w/context.git/blob/HEAD:/tex/context/base/core-sys.mkiv#l197 core-sys.mkiv].
 
  
 +
== See Also ==
 +
 +
* {{cmd|setuphighlight}}
 +
* {{src|core-sys.mkiv#l197|core-sys.mkiv}}
  
 
== Help from ConTeXt-Mailinglist/Forum ==
 
== Help from ConTeXt-Mailinglist/Forum ==
Line 55: Line 68:
 
{{Forum|{{SUBPAGENAME}}}}
 
{{Forum|{{SUBPAGENAME}}}}
  
[[Category:Commands|definehighlight]]
+
[[Category:Command/Fonts|definehighlight]]
 +
[[Category:Command/MkIV only|definehighlight]]

Revision as of 14:41, 15 November 2019

\definehighlight

Syntax (autogenerated)

\definehighlight[...][...][...=...,...]
[...]name
[...]name
...=...,...inherits from \setuphighlight


Syntax

\definehighlight[...][...,...=...,...]
[...] name
[...,...=...,...] see \setuphighlight

Description

(MkIV only) Highlights are a generic facility for defining and maintaining different emphases.

Highlights are respected by the XML export (see \setupbackend), resulting in a tag highlight, with the respective names as argument to the attribute detail.

When converting from font switches (as {\bf text} to defined highlights, be sure to convert the syntax to command syntax ( \important{text} ).

Example

\definehighlight [important]       [style=bold] %% define a highlight
\definehighlight [reallyimportant] [important]  %% inherit setups
\setuphighlight  [reallyimportant] [color=red]  %% modify the copy
\starttext
This \important{you} need to know.\par
This, however, \reallyimportant{everybody} needs to know!
\stoptext

<document language="en" file="example-highlight" date="Sat Jun 16 12:20:48 2012" 
          context="2012.06.13 23:46" version="0.30" xmlns:m="http://www.w3.org/1998/Math/MathML">
This <highlight detail="important">you</highlight> need to know.
  <break/>
This, however, <highlight detail="reallyimportant">everybody</highlight> needs to know!
</document>

See Also

Help from ConTeXt-Mailinglist/Forum

All issues with: