Difference between revisions of "Visual Debugging"

From Wiki
Jump to navigation Jump to search
m (typo corrections.)
(a lot more traces)
Line 1: Line 1:
 
< [[Inside ConTeXt]] | [[Visuals]] >
 
< [[Inside ConTeXt]] | [[Visuals]] >
  
There's a whole lot of commands that help you analyzing and debugging your ConTeXt documents. Most of them start with <cmd>show...</cmd> or <cmd>trace...</cmd>:
+
There's a whole lot of commands that help you analyzing and debugging your ConTeXt documents. Most of them start with <cmd>show...</cmd> or <cmd>trace...</cmd>. While <cmd>showsomething</cmd> is a command that immediately inserts something, <cmd>tracesomethingtrue</cmd> or ...<tt>false</tt> is a switch that influences the behaviour of some other commands. You can check the setting with <cmd>iftrace...</cmd>. In the following we leave out the boolean value (true or false).
 +
 
 +
==Unordered==
 +
 
 +
<cmd>tracefiles</cmd> : ?
 +
 
 +
<cmd>tracepositions</cmd> : ?
 +
 
 +
<cmd>traceposstring</cmd> : ?
 +
 
 +
<cmd>traceboxplacement</cmd> : ?
 +
 
 +
<cmd>traceotr</cmd> : output routine?
 +
 
  
 
==[[Layout]]==
 
==[[Layout]]==
  
 
<cmd>showlayout</cmd> : add four pages that show margins, layout sizes etc.
 
<cmd>showlayout</cmd> : add four pages that show margins, layout sizes etc.
 +
 +
<cmd>showsetups</cmd> : type a list of all defined sizes (variables) and their values
  
 
<cmd>showmakeup</cmd> : ?
 
<cmd>showmakeup</cmd> : ?
  
 
<cmd>showframe</cmd> : ?
 
<cmd>showframe</cmd> : ?
 +
 +
===Grid, Layers and Column Sets===
 +
 +
<cmd>tracelayers</cmd> : show boxes of layers
 +
 +
<cmd>tracecolumnset</cmd> : ?
 +
 +
<cmd>tracetextareas</cmd> : ?
  
 
<cmd>showgrid</cmd> : make line grid visible
 
<cmd>showgrid</cmd> : make line grid visible
  
<cmd>showsetups</cmd> : type a list of all defined sizes (variables) and their values
+
<cmd>tracegridsnapping</cmd> : ?
 +
 
 +
===[[Tables Overview|Tables]]===
 +
 
 +
<cmd>tracetables</cmd> : ?
 +
 
 +
<cmd>traceTABLE</cmd> : ?
 +
 
 +
<cmd>tracetabulate</cmd> : ?
 +
 
 +
==[[Math]]==
  
 
<cmd>tracemathtrue</cmd> : show the layout boxes for left, middle, or right-aligned formulas.
 
<cmd>tracemathtrue</cmd> : show the layout boxes for left, middle, or right-aligned formulas.
 +
 +
<cmd>tracemathcommand</cmd> : ?
 +
 +
<cmd>tracemathcollection</cmd> : ?
 +
 +
<cmd>tracemathsymbol</cmd> : ?
 +
 +
<cmd>tracemathcharacter</cmd> : ?
 +
 +
 +
==[[Bookmarks]] and [[References]]==
 +
 +
<cmd>tracebookmarks</cmd> : ?
 +
 +
<cmd>tracelinenotes</cmd> : ?
 +
 +
<cmd>tracereferences</cmd> : ?
 +
 +
<cmd>tracelabels</cmd> : ?
 +
  
 
==[[Fonts]] and Type==
 
==[[Fonts]] and Type==
Line 34: Line 87:
  
 
<cmd>showfontstrip</cmd> : the current typeface combination, with roman, sans, math, and teletype families visualised, with x-heights
 
<cmd>showfontstrip</cmd> : the current typeface combination, with roman, sans, math, and teletype families visualised, with x-heights
 +
 +
<cmd>tracefonthandling</cmd> :
 +
 +
<cmd>tracechinese</cmd> : ?
 +
 +
