Difference between revisions of "Command/definehighlight"

From Wiki
Jump to navigation Jump to search
(initial page)
 
m (→‎See Also: link to src:search instead of line number)
 
(8 intermediate revisions by 4 users not shown)
Line 4: Line 4:
 
}}
 
}}
  
== [[Help:Reference|Syntax]] ==
+
== [[Help:Reference|Syntax]] (autogenerated) ==
 
+
<syntax>definehighlight</syntax>
<table cellspacing="4" cellpadding="2" class="cmd">
 
  <tr>
 
    <td colspan="2" class="cmd">\definehighlight<span class="first" >[...]</span><span class="second" >[...,...=...,...]</span></td>
 
  </tr>
 
  <tr valign="top" class="first">
 
    <td class="cmd">[...]</td>
 
    <td>name </td>
 
  </tr>
 
  <tr valign="top" class="second">
 
    <td class="cmd">[...,...=...,...]</td>
 
    <td>see [[Command/setuphighlight|\setuphighlight]] </td>
 
  </tr>
 
</table>
 
 
 
  
 
== Description ==  
 
== Description ==  
Line 25: Line 11:
 
''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 29:
 
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 39:
 
</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?search{{=}}highlight|core-sys.mkiv}}
  
 
== Help from ConTeXt-Mailinglist/Forum ==
 
== Help from ConTeXt-Mailinglist/Forum ==
Line 55: Line 51:
 
{{Forum|{{SUBPAGENAME}}}}
 
{{Forum|{{SUBPAGENAME}}}}
  
[[Category:Commands|definehighlight]]
+
[[Category:Command/Fonts|definehighlight]]
 +
[[Category:Command/MkIV only|definehighlight]]

Latest revision as of 10:41, 19 June 2020

\definehighlight

Syntax (autogenerated)

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


Description

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: