Changes

Jump to navigation Jump to search
3,816 bytes added ,  11:05, 9 February 2021
m
category Old Content
Page is focused on the old [[Mark_II|Mark II]] ConTeXt version, though < tt>\show...</tt> commands are still the same. Work-in-progress page on current [[Inside ConTeXtLMTX]] | version is [[VisualsDebugging]] .   There's a whole lot of commands that help you analyzing and debugging your ConTeXt documents. Most of them start with {{cmd|show...}} or {{cmd|trace...}}. While {{cmd|showsomething}} is a command that immediately inserts something, {{cmd|tracesomethingtrue}} or ...<tt>false</tt> is a switch that influences the behaviour of some other commands. You can check the setting with {{cmd|iftrace...}}. In the following we leave out the boolean value (true or false). ==Unordered== {{cmd|tracefiles}} : ? {{cmd|tracepositions}} : ? {{cmd|traceposstring}} : ? {{cmd|traceboxplacement}} : ? {{cmd|traceotr}} : output routine? {{cmd|showboxes}} : show boxes
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>:
==[[Layout]]==
<{{cmd>|showlayout</cmd> }} : add four pages that show margins, layout sizes etc. {{cmd|showsetups}} : typeset a list of all defined sizes (variables) and their values {{cmd|showmakeup}} : show some otherwise invisible markup {{cmd|showframe}} : show frames of text area, layers, boxes etc. {{cmd|showlayoutcomponents}} : To allow Acrobat Reader users (among others?) to make layers visible/invisible at will, add this command at the start of your file. ===Show attributes of visual elements=== <texcode>\usemodule [setups] \starttext % \setuphead [..,..=..,..]\showrootvalues [head] % \setuphead [chapter] [..,..=..,..]\showinstancevalues [head] [chapter] \stoptext</texcode> ===Grid, Layers and Column Sets=== {{cmd|tracelayers}} : show boxes of layers {{cmd|tracecolumnset}} : ? {{cmd|tracetextareas}} : ? {{cmd|showgrid}} : make line grid visible {{cmd|tracegridsnapping}} : ? ===[[Tables Overview|Tables]]=== {{cmd|tracetables}} : ? {{cmd|traceTABLE}} : ? {{cmd|tracetabulate}} : ? ==[[Math]]== {{cmd|tracemathtrue}} : show the layout boxes for left, middle, or right-aligned formulas. {{cmd|tracemathcommand}} : ? {{cmd|tracemathcollection}} : ? {{cmd|tracemathsymbol}}''{name of math symbol}'' : show the command (name of symbol) and the symbol itself <texcode>\tracemathcollectiontrue\tracemathsymbol{Re}\tracemathsymbol{Im}</texcode><context>\tracemathcollectiontrue\tracemathsymbol{Re}\tracemathsymbol{Im}</context> {{cmd|tracemathcharacter}} : ? ==[[Bookmarks]] and [[References]]== {{cmd|tracebookmarks}} : ? {{cmd|tracelinenotes}} : ? {{cmd|tracereferences}} : ? {{cmd|tracelabels}} : ?  == Fonts and Type== {{cmd|showbodyfont}} : actual bodyfont family with all variants <context>\setuplayout[scale=.7]\showbodyfont</context> {{cmd|showbodyfontenvironment}} : draws a table that shows which point sizes match the relative sizes <context>\setuplayout[scale=.7]\showbodyfontenvironment</context> {{cmd|showsymbolset}}[''symbolset name''] : shows all the symbols within a given symbol set <texcode>\showsymbolset[navigation 1]</texcode><context>\setuplayout[scale=.7]\showsymbolset[navigation 1]</context> {{cmd|showcharacters}} : list of available chars of actual bodyfont encoding (approx. 4 pages, MkII only) <context>\setuplayout[height=12cm,scale=.7]\setupcolors[state=start]\showcharacters</context> {{cmd|showmathcharacters}} : list of all the available math (non-alphabetical) characters available in math, now including all the AMS characters. MkII only <context>\setuplayout[height=12cm,scale=.7]\setupcolors[state=start]\showmathcharacters</context> {{cmd|showaccents}} : shows A-Z and a-z with all available accents, MkII only <context>\setuplayout[height=18cm,scale=.7]\setupcolors[state=start]\showaccents</context> {{cmd|showstruts}} : display struts (invisible placeholders for proper minimum line heights) ''(Make a better, slightly more complex example.)'' <texcode>\setupframed[framecolor=gray]\showstrutsThis will display \strut struts.\crlfFrame with struts: \framed{xxx}\crlfAnd frame without them: \framed[strut=no]{xxx}</texcode><context>\setuplayout[scale=.7]\setupcolors[state=start]\setupframed[framecolor=gray]\showstrutsThis will display \strut struts.\crlfFrame with struts: \framed{xxx}\crlfAnd frame without them: \framed[strut=no]{xxx}</context>  {{cmd|showfontstrip}} : the current typeface combination, with roman, sans, math, and teletype families visualised, with x-heights <context>\setuplayout[scale=.7]\showfontstrip</context> {{cmd|tracefonthandling}} :  {{cmd|tracechinese}} : ? {{cmd|tracedfontname}}''{Font Name}'' : Chain of synonyms for the given font name <texcode>\tracedfontname{Bold}</texcode> <context>\setuplayout[scale=.7]\tracedfontname{Bold}</context> {{cmd|tracedfontencoding}} : ?
<cmd>showmakeup</cmd> : ?== Colors and Graphics ==
<cmd>showframe</cmd> : ?===Colors===
<{{cmd>showgrid</cmd> |showcolor}} : make line grid visiblesee [[Color]]
<{{cmd>showsetups</cmd> |showcolorgroup}} : type a list of all defined sizes (variables) and their values?
<{{cmd>tracemathtrue</cmd> |showpalet}} : show the layout boxes for left, middle, or right-aligned formulas.?
==[[Fonts]] and Type=={{cmd|tracedgreymode}} : ?
<{{cmd>showbodyfont</cmd> |tracedgreycolormode}} : actual bodyfont family with all variants?
<{{cmd>showbodyfontenvironment</cmd> |tracedrgbcolormode}} : draws a table that shows which point sizes match the relative sizes?
<{{cmd>showsymbolset</cmd>[''symbolset name''] |tracedcmykcolormode}} : shows all the symbols within a given symbol set?
<{{cmd>showcharacters</cmd> |tracedspotcolormode}} : list of available chars of actual bodyfont encoding?
<cmd>showmathcharacters</cmd> : list of all the available math (non-alphabetical) characters available in math, now including all the AMS characters===Figures===
<{{cmd>showaccents</cmd> |showexternalfigures}} : shows A-Z and a-z with all available accents?
<{{cmd>showstruts</cmd> |traceexternalfigures}} : make invisible characters visible?
<{{cmd>showfontstrip</cmd> |tracesidefloats}} : the current typeface combination, with roman, sans, math, and teletype families visualised, with x-heights?
==[[Colors]] and Graphics==
<cmd>showcolor</cmd> : see [[Colors]]===Interaction===
<{{cmd>showcolorgroup</cmd> |showfields}} : ?
<{{cmd>showpalet</cmd> |tracefields}} : ?
<{{cmd>showexternalfigures</cmd> |traceJScode}} : trace JavaScript code
==Interaction=={{todo|A lot of commands and switches are still unexplained.}}
<cmd>showfields</cmd> [[Category:Basics]][[Category:Tools]][[Category:Layout]][[Category:Old Content]]
138

edits

Navigation menu