<cmd>tracedfontname</cmd> : ?
 +
 +
<cmd>tracedfontencoding</cmd> : ?
 +
  
 
==[[Colors]] and Graphics==
 
==[[Colors]] and Graphics==
 +
 +
===Colors===
  
 
<cmd>showcolor</cmd> : see [[Colors]]
 
<cmd>showcolor</cmd> : see [[Colors]]
  
<cmd>showcolorgroup</cmd> :  
+
<cmd>showcolorgroup</cmd> : ?
 +
 
 +
<cmd>showpalet</cmd> : ?
 +
 
 +
<cmd>tracedgreymode</cmd> : ?
 +
 
 +
<cmd>tracedgreycolormode</cmd> : ?
 +
 
 +
<cmd>tracedrgbcolormode</cmd> : ?
 +
 
 +
<cmd>tracedcmykcolormode</cmd> : ?
 +
 
 +
<cmd>tracedspotcolormode</cmd> : ?
 +
 
 +
===Figures===
 +
 
 +
<cmd>showexternalfigures</cmd> : ?
 +
 
 +
<cmd>traceexternalfigures</cmd> : ?
 +
 
 +
<cmd>tracesidefloats</cmd> : ?
  
<cmd>showpalet</cmd> :
 
  
<cmd>showexternalfigures</cmd> :
+
===Interaction===
  
 +
<cmd>showfields</cmd> : ?
  
==Interaction==
+
<cmd>tracefields</cmd> : ?
  
<cmd>showfields</cmd> :
+
<cmd>traceJScode</cmd> : trace JavaScript code

Revision as of 16:18, 18 July 2005

< Inside ConTeXt | Visuals >

There's a whole lot of commands that help you analyzing and debugging your ConTeXt documents. Most of them start with \show... or \trace.... While \showsomething is a command that immediately inserts something, \tracesomethingtrue or ...false is a switch that influences the behaviour of some other commands. You can check the setting with \iftrace.... In the following we leave out the boolean value (true or false).

Unordered

\tracefiles : ?

\tracepositions : ?

\traceposstring : ?

\traceboxplacement : ?

\traceotr : output routine?


Layout

\showlayout : add four pages that show margins, layout sizes etc.

\showsetups : type a list of all defined sizes (variables) and their values

\showmakeup : ?

\showframe : ?

Grid, Layers and Column Sets

\tracelayers : show boxes of layers

\tracecolumnset : ?

\tracetextareas : ?

\showgrid : make line grid visible

\tracegridsnapping : ?

Tables

\tracetables : ?

\traceTABLE : ?

\tracetabulate : ?

Math

\tracemathtrue : show the layout boxes for left, middle, or right-aligned formulas.

\tracemathcommand : ?

\tracemathcollection : ?

\tracemathsymbol : ?

\tracemathcharacter : ?


Bookmarks and References

\tracebookmarks : ?

\tracelinenotes : ?

\tracereferences : ?

\tracelabels : ?


Fonts and Type

\showbodyfont : actual bodyfont family with all variants

\showbodyfontenvironment : draws a table that shows which point sizes match the relative sizes

\showsymbolset[symbolset name] : shows all the symbols within a given symbol set

\showcharacters : list of available chars of actual bodyfont encoding

\showmathcharacters : list of all the available math (non-alphabetical) characters available in math, now including all the AMS characters

\showaccents : shows A-Z and a-z with all available accents

\showstruts : make invisible characters visible

\showfontstrip : the current typeface combination, with roman, sans, math, and teletype families visualised, with x-heights

\tracefonthandling :

\tracechinese : ?

\tracedfontname : ?

\tracedfontencoding : ?


Colors and Graphics

Colors

\showcolor : see Colors

\showcolorgroup : ?

\showpalet : ?

\tracedgreymode : ?

\tracedgreycolormode : ?

\tracedrgbcolormode : ?

\tracedcmykcolormode : ?

\tracedspotcolormode : ?

Figures

\showexternalfigures : ?

\traceexternalfigures : ?

\tracesidefloats : ?


Interaction

\showfields : ?

\tracefields : ?

\traceJScode : trace JavaScript code