ConTeXt学习笔记

欢迎加入本人建的"LuaTeX ConTeXt 学习互助"群：431714622，互助学习LuaTeX ConTeXt LaTeX相关技术，以及通过Lua、Python实现格式化文本、数据的自动排版。

注意：为了避免本博客的jinja引擎误解析，已经在{+#之间，以及对应的}之前加入空格

本文主要学习如下资料的笔记：

A not so short introduction to ConTeXt，
contextgarden wiki的笔记；

涉及LuaTeX的部分，请参见LuaTeX-CLD-TEX学习笔记。

引言#

ConTeXt格式的目标是通用排版，更适合设计；而LaTeX最初目标是数学相关的学术排版。

ConTeXt版本：

MKII，已经冻结，使用PDFTEX (和XETEX)；
MKIV，使用LUATEX (和LUAJITTEX)
LMTX，最新版，还在进化，使用LuaMetaTeX引擎

学习资源#

环境和编译#

命令#

编译脚本文档

# 默认使用LuaMetaTeX
context test.mkiv
# 或指定使用luatex
context --luatex test.mkiv

其他命令行选项(通过--help选项查看)

--run                  process (one or more) files (default action)
--make                 生成context格式文件（formats），改变系统文件时需要这样才生效
--ctx=name             use ctx file (process management specification)
--noctx                ignore ctx directives and flags
--interface            use specified user interface (default: en)
--autopdf              close pdf file in viewer and start pdf viewer afterwards
--purge                purge files either or not after a run (--pattern=...)
--purgeall             purge all files either or not after a run (--pattern=...)
--usemodule=list       load the given module or style, normally part of the distribution
--environment=list     load the given environment file first (document styles)
--mode=list            开启给定的一组模式(有条件第处理样式)
--path=list            also consult the given paths when files are looked for
--arguments=list       set variables that can be consulted during a run (key/value pairs)
--randomseed=number    set the randomseed
--result=name          rename the resulting output to the given name
--trackers=list        set tracker variables (show list with --showtrackers)
--directives=list      set directive variables (show list with --showdirectives)
--silent=list          disable logcatgories (show list with --showlogcategories)
--strip                strip Lua code (only meant for production where no errors are expected)
--errors=list          show errors at the end of a run, quit when in list (also when --silent)
--htmlerrorpage        generate html error page instead (optional: =scite)
--noconsole            disable logging to the console (logfile only)
--nodummy              don't create a dummy file (can confuse pdf viewers that keep file in view)
--purgeresult          purge result file before run
--forcexml             force xml stub
--forcecld             force cld (context lua document) stub
--forcelua             force lua stub (like texlua)
--forcemp              force mp stub
--arrange              run extra imposition pass, given that the style sets up imposition
--noarrange            ignore imposition specifications in the style
--pages                report pagenumbers of names pages and list references (--page=... or --page=...)
--jit                  use luajittex with jit turned off (only use the faster virtual machine)
--jiton                use luajittex with jit turned on (in most cases not faster, even slower)
--once                 only run once (no multipass data file is produced)
--runs                 process at most this many times
--forcedruns           process this many times (permits for optimization trial runs)
--batchmode            run without stopping and do not show messages on the console
--nonstopmode          run without stopping
--nosynctex            never initializes synctex (for production runs)
--synctex              run with synctex enabled (better use \setupsynctex[state=start])
--nodates              omit runtime dates in pdf file (optional value: a number (this 1970 offset time) or string "YYYY-MM-DD HH:MM")
--nocompression        forcefully turns off compression in the backend
--trailerid            alternative trailer id (or constant one)
--generate             生成文件数据等(如luatools的作用)，安装第三方模块时需要这样才生效
--paranoid             do not descend to .. and ../..
--version              report installed context version
--global               assume given file present elsewhere
--nofile               use dummy file as jobname

使用官方vscode扩展#

安装官方的vscode扩展说明

必须打开指定的颜色主题ConTeXt；只有语法高亮，没有Snippet（可以使用Tabnine）。

"D:/Users/ah21/AppData/Local/Programs/Microsoft VS Code/Code.exe" --extensions-dir "D:/venvs/context-win64/tex/texmf-context/context/data/vscode/extensions/" --install-extension context

vscode语法高亮插件#

ConTeXt Syntax

搜索路径#

排版脚本、宏插件、字体文件等，似乎也遵循以下规则。

以下参考：context reference manual 2.4 Directories

在工作目录中找不到的文件，ConTEXt会搜索父目录们。也就是说环境文件（environment）可以放在产品文件的父目录中。例如：

/texfiles/course/layout.tex
/texfiles/course/teacher/manual.tex
/texfiles/course/student/learnmat.tex
/texfiles/course/otherdoc/sheets.tex

后三个文件在不同的字目录中，都使用相同的环境文件layout.tex。

以下参考 https://tex.stackexchange.com/questions/330771/context-configuration

ConTeXt搜索\environment文件的次序如下：

当前目录( current directory，即运行contex的PWD，而不是tex主文件所在的PWD)
父目录 ../
祖目录 ../../
$TEXMF/tex/context// 之下的目录（$TEXMFHOME/tex/context//，在Mac/Linux中，$TEXMFHOME默认为$HOME/.texmf）

ConTeXt遵循TeX目录结构（TeX Directory Structure，简称TDS）。TDS手册：tug.org/tds/tds.html。

以下参考： https://tex.stackexchange.com/questions/192542/get-or-change-context-path-for-components-projects-environment

还可以指定路径：

\usepath[...] 寻找文件的路径，比如公用的环境文件
\usesubpath[...]

instruction 指令 /command 命令：#

control sequence 控制序列
- primitive 基元
- macro 宏
control symbol
control word

ConTeXt指令一般只分为保留字（所构成的控制符号？）和命令两类：

控制符号：\+非字母(符号)
命令：\+字母词(直到遇到一个非字母前终止，如果遇到一个或多个空白字符则将其丢弃，可用{}作为边界，或用\␣显式保留空格)

11个保留字\ % { } # ~ | $ _ ^ &；没有保留字参与的情况下，都视作一般文本。要想输入这些字符，除以下三者，都可以用\先转义： \ \backslash
~ \lettertilde
^ \letterhat

也可以用\type*{*或\type+}+输入。

组和环境#

{ ... }，或\bgroup ... \egroup，两对控制序列同义，可以混用
\begingroup ... \endgroup，允许更深层的错误检查
\start ... \stop
数学环境： $ ... $
某些命令/环境： \startSomething ... \endsomething
某些命令会自动生成一个组，如\hbox, \vbox

组是一个明示的作业单元/解释单元。组内的定义、格式、赋值，组外无效。

组还可以用来界定前面命令的作用范围/输入范围，比如 $4^2x$ 表示$4^2x$，而 $4^{2x}$ 表示$4^{2x}$

空组没有显示意义，但可以用来表示命令边界（比如避免吃掉后面的空格）。

环境一般用于段落以上的内容，除非用\bgroup ... \egroup明示为组，否则不是组。

In {\it The \TeX Book}, {\sc Knuth}
explained everything you need to know
about \TeX.

\framed{Tweedledum and Tweedledee}

\startitemize
...
\stopitemize

命令语法#

\command[Option1, Option2, ...]
\command[Variable1=value, Variable2=value, ...]
不能这样：\command[Option1, Variable1=value, ...]

成套命令#

command (or environment) 直接使用
definecommand，克隆现存command，定义别名
setupcommand，配置现存command或别名

比如： * \FRAMEDTEXT 命令 * \framedtex 实例 * \startFRAMEDTEXT ... \stopFRAMEDTEXT 环境命令 * \startframedtext ... \stopframedtext * \defineframedtext 定义实例（继承原命令的属性） * \setupframedtext 配置实例 * \setupframedtexts 一个配置多个实例

\framed[width=3cm,height=1cm]{Tweedledum}
\setupframed
[
    width=3cm,
    height=1cm
]

\defineframed[MySpecialFrame]
\setupframed
[MySpecialFrame]
[
    width=3cm,
    height=1cm
]

设置变量#

% stores value in variable namespace:key
\setvariables[namespace][key=value]
% stores the expanded value
\setevariables[namespace][key=value]
% global
\setgvariables[namespace][key=value]
% global and expanded value
\setxvariables[namespace][key=value]

\setvariables[Letter:opening]
    [before=\blank,
        after={\blank[2*big]},
    ]

% gets value of the variable namespace:key
\getvariable{namespace}{key}

\long\def\Opening#1{%
    \getvariable{Letter:opening}{before}
    \noindent{\begstrut#1\endstrut}
    \getvariable{Letter:opening}{after}
}

\setvariable{name}{key}{value}

\setvariables[var]
    [
      a=1,
      b=2,
      c=3,
    ]
\getvariable{var}{a}%returns 1

另有定义和赋值可用：Definitions_and_Assignments)

\setvalue {name}{...} = \def\name{...}
\setgvalue {name}{...} = \gdef\name{...}
\setevalue {name}{...} = \edef\name{...}
\setxvalue {name}{...} = \xdef\name{...}
\letvalue {name}=... = \let\name=...
\getvalue {name} = \name
\resetvalue {name} = \def\name{}

ConTeXt编程/系统宏#

https://wiki.contextgarden.net/System_Macros

用符号保护内部宏（一般状态下命令中不能使用符号）：

@用于底层命令
!用于内部临时的值和定义，\v!off表示内部字符串off
?表示表示内部参数的值
比如：
\s! 宏，持有系统常量
\c! 宏，持有键值对常量的键
\v! 宏，持有键值对变量的值
\?? 多语言接口常量调用
\@@ 多语言界面常量展开的结果

% 定义
\unprotect
\def\!test{alfa}
\protect

% 使用
\unprotect
\!test
\protect

分支与判断#

https://wiki.contextgarden.net/System_Macros/Branches_and_Decisions

https://wiki.contextgarden.net/Command/doif...

\doifnextcharelse
\doifundefined, \doifdefined, etc.
\doif, \doifnot, \doifelse
\doifempty, \doifnotempty, \doifemptyelse
\doifinset, \doifnotinset, \doifnotinsetelse
\doifcommon, \doifnotcommon, \doifcommonelse
\doifsamestringelse,\doifsamestring,\doifnotsamestring
\doifinstringelse,\doifincsnameelse
\doifnumberelse
\doifassignmentelse
\doifsamestringselse,\doifsamestring,\doifnotsamestring
\doiftext, \doiftextelse — empty string
\doifrightpageelse (precede by \signalrightpage)
\doifdocumentargument
\doifelseindented (LMTX only)

循环与递归#

https://wiki.contextgarden.net/System_Macros/Loops_and_Recursion

\dorecurse {10} {whatever we want in level \recurselevel and at depth \recursedepth}，循环固定次数，可嵌套，有保存次数和深度的宏（隐藏了真实的计数器）。生成表格时，可能需要使用\expanded控制展开
\dostepwiserecurse {from} {to} {step} {action}，按步子循环，是\dorecurse的复杂形式
\doloopoverlist {a, b, c} {current letter is: “\recursestring”\par}，迭代一个列表
\doloop{Some kind of typesetting punishment \par \ifnum\pageno>100 \exitloop \fi}，循环与跳出，有\exitloop \exitloopnow \recurselevel \recursedepth可用
Recursion and expansion

条件切换/处理行为#

https://wiki.contextgarden.net/System_Macros/Action_Processing

\processaction [x] [a=>\a,b=>\b,c=>\c]
\processfirstactioninset [x,y,z] [a=>\a,b=>\b,c=>\c]
\processallactionsinset [x,y,z] [a=>\a,b=>\b,c=>\c]

主要用于键值对参数的处理

\processaction
    [\TESTwidth] % should expand to 'small'
    [small=>\message{small was chosen},
     medium=>\message{medium was chosen}]

\processallactionsinset
    [x,y,z]
    [a=>\a,
     b=>\b,
     c=>\c,
     default=>\default,
     unknown=>\unknown{... \commalistelement ...}]

% \processaction不可完全展开，替代方案是用lua表：
\def\MyMacro#1{\directlua{
    local known = {a = '\a', b = '\b'}
    tex.sprint(known['#1'] or '\a')}}

逗号分割列表的处理#

https://wiki.contextgarden.net/System_Macros/Comma_Separated_Lists

\processcommalist[string,string,...]\commando
\processcommacommand[string,\stringset,string]\dosomething
\processcommalistwithparameters[string,string,...]\dosomething
\rawprocesscommalist[string,string,...]\commando
\dogetcommalistelement1\from a,b,c\to\commalistelement
\commalistsentence

\def\dosomething#1{(#1)}
1: \processcommalist [\hbox{$a,b,c,d,e,f$}] \dosomething \par
2: \processcommalist [{a,b,c,d,e,f}]        \dosomething \par
3: \processcommalist [{a,b,c},d,e,f]        \dosomething \par
4: \processcommalist [a,b,{c,d,e},f]        \dosomething \par
5: \processcommalist [a{b,c},d,e,f]         \dosomething \par
6: \processcommalist [{a,b}c,d,e,f]         \dosomething \par
7: \processcommalist []                     \dosomething \par
8: \processcommalist [{[}]                  \dosomething \par

\rawdoifinsetelse{string}{string,...}{...}{...}
\rawprocesscommalist[string,string,...]\commando
\rawprocessaction[x][a=>\a,b=>\b,c=>\c]

\getcommalistsize    [string,string,...]
\getcommacommandsize [string,\strings,string,...]

定义命令#

直接是用tex的\def，或者\define，或者前述定义和赋值\setvalue \getvalue

\define[NumArguments]\CommandName{TeXtToReplace}

NumArguments，参数数量，可省略。
CommandName，命令名称，遵守一般命令名规范，可以是单个非字母，或一个至多个字母
TextToReplace，命令展开后原位置要替换成的文本，包括格式。

\define 相当于\unexpanded\def； \defineexpandable 相当于 \def.

\define\Tite{\quotation{O Tite tute Tati tibi tanta tyranne tulisti}}

\define[2]\LetterHeading{
    \rightaligned{Peter Smith}\par
    \rightaligned{Consultant}\par
    Maryborough, \date\par
    #1\ #2,\par
}

\LetterHeading{Dear Ms}{Eloise Merriweather}

命名参数#

mkvi(扩展名，或脚本首行标出% macros=mkvi)格式可以使用命名参数，而不限于编号参数:

\def\TestFour[#one]#two%
   {\def\TestFive[#alpha][#one]%
      { #one, #two, #alpha}}
\TestFour [one]{two}

\starttexdefinition TestSix #oeps
     here: #oeps
\stoptexdefinition
\TestSix  {one}

详见

可选参数#

参数的处理：

https://wiki.contextgarden.net/System_Macros/Handling_Arguments

分两步处理可选参数：

https://wiki.contextgarden.net/Commands_with_optional_arguments

% \dosingleempty, \dodoubleempty, \dotripleempty, ...
\def\mynewcommand{\dosingleempty\doMyNewCommand}
\def\doMyNewCommand[#1]#2{%
    % \ifsecondargument 
    \iffirstargument
        There is an optional parameter: {\bf #1}\par%
    \else
        No optional parameter\par%
    \fi
    This is the mandatory text: {\em #2}%
}

\starttext
    \mynewcommand[opt]{Hello People}
    \blank
    \mynewcommand{Hello People}
\stoptext

系统命令还使用：

\doifassignmentelse {...} {then ...} {else ...}
\checkparameters[argument] ... \ifparameters

键值对参数#

参考 * Commands_with_KeyVal_arguments) * 系统宏的键值对参数

lua用例：

\startluacode
userdata = userdata or { }

function userdata.mycommand(keywords, keyvals) 
    keyword_options = utilities.parsers.settings_to_array(keywords)
    named_values = utilities.parsers.settings_to_hash(keyvals)

    -- do stuff based on that array and that hashtable.
end
\stopluacode

\def\mycommand[#1][#2]{\ctxlua{userdata.mycommand('#1', '#2')}} % 使用长字符串更可靠：[==[#1]==]

\mycommand[top, inmargin, now][color=green, roof=gabled]

ConTeXt和tex用例见链接。

关于用lua处理命令的逻辑，另见Programming_in_LuaTeX

定义环境/startstop宏/成对命令#

\definestartstop[Name][Options]

\definestartstop[TextWithBar][
    before=\startmarginrule\noindentation, % 如果希望此环境是一个组，则必须明式加入\bgroup
    after=\stopmarginrule, % 同上，加入\egroup
    style=\ss\sl
]

\starttext
    The first two fundamental laws of human stupidity state unambiguously that:
    \startTextWithBar
        \startitemize[n,broad]
            \item Always and inevitably we underestimate the number of stupid individuals in the world.
            \item The probability that a given person is stupid is independent of any other characteristic of the same person.
        \stopitemize
    \stopTextWithBar
\stoptext

构建成套的命令#

Definitions_and_Assignments)

tex原语\csname可用于构建用\def和\let不能构建的命令：

\csname if\strippedcsname\something\endcsname
% 展开后得到\ifsomething，\strippedcsname用于重用命令的名称

前后缀控制等详情见链接。

尺寸#

尺寸的定义、获取、转换、计算、存储，参考 https://wiki.contextgarden.net/Dimensions

Name	Name in ConTEXt	Equivalent
Inch	in	1 in = 2.54 cm
Centimetre	cm	2.54 cm = 1 inch
Millimetre	mm	100 mm = 1 cm
Point	pt	72.27 pt = 1 inch
Big point	bp	72 bp = 1 inch
Scaled point	sp	65536 sp = 1 point
Pica	pc	1 pc = 12 points
Didot	dd	1157 dd = 1238 points
Cicero	cc	1 cc = 12 didots
当前“M”的宽度	em
当前“x”的高度	ex

% 改变段落缩进的三种形式
\parindent=0pt
\parindent 0pt
\parindent0pt

% 等同于
\noindentation

某些尺寸使用弹性赋值

\MeasureName plus MaxIncrement minus MaxDecrease

1	`\parskip 3pt plus 2pt minus 1pt`

获取测量文本的高度，并据此缩放另一文本：

\starttext
M\scale[height=\heightofstring{M}]{a}M
\stoptext

输入特殊字符#

空格和tab \␣
不断行空格 ~
两个以上的断行为段（显示为空行），也可用一个显式空行\blank代替
有时断行被解释为一个空格，而行尾注释%以避免引入空格（写宏的时候）
破折号与连接号：断词用-，输入-或\hyphen；连接数字用–，输入--或\endash；连接句子用—，输入---或\emdash；减号/负号用−，输入 $-$ 或\minus。

文档与项目结构#

% First line of the document
% Preamble area:
% Containing the global configuration
% commands for the document
\starttext % The body of the document begins here
...
... % Document contents
...
\stoptext % End of the document

插入文件内容

\input FileName
\ReadFile{FileName} % 文件不存在时不会报错
\readfile{FileName}{TextIfExists}{TextIfNotExists}

% General configuration commands:
\input MyConfiguration
\starttext
\input PageTitle
\input Preface
\input Chap1
\input Chap2
\input Chap3
...
\stoptext

环境文件

命名法：MyMacros_env.tex或env_MyMacros.tex

\startenvironment MyEnvironment
    \mainlanguage[en]
    \setupbodyfont[modern]
    \setupwhitespace[big]
    ...
\stopenvironment

插入环境文件内容的方法：

\environment File
\environment[File]

组件文件

\environment MyEnvironment
\environment MyMacros
\startcomponent Chapter1
    \startchapter[title={Chapter 1}]
    ...
\stopcomponent

成品文件

\environment MyEnvironment
\environment MyMacros
\startproduct MyBook
    \component Chapter1
    \component Chapter2
    \component Chapter3
    ...
\stopproduct

项目文件

\startproject MyCollection
    \environment MyEnvironment
    \environment MyMacros
    \product Book01
    \product Book02
    \product Book03
    ...
\stopproject

页面和分页#

版面逻辑尺寸和印刷物理尺寸（通常一致） \setuppapersize[LogicalPage][PhysicalPage]
自定义尺寸常量： \definepapersize
拼版 \setuparranging
显式版面框架： \showframe

文档任何位置都可以重设。

纸张适配内容

\startfittingpage ... \stopfittingpage
- \startTEXpage ... \stopTEXpage，TeX文本适配页
- \startMPpage ... \stopMPpage， MetaPost图形适配页，直接写MetaPost代码，不再需要\startMPcode...\stopMPcode
\startpagefigure，单一图页面

分页：

\pagebreak
\page

页面元素和版面布局#

5X5块加空布局；
头、顶；脚、底；左右边、沿；

\setuplayout[Name] [Options]

给页面组件设置尺寸
设置逻辑页在物理页上的位置（结合\setuparranging设置逻辑页布局方式）

多种页面布局：

\definelayout[Name/Number][Configuration]
\setuplayout[LayoutName]
...
\setuplayout[reset]

调整指定页面的高度或行数，用于定版前的微调，放导言区：

\adaptlayout[Pages] [Options]

指定布局的页码范围，在导言区：

\definelayout[1][...]
\definelayout[3][reset]

单双页布局：

\definelayout[even]
\definelayout[odd]

展示页面布局：

\showsetups
\showframe
\showlayout，兼有前二者的功能

获取版心/文本区域宽高：

\textwidth
\textheight

设置页码#

\setuppagenumbering
\setupuserpagenumber

配合\defineconversionset使用

获取页码：

\userpagenumber，用户定制页码
\pagenumber，页码的阿拉伯数字
\realpagenumber，未考虑定制的实际页码的数字

对应形式的末页页码：

\lastuserpagenumber
\lastpagenumber
\lastrealpagenumber.

建议分页/不分页、强制分页#

\page, \pagebreak

选项：

no，不建议分页
preference，建议分页
bigpreference，强烈建议分页

选项：

yes，强制分页
makeup，立即分页，不预先放置挂起的浮动体
empty，插入空页
even，插入页直到双页
odd，插入页直到单页
left, right，同前两项，仅用于根据单双页转换不同天头、地脚和页边的双册印刷文档
quadruple，插入页直到4的倍数页

TEX boxe是不能分页的

\vbox{Material}

有些环境使用了盒子，如framedtext，也不会分页。

限制若干行内容在同一页，期间不得分页：

\testpage[10]
\input knuth

天头、地脚的配置#

\setupheadertexts
\setupfootertexts

\setupfootertexts[pagenumber] % 居中显式
\setupheadertexts[Preface][pagenumber] % 左右分别显式

可选参数（这些符号名称只能单独使用，否则视作普通字符串）：

日期：date, currentdate;
页码：pagenumber;
结构： part, chapter, section...;
结构序号： partnumber, chapternumber, sectionnumber...

也可使用相应的命令：

\date \currentdate \pagenumber \getmarking[chapter] \getmarking[chapternumber] \getmarking[sectionnumber]

格式化配置：

\setupheader
\setupfooter

定义后链接到小节命令中：

\definetext[ChapterFirstPage] [footer] [pagenumber]
\setuphead[chapter][header=high, footer=ChapterFirstPage]

关闭当天页的天头地脚\noheaderandfooterlines

生成无页码的页\page[blank]

页面外边edges、内边margins插入元素#

\setuptoptexts: 上边
\setupbottomtexts: 下边
\margindata，实例：
- \inleftmargin defined as \definemargindata[inleftmargin][left][margin=margin,width=\leftmarginwidth,style=,color=]
- \inrightmargin defined as \definemargindata[inrightmargin][right][margin=margin,width=\rightmarginwidth,style=,color=]
- \inoutermargin defined as \definemargindata[inoutermargin][outer][margin=margin,width=\outermarginwidth,style=,color=]
- \ininnermargin defined as \definemargindata[ininnermargin][inner][margin=margin,width=\innermarginwidth,style=,color=]
- \inleftedge defined as \definemargindata[inleftedge][left][margin=edge,width=\leftedgewidth,style=,color=,category=edge]
- \inrightedge defined as \definemargindata[inrightedge][right][margin=edge,width=\rightedgewidth,style=,color=,category=edge]
- \inouteredge defined as \definemargindata[inouteredge][outer][margin=edge,width=\outeredgewidth,style=,color=,category=edge]
- \ininneredge defined as \definemargindata[ininneredge][inner][margin=edge,width=\inneredgewidth,style=,color=,category=edge]
- \atleftmargin defined as \definemargindata[atleftmargin][left][margin=normal,width=\leftmarginwidth,style=,color=]
- \atrightmargin defined as \definemargindata[atrightmargin][right][margin=normal,width=\rightmarginwidth,style=,color=]
- \inleft defined as \definemargindata[inleft][left][margin=margin,width=\leftmarginwidth,align=flushright]
- \inright defined as \definemargindata[inright][right][margin=margin,width=\rightmarginwidth,align=flushleft]
- \inouter defined as \definemargindata[inouter][outer][margin=margin,width=\outermarginwidth,align=inner]
- \ininner defined as \definemargindata[ininner][inner][margin=margin,width=\innermarginwidth,align=outer]
- \inmargin defined as \definemargindata[inmargin][left][margin=margin,width=\leftmarginwidth,align=flushright]
- \inother defined as \definemargindata[inother][right][margin=margin,width=\rightmarginwidth,align=flushleft]
- \margintext defined as \definemargindata[margintext][left][margin=margin,width=\leftmarginwidth,align=flushright,stack=yes]

语法：

\CommandName[Reference][Configuration]{Text}

全局配置页边文本：

\setupmargindata[right][style=slanted]

字体脚本 typescript#

官方配置脚本（增补）

D:\venvs\texlive\2021\texmf-dist\tex\context\fonts\mkiv\type-imp-mscore.mkiv

用法参考： https://wiki.contextgarden.net/Chinese_Japanese_and_Korean

增补用法：

% Enable fonts
\usetypescriptfile[mscore]
% \usebodyfont   [mschinese,12pt]
% \usebodyfont   [mschinese-light,12pt]
\usebodyfont   [mschinese-literate,12pt]
% 或
% \setupbodyfont [mschinese-literate,12pt]
\definebodyfontenvironment[24pt]
\definebodyfontenvironment[18pt]

拼音字体设置

% tex/texmf-fonts/tex/context/user/type-ahpinyin.tex
\starttypescript [ahpinyin]
% \definefontsynonym[Human readable]       [file:filename without extension]
  \definefontsynonym[NotoSerif-Regular]    [file:AHPinYin]
  \definefontsynonym[NotoSerif-Italic]     [file:AHPinYin]
  \definefontsynonym[NotoSerif-Bold]       [file:AHPinYin]
  \definefontsynonym[NotoSerif-BoldItalic] [file:AHPinYin]
\stoptypescript

\starttypescript [ahpinyin]
  \setups[font:fallback:serif]          % 安全设置: 如果没有发现时使用备用字体
% \definefontsynonym[ConTeXt basics name] [Human readable]       [features=default]
  \definefontsynonym[Serif]                [NotoSerif-Regular]    [features=default]
  \definefontsynonym[SerifItalic]          [NotoSerif-Italic]     [features=default]
  \definefontsynonym[SerifBold]            [NotoSerif-Bold]       [features=default]
  \definefontsynonym[SerifBoldItalic]      [NotoSerif-BoldItalic] [features=default]
\stoptypescript

% #3. 把"ahpinyin"字体脚本中的四种变体包定义为calligraphic typeface
\starttypescript [ahpinyin]
  \definetypeface [ahpinyin]  [cg] [calligraphic] [ahpinyin]    [default]
\stoptypescript

% 使用字体脚本`type-ahpinyin.tex`设置拼音字体
% \usetypescriptfile[ahpinyin]
% \definefont[pinyin][ahpinyin]
% 或者直接使用
% \definefont[pinyin][name:ahpinying*default at 9pt]

更新手动安装的（outside of tlmgr）文件数据：context --generate

中文字体设置

参考： http://liyanrui.is-programmer.com/2009/10/21/not-just-for-chinese.12264.html

% 字体脚本typescript `type-myfonts.tex`
% 定义一个脚本，名为[serif][zhfont]，衬线体
\starttypescript[serif][zhfont]
    % 字体各变体与系统中对应的字体名称
    \definefontsynonym[Serif][name:adobesongstd]
    \definefontsynonym[SerifBold][name:adobesongstd]
    \definefontsynonym[SerifItalic][name:adobesongstd]
    \definefontsynonym[SerifBoldItalic][name:adobesongstd]
\stoptypescript

% 再定义一个脚本，名为[sans][zhfont]，无衬线体
\starttypescript [sans][zhfont]
    \definefontsynonym[Sans][name:adobeheitistd]
    \definefontsynonym[SansBold][name:adobeheitistd]
    \definefontsynonym[SansItalic][name:adobeheitistd]
    \definefontsynonym[SansBoldItalic][name:adobeheitistd]
\stoptypescript

% 再定义一个脚本，名为[mono][zhfont]，等宽字体
\starttypescript [mono][zhfont]
    \definefontsynonym[Mono][name:adobefangsongstd]
    \definefontsynonym[MonoBold][name:adobefangsongstd]
    \definefontsynonym[MonoItalic][name:adobefangsongstd]
    \definefontsynonym[MonoBoldItalic][name:adobefangsongstd]
\stoptypescript

% 定义脚本[myfonts]，其中定义typeface
\starttypescript[myfonts]
    % 定义typeface[myfonts]，
    % 使用[serif][zhfont]为rm字体
    \definetypeface[myfonts][rm][serif][zhfont]
    % 使用[sans][zhfont]为ss字体
    \definetypeface[myfonts][ss][sans][zhfont]
    % 使用[mono][zhfont]为tt字体
    \definetypeface[myfonts][tt][mono][zhfont]
\stoptypescript

在文稿中使用：

% 使用字体脚本文件
\usetypescriptfile[myfonts]
% 使用字体脚本
\usetypescript[myfonts]
% 设置主字体
\setupbodyfont[myfonts,rm,12pt]

\starttext

所有动物都生而平等，但有些动物比其他动物更平等

\ss 所有动物都生而平等，但有些动物比其他动物更平等

\tt 所有动物都生而平等，但有些动物比其他动物更平等

\stoptext

定义后备字体（多语言字体）newsong：

\definefontsynonym[song][name:adobesongstd]
% 指定应用范围的后备字体
\definefontfallback[hereos][name:texgyreherosregular][0x0000-0x0400]
\definefontsynonym[fbsong][song][fallbacks=hereos]
\definefont[newsong][fbsong]

安装字体#

字体文件可以出放在tex/texmf-fonts/fonts/，或tex/texmf-fonts/fonts/truetype/vendor/fontfamily（注意对应字体类型）

使用系统字体，先设置环境变量：

set OSFONTDIR=C:\Windows\Fonts

索引：

mtxrun --generate mtxrun --script font --reload

查找你想要字体（包括文件名和符号名称），比如：

mtxrun --script fonts --list --all --pattern=pinin

identifier         familyname   fontname    filename                        subfont   instances
---
ahpinying          ahpinying    ahpinying   c:/windows/fonts/AHPinYin.TTF
ahpinyingnormal    ahpinying    ahpinying   c:/windows/fonts/AHPinYin.TTF
ahpinyingregular   ahpinying    ahpinying   c:/windows/fonts/AHPinYin.TTF

或列出四种特性：

mtxrun --script fonts --list --spec deng-light

familyname   weight   style    width    variant   fontname        filename                     subfont   fontweight
dengxian     light    normal   normal   normal    dengxianlight   c:/windows/fonts/Dengl.ttf

weight black bold demi demibold extrabold heavy light medium mediumbold normal regular semi semibold ultra ultrabold ultralight
style italic normal oblique regular reverseitalic reverseoblique roman slanted
width book condensed expanded normal thin
variant normal oldstyle smallcaps

字体还可用关键字匹配查询（查找算法比较灵活而复杂/不可靠）

当一个字体文件被分列为多条时，如：

notoserifcjksc             notoserifcjksc      notoserifcjkscregular      c:/windows/fonts/NotoSerifCJKsc-Regular.otf
notoserifcjkscnormal       notoserifcjksc      notoserifcjkscregular      c:/windows/fonts/NotoSerifCJKsc-Regular.otf
notoserifcjkscregular      notoserifcjksc      notoserifcjkscregular      c:/windows/fonts/NotoSerifCJKsc-Regular.otf

首次无法通过字体文件名或关键字匹配查询来使用，而只能通过主条（最短一条）的identifier（即notoserifcjksc）使用；此后可一通过关键字匹配查询来使用（可能是优先匹配已缓存字体的缘故）。

汉字字间拉伸胶：scrp-cjk.lua，一个测试版本确实补偿了蹩脚的半宽，但我们最好在字体定义时进行补偿，并且/或者只是假设一个正确的字体。

字体颜色特性

颜文字着色

\definefontfeature[colored][colr=yes]
\definefontsynonym[Emoji][file:seguiemj.ttf*default,colored]
\definesymbol[bug][\getglyphdirect{Emoji}{\char"1F41B}]
\definesymbol[ant][\getglyphdirect{Emoji}{\char"1F41C}]
\definesymbol[bee][\getglyphdirect{Emoji}{\char"1F41D}]

% 或者用svg
\definefontfeature[svg][svg=yes]
\definefontsynonym[Emoji][file:emojionecolor-svginot.ttf*default,svg]

字体知识#

\setupbodyfont[Options] 设置主字体，影响相关文本元素（如标题），字号范围有限定
\switchtobodyfont 在特定范围切换正文字体，字号会伸缩至指定大小，不影响标题字号
\showbodyfont[Options] 查看字体字号信息
\showfont[FontName]

显式主体字体（风格*变形+字号）\showbodyfont[schola, 8pt]

字体抽象层次：

typeface 字面/字体（所有字体的总称）
font family / font style 字体风格/字体家族，有特定设计特征的多个字体构成的集合；也可以随意指定不同字体为一族。
- font 字体（字面的子集，有特定的尺寸、字重、风格等）
  - alternative 变体
    - glyph/character 字模

font style 字体风格/字体家族

Style	Symbolic names & Commands
Roman	\rm, \roman, \serif, \regular
Sans Serif	\ss, \sans, \support, \sansserif
Monospaced	\tt, \modo, type, \teletype
Handwritten	\hw, \handwritten
Calligraphic	\cg, \calligraphic

font alternative 字体变体

Alternative	Commands that enable it
Normal	\tf(typeface), \normal
Italic	\it, \italic
Bold	\bf(boldface), \bold
Bold-italic	\bi, \bolditalic, \italicbold
Slanted	\sl, \slanted
Bold-slanted	\bs, \boldslanted, \slantedbold
Small caps	\sc, \smallcaps
Medieval	\os, \mediaeval

6个改变字号的变体后缀

{\tfxx test}, {\tfx test}, {\tf test}, {\tfa test}, {\tfb test}, {\tfc test}, {\tfd test}

在段落开头使用临时切换字体命令时，推荐前置\dontleavehmode，以免发生意外的副作用

定制后缀的缩放权重（主字体环境）

\definebodyfontenvironment[particular size][scaled]
- \definebodyfontenvironment[10pt][a=12pt,b=14pt,c=2, d=3]
\definebodyfontenvironment[default][scaled]
- \definebodyfontenvironment[default][a=1.3,b=1.6,c=2.5,d=4]

除后缀外，以下关键词也可以定制：big, small, script, scriptscript，会影响这些命令：

\smallbold
\smallslanted
\smallboldslanted
\smallslantedbold
\smallbolditalic
\smallitalicbold
\smallbodyfont
\bigbodyfont

显式后缀的缩放权重（主字体环境）

\showbodyfontenvironment[Font]

为字体风格、变形、尺寸定义命令和关键词

\definebodyfontswitch[eight][8pt]
\definefontstyle[paloseco][ss]
\definefontstyle[paloseco, sosa, sinrebordes][ss]
\definealternativestyle[strong][\bf][]

意大利体、斜体和强调体 \it, \sl and \em

\setupbodyfontenvironment[default][em=italic]

小型大写与伪小型大写 Small caps and fake small caps

\cap and \Cap

定义字体#

然后定义名称后使用\definefont[pinyin][name:ahpinying*default at 9pt]（或定义后立即自动使用\definedfont）。格式如下：

\definefont[PublicReference][filename*featurenames scaling] % filename可以附加前缀name:，表示使用符号名称； file:表示使用文件名，可以使用后缀.ttf等；featurenames可以使用预制的default，或使用\definefontfeature定义
\definefont[PublicReference][filename:featurespecication scaling] % 仅用户XƎTEX样式的字体
\definefont[PublicReference][filename@virtualconstructor scaling] % 适用于虚拟字体，如数学字体，虚拟特性可参考m-punk.mkiv文件

指定字号的方法：

at 72pt，有赖于设计尺寸，不可靠
scaled 2400，硬编码缩放（以1000为零点）
sa 2.4，相对于body font尺寸缩放，scaled at the body font size
- \definefont [TitleFont] [Serif sa b]
- \definefont [TitleFont] [Serif]，会转换为\definefont [TitleFont] [Serif sa *]，展开为当前字体尺寸

定义字体家族和后备字体：

https://wiki.contextgarden.net/Command/definefontfamily

\definefallbackfamily [documentfont] [rm] [notoserifcjksc] [preset=range:chinese] % 例外，见下
\definefallbackfamily [documentfont] [ss] [Noto Sans CJK SC][preset=range:chinese]
\definefallbackfamily [documentfont] [tt] [Noto Sans Mono CJK SC][preset=range:chinese]

\definefontfamily [documentfont] [rm] [Noto Serif]
\definefontfamily [documentfont] [ss] [Noto Sans]
\definefontfamily [documentfont] [tt] [Noto Sans Mono]

\setupbodyfont [documentfont]

\definefontfamily [windows] [rm] [Times New Roman]
\definefontfamily [windows] [ss] [Arial]
\definefontfamily [windows] [tt] [Courier New] [features=none]
\definetypeface   [windows] [mm] [math] [termes] % use \definetypeface
to load a math font

\setupbodyfont[windows]

\starttext
\showbodyfont
\stoptext

颜色#

\definehighlight[important][color=red]
- \important{Very important text}
\color[ColourName]{Text to colour}
- \color[red]{Very important text}
\colored[r=0.1, g=0.8, b=0.8]{coloured}
\startcolor[ColourName] ... \stopcolor
\setupcolors[textcolor=red]
\setuphead[chapter][color=blue]
\setupbackgrounds[page][background=color,backgroundcolor=blue]

预定义颜色

Name	Light tone	Medium tone	Dark tone
black
white
gray	lightgray	middlegray	darkgray
red	lightred	middlered	darkred
green	lightgreen	middlegreen	darkgreen
blue	lightblue	middleblue	darkblue
cyan		middlecyan	darkcyan
magenta		middlemagenta	darmagenta
yellow		middleyellow	darkyellow

预定义色谱

\showcolor[CollectionName]
\showcolorcomponents[ColourName]
- \showcolorcomponents[darkgoldenrod]
\usecolors[CollectionName]
- \usecolors[xwi]
- \color[darkgoldenrod]{Tweedledum and Tweedledee}
“crayola”, 235 colours imitating marker shades.
“dem”, 91 colours.
“ema”, 540 colour definitions based on colours used by Emacs.
“rainbow”, 91 colours for use in maths formulas.
“ral”, 213 colour definitions from the Deutsches Institut für Gütesicherung und Kennzeichnung (German Institute for Quality Assurance and Labelling).
“rgb”, 223 colours.
“solarized”, 16 colours based on the solarized scheme.
“svg”, 147 colours.
“x11”, 450 standard colours for X11.
“xwi”, 124 colours.

自定义颜色

\definecolor[New colour][Old colour]
- \definecolor[maincolour][0.6(orange)]
\definecolor[ColourName][Definition]
- \definecolor[lime 1][r=0.75, g=1, b=0]
- \definecolor[lime 2][x=BFFF00]
- \definecolor[lime 3][c=0.25, m=0, y=1, k=0]
- \definecolor[lime 4][h=75, s=1, v=1]
- \definecolor[Azure][h=75, w=0.2, b=0.7]
- \definecolor[light grey][s=0.65]

文档结构#

标题#

https://wiki.contextgarden.net/Titles

章节/题目

有编号	无编号
\part	—
\chapter	\title
\section	\subject
\subsection	\subsubject
\subsubsection	\subsubsubject
\subsubsubsection	\subsubsubsubject
\subsubsubsubsection	\subsubsubsubsubject

无编号标题不会出现在目录中（可设置）。

均有Start/Stop版本，方便导出为电子书。

以上都是\SECTION的实例，各有三种用法，以及startstop实例： * \SECTION[reference,...]{text} * \SECTION[reference,...]{number}{text} * \SECTION[...=...,...] * title text * bookmark text * marking text * list text * reference reference * ownnumber text * placeholder text * \startSECTION[...=...,...][...=...,...] ... \stopSECTION，第一个选项同前

ownnumber用于指定编号，替换本处的自动编号；他处自动编号不受影响，即可能造成编号不连续！

% 自定义计数器，遇到新section时重置（\defineresetset只能设定重置与否/连续编号，不能指定重置范围）
\definecounter[mynumber][way=bysection]
\incrementcounter[mynumber]
%转换成汉字编号后应用
\subsubsection[title=标题文本,reference=引用名, ownnumber={\convertnumber{cn}{\rawcountervalue[mynumber]}}]

设置：

\setuphead [Sections][Options]
\setupheads [Sections][Options]

选项：

placehead： whose values can be “yes”, “no” “hidden”, “empty” or “section
number， “yes” and “no”
“before” “after，标题排版前后执行的命令
- before=\hairline，before=\blank，before={\blank[3*big]}
- after={\blank[0cm]},before={\blank[0cm]}
- before={\nowhitespace},after={\nowhitespace\vskip5pt}
commandbefore” and“commandafter”，标题文本排版前后执行的命令
continue=no
page，前插页
alignment，“align”会影响包含标题的段落的alignment。可包含“flushleft”(left), “flushright” (right), “middle” (centred), “inner” (inner margin) and “outer” (outer margin)等值。
Margin
Width
indentnext
alternative，插入时的替代版式：text paragraph normal margin inmargin top middle bottom reverse margintext
textdistance，标题文本距离
interlinespace，行间距

有编号的设置会影响无编号，反之不然。上一级的设置会可能影响下一级，反之不然。

用 \nolist or \nomarking在目录中排除指定字符：

\chapter{Influences of \nomarking{19th century} impressionism \nomarking{in the 21st century}}

获取章节编号headnumber:

first:   \someheadnumber[chapter][first]   \par
current: \someheadnumber[chapter][current] \par
last:    \someheadnumber[chapter][last]

必须实际有编号，否则为空。

https://wiki.contextgarden.net/Last_Head_Number

忽略文档结构的独立编号结构（比如贯穿全书的“点评”编号）的实现：Headings_numbered_independent_of_chapters_or_other_headings

目录#

官方文档

目录是内置的联合列表(combinedlist)。

设置目录联合列表：\setupcombinedlist[content][list={chapter,section},alternative=c]
- list选项指定head级别，\definehead自定义级别必须额外指定
- alternative选项指定版式：a...g，可通过\setuplist设置
设置目录的pdf交互：\setupinteraction[state=start,focus=width]
放置目录：
- \completecontent，会在目录前自动生成 \title{目录}，目录标题名称可以更改：\setupheadtext[chinese][content=目次]
- \placecontent，根据放置位置生成其下各级目录，如放在章、节下则只能显式本章、节之下的目录
  - criterium选项指定内容：all previous [part, chapter, section, subsection..] component
条目格式化 \setuplist[Element][Configuration]
- \definelistalternative定义alternative

默认只加入编号的目录， 手动加入未编号head级别：\setuphead[title][incrementnumber=yes]

手动加入指定head实例：

\subject{Bibliography}
\writetolist[section]{}{Bibliography}

条目间加入分割：

\writebetweenlist[section]{\hrule}

目录与实际标题不同：

\SectionType [Options], or with \startSectionType [Options]
特定文字不列入列表用 \nolist or \nomarking：
- \chapter[title={An \nolist{approximate and slightly repetitive}introduction to the reality of the obvious}]

列表和联合列表#

根据列表生成列表、联合列表和目录。列表需要三个元素：

The number.
The name or title.
The page where it is found.

有序号的标题（无序号标题加入选项incrementnumber=yes）和\place...(如\placetable, \placefigure)命令生成的列表，都能满足要求。

生成、设置与使用列表与目录近似：

\definelist[ListName][Configuration]
\setuplist[ListName][Configuration]
\placelist[ListName][Options]
\completelist

联合列表

\definecombinedlist[Name][Lists][Options]，Lists如part, chapter, section, subsection，会自动生成放置命令\placeName
\setupcombinedlist

结构列表#

参考
* startitemgroup * Enumerations * 段落编号 * 自定义enumeration

用于结构复杂的列表，比如练习题。

\startitemize[Options][Configuration] ... \stopitemize

% 设置结构列表，标题字体风格，标题后命令
\setupitemize[headstyle=bold,afterhead={\blank[medium]}]

\startitemize
  \starthead{标题}
    列表项目1正文
  \stophead
  \startitem
    列表项目2正文
  \stopitem
\stopitemize

% 段落编号
\startParagraphNumbers
\stopParagraphNumbers

自定义类似\startitemize的结构列表：

\defineitemgroup[myitems]
\setupitemgroup [myitems] [each] [joinedup]
\setupitemgroup [myitems] [each] [itemalign=flushright]

索引#

\index[Alphabetical]{Index entry}
- \index{Entry 1+Entry 2+Entry 3}，多级别（最多三级）
\seeindex[Alphabetical] {Entry1} {Entry2+Entry 3}，参见Entry2+Entry 3
\placeindex
\placeindex
\completindex
\setupregister[index][Configuration]

生成其他索引

\defineregister[IndexName] [Configuration]，自动生成命令：
- \IndexName
- \placeIndexName
- completeIndexName
\setupregister[IndexName] [Configuration]

引用和超链接#

pdf书签

\placebookmarks[List of sections]
- \placebookmarks[all]

先设置交互，再设置书签才有效。

同义词#

排序#

mark标记#

\marking[IDENTIFIER][CONTENT], TEX \mark
\getmarking[mark][page name number][...]
- ...: first last current previous next top bottom default both all first:nocheck last:nocheck previous:nocheck next:nocheck top:nocheck bottom:nocheck
\getmarking [IDENTIFIER...][first|last|previous|both|all|current]

\definemarking[words]
\marking[words]{first}first word ...
\marking[words]{second}second word ...
\page
\marking[words]{third}third word ...
\marking[words]{fourth}fourth word ...
\page
\marking[words]{fifth}fifth word ...
\page

\setupfootertexts
[{\getmarking[words][previous]} --
{\getmarking[words][first]} --
{\getmarking[words][last]}]
[]

\setupfootertexts[chapter][sectionnumber]

\definehead[category][subsection]
\setupfootertexts[chapter][category]
\definemarking[category]
\couplemarking[category][subsection]

引用#

参考： https://wiki.contextgarden.net/References

交叉引用模块： https://wiki.contextgarden.net/Cross_Referencing
- \setupcrossreftext
- \crossref
段落引用模块： https://wiki.contextgarden.net/Paragraph_Referencing

设置：

\setupreferencing
\definereferenceformat 设置自己的引用命令
\setupinteraction 控制链接交互的格式
\setupreferencestructureprefix [default] [prefixsegments=2:2]
\definestructureseparatorset [default] [,,-]

锚点：

\reference[reference,...]{text}
- \chapter[reference]{text}
- \pagereference[reference,...]
- \textreference[reference,...]{text}

[reference]可使用命名空间进行分类：[fig:cow]

引用：

\in {text}{text}[reference] 引用数字编号，只适用于编号的条目
\at {text}{text}[reference] 引用页码
- \atpage [reference]
- \somewhere {text}{text}[reference]
\about {text}[reference] 引用文本（引用的标题）
- \setupreferencing 改变\about的输出
\ref[default| text| title| number| page| realpage][reference] 自定义用，可结合\goto

\section{FirstSection}

\reference[ref]{Gerald Manley}
---Gerald Manley Hopkins

Look in \in{chapter}[hotel] on \at{page}[hotel] for a complete
overview of accommodation in \pagereference[accommodation]Hasselt.

\section{SecondSection}

\starttabulate[|l|l|l|]
\NC title:       \NC \ref[title]   [ref] \NC \ref[title]   [sec] \NC \NR
\NC number:      \NC \ref[number]  [ref] \NC \ref[number]  [sec] \NC \NR
\NC text:        \NC \ref[text]    [ref] \NC \ref[text]    [sec] \NC \NR
\NC realpage:    \NC \ref[realpage][ref] \NC \ref[realpage][sec] \NC \NR
\NC page number: \NC \ref[page]    [ref] \NC \ref[page]    [sec] \NC \NR
\stoptabulate

\at{page}[accommodation].

在校样上显示引用 \showreferences

获取标签、章节标题的引用（reference）信息，如编号、页码等：

context-part-chapter-section-and-subsection-names by Aditya

The following variables give information about the current section (from strc-sec.mkiv):

\xdef\currentstructurename           {\structureparameter\c!name}%
\xdef\currentstructurecoupling       {\structureparameter\c!coupling}%
\xdef\currentstructureownnumber      {\structureparameter\c!ownnumber}% optional own number
\xdef\currentstructurelevel          {\structureparameter\c!level}%
\edef\currentstructureexpansion      {\structureparameter\c!expansion}%
\xdef\currentstructurexmlsetup       {\structureparameter\c!xmlsetup}%
\xdef\currentstructurecatcodes       {\structureparameter\s!catcodes}%
\xdef\currentstructurelabel          {\structureparameter\c!label}%
\xdef\currentstructurereference      {\structureparameter\c!reference}%
\xdef\currentstructurereferenceprefix{\structureparameter\c!referenceprefix}%
\xdef\currentstructurebackreference  {\structureparameter\c!backreference}%
\xdef\currentstructureshownumber     {\structureparameter\c!number}%
\xdef\currentstructuresaveinlist     {\structureparameter\c!saveinlist}%
\xdef\currentstructureincrementnumber{\structureparameter\c!incrementnumber}%
\xdef\currentstructuretitle   {\structureparameter\c!title}%
\xdef\currentstructurebookmark{\structureparameter\c!bookmark}%
\xdef\currentstructuremarking {\structureparameter\c!marking}%
\xdef\currentstructurelist    {\structureparameter\c!list}%

其他：

\currentstructurenumber
\currentstructurelistnumber
\currentsectioncountervalue
\previoussectioncountervalue
\structurenumber
\structuretitle
\structurevariable{ #one}
\structureuservariable{ #one}
\namedstructurevariable{ #one}{ #two}
\namedstructureuservariable{ #one}{ #two}

用法：

1	`\namedstructurevariable{subsection}{title}`

黄：经实测，很多已不能用，需要根据strc-sec.mkiv更新。有时用\ref更可靠。

另见\getmarking[chapter] \getmarking[chapternumber] \getmarking[sectionnumber]

另有\label，文档较少。

预置引用#

注册器#

字符、词语、文本#

大小写

\word{text}: 小写
\Word{text}: 首字母大写
\Words{text}: 多词语首字母大写
\WORD{text} or \WORDS{text}: 全部大写
\cap{...\nocap{...}...} 小型大写字母
\Cap{} 伪小型大写字母

上下标

\high{Text}
\low{Text}
\lohi{Subscript}{Superscript}
公式中用“_” and “^”

字面文本 Verbatim text

打字文本；忠实排版；

\type 第一个参数是边界符号
- \type {This is without curly bracket}
- \type This is a closing curly bracket: ‘}’
- \type 1Tweedledum and Tweedledee1
- \type |Tweedledum and Tweedledee|
- \type zTweedledum and Tweedledeez
- \type (Tweedledum and Tweedledee(
\starttyping ... \stoptyping
\typ 断词版
\tex 保留字会执行

复合词语的连接

文本的语言设置

\mainlanguage
\language \<语言代码> 文档中临时改变
\setuplanguage[Language][Configuration]
- \setuplanguage[en][patterns={en, agr}] 英语和古希腊语（防止替换）

English en, eng, english Japanese ja, japanese chinese cn, chinese

语言设置参考： https://www.mail-archive.com/ntg-context@ntg.nl/msg107547.html

会影响：

断词
某些词语的输出格式
某些的排版传统

跟语言相关的标签文本

比如章节中的“第”“章”。

\setuplabeltext[Language][Key=Label]
- \setuplabeltext[es][figure=Imagen~]
- \setuplabeltext[chapter=Chapter~]

可参考语言文件lang-txt.lua

\setuplabeltext[en][section=Lesson ]
\setuplabeltext[nl][section=Les ]
\setuphead[section][number=yes]

\section{First lesson}

\labeltext{section} 1

\mainlanguage[nl]

\section{Eerste les}

\labeltext{section} 2

语言相关命令

\currentdate[month, dd, weekday]
\date[d=6, m=7, y=1957][weekday]
\month
\translate[es=Su carta de fecha, en=Your letter dated] 根据语言取值
\quote and \quotation

水平空白/间距#

某种字体的词语间距 \fontdimen2\font \fontdimen2\font \fontdimen4\font
\hskip and \hfill 绝对值（可以是负值）空格，\hfill可用在行头行尾
hskip1em plus 1em minus .5em，弹性胶
\kern1cm，字符硬间距
\mkern⟨mudimen⟩
\hspace，预先定义的特定类型的空白
\, 千分位空格
\space or “\␣” 半角空格
\enskip, \quad and \qquad 半个em, 1 em or 2 ems

使用\nobreak来限制在空白处断行。

spac-chr.mkiv中规定的其他空白:

https://tex.stackexchange.com/questions/538654/non-breaking-hspace-in-context

\edef\nobreakspace            {\normalUchar"00A0} % space
\edef\softhyphen              {\normalUchar"00AD} % softhyohen
\edef\enquad                  {\normalUchar"2000} % quad/2
\edef\emquad                  {\normalUchar"2001} % quad

\let\ideographicspace         \enquad
\let\ideographichalffillspace \emquad

\edef\twoperemspace           {\normalUchar"2002} % quad/2
\edef\threeperemspace         {\normalUchar"2004} % quad/3
\edef\fourperemspace          {\normalUchar"2005} % quad/4
\edef\sixperemspace           {\normalUchar"2006} % quad/6
\edef\figurespace             {\normalUchar"2007} % width of zero
\edef\punctuationspace        {\normalUchar"2008} % width of period
\edef\breakablethinspace      {\normalUchar"2009} % quad/8
\edef\hairspace               {\normalUchar"200A} % quad/8
\edef\zerowidthspace          {\normalUchar"200B} % 0
\edef\zerowidthnonjoiner      {\normalUchar"200C} % 0
\edef\zerowidthjoiner         {\normalUchar"200D} % 0
\edef\narrownobreakspace      {\normalUchar"202F} % quad/8

\udef\zerowidthnobreakspace   {\penalty\plustenthousand\kern\zeropoint}
\udef\fiveperemspace          {\hskip\dimexpr\emwidth/5\relax}

水平间距

\setupspacing[broad]
\setupspacing[packed]

字符间距

\stretched[Configuration]{Text}
- \stretched[width=4cm]{\bf test text}
- \stretched{test\text} 扩大\指定位置的间距，撑满行
\setupstretched
\definestretched
\setupcharacterkerning
\definecharacterkerning

垂直间距/空白#

分段：

连续一个到多个空行
\par
\endgraf

插件垂直空白/空行（不建议使用\vskip \vfill）：

优先使用\blank[Dimension]，累加无效 blank
- \blank[force]，强制空行，不可缩减，比如设置答题空间时
- \blank[disable]，取消后面的空行
- \blank[back]，取消前面的空行
- \blank[overlay]，重叠，即负空行
- \blank[samepage]，禁止分页
- 空行 \emptylines[4] 等于 \blank[4*line]
\godown[Dimension]，可以累加

段落缩进：

\setupindenting[...,...]

[...,...] [+-]small [+-]medium [+-]big none no not first next yes always never odd even normal reset toggle dimension name

always：所有段落缩进
yes：一般段落缩进。特点段落额外增加垂直间距，如小节起始段落；后面跟着某些环境的段落不缩进。
no, not, never, none：禁用段落缩进。

1	`\setupindenting[yes, 2em]`

窄段落/两侧缩进/扩大页边：

\startnarrow[...=...,...] ... \stopnarrow （接受键值对参数）
\startnarrower[...,...] ... \stopnarrower

段间距/段落间距：

setupwhitespace

\setupwhitespace

none
small, medium, big：相对字号而言
line, halfline, quarterline：相对行高而言
DIMENSION：指定绝对尺寸，如\setupwhitespace[5pt].

无段落间距

\startpacked[Space] ... \stoppacked

指定位置插件间距，比如标题后

\setuphead[chapter][
    page=yes,
    before={\blank[4cm, force]},%强制空白，不可挤压、分页删除
    after={\blank[3*medium]}
]

\setupblank
\defineblank[Name] [Configuration]

行间距、行距：

setupinterlinespace

% 设定行间距、行距 %尺寸；符号：reset、small、medium、big、on、off；或用\defineinterlinespace定义的名字； %或命名参数：line=8ex（line, height, depth, minheight, mindepth,distance, top, bottom, stretch and shrink.）

\setupinterlinespace[line=3.2ex]
\setupinterlinespace[big]
\setupinterlinespace[reset]

断词

\hyphenation{union-ised, man-slaughter}
\unhyphenated
\hbox 盒子不会断开
\pretolerance and \tolerance
手动断行 \break, \crlf or \

手动断行

\startlines One-one was a race horse. Two-two was one too. One-one won one race. Two-two won one too. \stoplines

可配置：\startlines[indenting={yes, small, even}]...\stoplines

或全局配置：\setuplines[indenting={yes, small, even}]

带行号：

\startlinenumbering[Options] ... \stoplinenumbering

** 水平对齐：**

\setupalign[right] %全文设置
- \setupalign[horizontal, morehyphenation]
- \setupalign[reset]
\startalignment[Options] ... \stopalignment % 对齐

选项：

broad wide bottom height line high low lohi flushright flushleft middle yes no width normal reset inner outer flushinner flushouter left right center disable last end paragraph lefttoright righttoleft l2r r2l table lesshyphenation morehyphenation hanging(标点悬挂/突出 protrusion) hangingboth nothanging hz fullhz nohz hyphenated nothyphenated tolerant verytolerant stretch extremestretch final 1*final 2*final 3*final 4*final more 1*more 2*more

normal or width or yes，对齐
middle，行居中对齐 (实测会拉伸字距，等于center, wide，当是与center弄反了)
flushleft or no or right，左对齐/右填充 (right源于ragged-right，不建议用)
flushright or lef，右对齐/左填充（同上）
inner，推向内边(margin)
outer，推向外边
disable，仅用于单行段落，等于flushleft，但段末\parfillskip为0
last，对齐，最后一行居中

怎么控制行宽

wide，让ragged-right, ragged-left, and middle行更宽些(实测是保持固定宽度)
broad，近似，用于表格

你希望末行在哪里结束

bottom，底部填充
height，撑满高度
line，字下伸触及下面的边界

在盒子中竖向对齐，比如在\framed或表格中

high Align to top
low Align to bottom
lohi Vertically centered

预定义组合

table，等价于flushleft,broad,high
reset，等价于normal.
center，等价于middle, broad（实测不然，不会增加字距，当是与middle弄反了）

排版/文本流方向

lefttoright or l2r，"Hello, world."
righttoleft or r2l，".dlrow ,olleH"

更好的调整和局部排版

hanging，允许悬挂标点/突出(protrusion)
nothanging，禁止悬挂标点
hz，允许轻微拉伸字符/字体伸展(font expansion).
nohz，禁止字体伸展
hyphenated，允许断词
nothyphenated，禁止断词
lesshyphenation，更少断词. Not sure whether this is relative/additive, or absolute.
morehyphenation，更多断词. Not sure whether this is relative/additive, or absolute.
tolerant，放松最终段落操控(更多断词和拉伸)以避免超出盒子。
verytolerant，更加放松最终段落操控
stretch，运用空白额外拉伸，通常配合(very)tolerant使用

单行水平对齐：

\leftaligned, \midaligned or \rightaligned
\wordright，行内词语右移到头

特殊结构和段落#

脚注、尾注、边注、行号注、局部注

边注，如： * \margintext * \inmargin * \inoutermargin

分栏：

\startmixedcolumns ... \stopmixedcolumns
- \startitemgroupcolumns ... \stopitemgroupcolumns
- \startboxedcolumns ... \stopboxedcolumns
- \startcolumns[Configuration] ...\column...\stopcolumns
- \setupcolumns[Configuration]

并行段落

有结构列表

描述和枚举

线和框

\hairline 整行下画线
\thinrule 文中，平均撑满整行（类似\hfill）；一行可以排多组
\thinrules[n=2] 多行
\hl[3] and \vl[3] 固定长度的线，单位em
\fillinline[width=1cm]{Name:}，行内填充线(填充线对齐右侧，线长可调)
\fillinrules[]{}{} 多行填充线(填充线对齐右侧，或居中)
\blackrule \blackrules 铅条，铅线
- \blackrule[width=12em,depth=4pt,height=-3.5pt]
\startmarginrule ... \stopmarginrule 段落边缘线

文本装饰，与文本关联的线

文字两侧画线
- \textrule{Example text}
- \starttextrule[Configuration]{Text on the line} ... \stoptextrule
- \setuptextrule
\setupbar 设置参数
\bar 预定义实例
- \overbar，上画线
- \underbar，下画线，完形填空用
- \overstrike，删除线
- \understrike，字下删除线，如马克笔效果
- \overbars，逐词……
- \underbars
- \overstrikes
- \understrikes
- \underrandom，不规则（随机）下画线
- \underrandoms
- \underdash，下画断线
- \underdashes
- \underdot，下画点线
- \underdots
- \nobar
- \hiddenbar
\definebar 自定义实例
\resetbar 清楚

完形填空 % ！！！标点符号处理过程导致下画线丢失，或禁则失效 % 可能是标点模块删除标点前后的空白造成的 % 临时处理方法是只在填空前面加kern \definebar[clozeBar][underbar][continue=yes, color=black, offset=-0.5] \def\cloze #1{% \startbar[clozeBar]% \scratchdimen\widthofstring{ #1}\relax % 获取文本宽度 \zwj\kern1\scratchdimen \color[black]{ #1}% \kern.5\scratchdimen\zwj % U+200D ZERO WIDTH JOINER \stopbar% }%

也可以用\blackrule模拟： \def\b{\blackrule[width=1em,depth=4pt,height=-3.5pt]\hspace[0em]}

加框文本

\framed 适合短文本，框底齐行
- \inframed 行内基线对齐的文本，等于\framed[location=low]
\framedtext, 适合多段落，宽度默认为0.75\hsize
- \startframedtext

可重用的缓存文本

\startbuffer[BufferName] ...\stopbuffer
\getbuffer[BufferName]

其他环境和建构

化学式
算式
（浮动体、图像）联合体
隐藏文本 \starthiding...\stophiding
\starteffect[hidden]...\stopeffect
legend 公式说明
行调整（比如在加框的情况下）
mode 编译时进行模式匹配
左右也相对
引用
standardmakeup标准修饰如每页有文件名

图像、表格和其他浮动对象#

\externalfigure[img.jpg]
\placefigure[Options][Label] {Title} {Image}

表格：

Tabulate (tabulation, 线表，适合简单需求)
TABLE (适合natural tables, HTML tables)
xtables (extreme tables – 与natural tables更好兼容，利于分页)
framed tables (适合跨越几百页的简单表格)
database模块，可排数据表

\startxtable
  \startxrow
    \startxcell one \stopxcell
    \startxcell two \stopxcell
  \stopxrow
  \startxrow
    \startxcell alpha \stopxcell
    \startxcell beta  \stopxcell
  \stopxrow
\stopxtable

视觉对象分组：

\startcombination[mycombi][2*2]
    {\externalfigure[dummy][width=4cm,height=1cm]}
    {\externalfigure[dummy][width=4cm,height=1cm]}
    {\externalfigure[dummy][width=4cm,height=1cm]}
    {\externalfigure[dummy][width=4cm,height=1cm]}
\stopcombination

文本绕图

zhfonts#

标点压缩和字体设置模块

项目地址，使用说明，标点压缩说明, 字体处理基本知识。

安装目录：

D:\venvs\texlive\2021\texmf-dist\tex\context\third\zhfonts\ 使用：

\usemodule[zhfonts] %

可能造成字体找不到的情况（当时汉字码表设置问题），则禁用t-zhfonts.lua中的字体设置功能，只保留标点压缩功能：

function zhfonts.main (param)
    context ('\\setscript[hanzi]')
    zhspuncs.opt ()
    -- local arg_list = string_split_and_strip (param, ',')
    -- if arg_list[1] ~= "none" and arg_list[2] ~= "none" then
    --     context ('\\definefontfeature[zh][default][' .. fontfeatures .. ']')
    --     context ('\\setupalign[hanging, hz]')
    --         zhfonts.gen_typescript ()
    --         if arg_list[1] ~= "hack" and arg_list[2] ~= "hack" then
    --             context ('\\usetypescript[zhfonts]')
    --             context ('\\setupbodyfont[zhfonts, ' .. param .. ']') 
    --         end
    -- end
end

或直接使用仿制的t-zhspuncs.mkiv:

% t-zhspuncs.mkiv
\writestatus{loading}{ConTeXt User Module / zhspuncs}
\startmodule[zhspuncs]
\unprotect

% 加载lua脚本文件
\ctxloadluafile{t-zhspuncs}
% 宏定义，运行脚本函数
\def\zhspuncs{\ctxlua{moduledata.zhspuncs.opt()}}
% 宏的加载点
\appendtoks \zhspuncs \to \everystarttext

\protect
\stopmodule
\endinput

相应更改t-zhspuncs.lua：

--t-zhspuncs.lua
moduledata = moduledata or {}
moduledata.zhspuncs = moduledata.zhspuncs or {}
zhspuncs = moduledata.zhspuncs
-- zhspuncs = zhspuncs or {}
--以下保持不变

使用：

\usemodule[zhspuncs]

ruby和行间标注#

\usemodule[ruby]

\starttext

\ruby{漢字}{かんじ}

\stoptext

设置主体文本（base text）与ruby文本布局:

\setupruby
    [basestyle=...,
    basecolor=...,
    textstyle=...,
    textcolor=...]

设置ruby文本与周围文本重叠与否:

  \setupruby
    [overhang=auto|start|end|none] % default: yes

设置ruby和主体文字（base text）的间距:

  \setupruby
    [inbetween=...] % default: \blank[small]

可以只改变单个命令的设置:

  \ruby[..,..=..,..]{...}{...}

叠置/重叠/左右错位/凸排

\clap{whatever} 居中叠置
- 定义为\def\clap#1{\hbox to 0pt{\hss\strut #1\hss} }
\llap{whatever} 左侧叠置
- 定义为\def\llap#1{\hbox to 0pt{\hss #1} }
\rlap{whatever} 右侧叠置
- 定义为\def\rlap#1{\hbox to 0pt{ #1\hss} }

\strut 能利用字体的结构深度（基线、空白等），否则只有轮廓线

\hss胶等于\hskip 0pt plus 1fil minus 1fil, 它会吸掉\llap或\rlap参数的所有宽度，无论正负。

泡泡框：tikz宏包

latex

\overset{\makebox[0pt]{(\scriptsize animal)}}{Bears}
\underset
\labeltext

下画线#

日本語の表記では“\underbar{漢字}”や

盒子 box#

对齐盒子

\showboxes % 显式盒子
\hbox{\hbox{one} \vbox{two\par three} \vtop{four\par five}}

更多盒子：

\vbox 底部行对齐前面的元素
\vtop 头部行对齐前面的元素
\cbox 内容垂直居中
\lbox
- \lbox to 4cm{... text ...}
\rbox
\sbox 具有strut的高度（字体设计的行间高度，包括留空），可以基线对齐
\hbox 水平盒子，对齐行基线
\tbox（对齐行顶线） and \bbox 表格盒子（有strut属性，对齐底地线），也用于图表

显式盒子

\ruledhbox 带线的盒子
\ruledvbox 带线的盒子
\ruledvtop 带线的盒子
\showboxes 显式所有盒子
\showmakeup 显式标记信息（包括盒子）

用盒子标注拼音（实际情景请用官方的ruby模块）

中文此间距glue处理似乎没有中文字符盒子的问题

% 使用字体脚本`type-ahpinyin.tex`设置拼音字体
% \usetypescriptfile[ahpinyin] % this is the 'some-name-you-like' part of the saved filename
% \definefont[pinyin][ahpinyin]
% 设置拼音字体
\definefont[pinyin][name:ahpinying*default at 9pt]
% 设置注音命令
% \define[2]\Mypy{%TEX
\def\Mypy#1#2{%ConTeXt
    \setbox1 = \hbox{\strut#1}%
    \setbox2 = \hbox{\strut\darkgray \pinyin #2}% \ssxx xx号无衬线体
    \newdimen\maxwd%
    \ifdim \wd1>\wd2 \maxwd=\wd1 \else \maxwd=\wd2 \fi%
    \setbox1 = \hbox to \maxwd{\hfill \box1 \hfill}%
    \setbox2 = \hbox to \maxwd{\hfill \box2 \hfill}%
    \hskip0pt plus5pt\vtop{\box1\godown[-1.1em]\box2}% 加入glue以便正确分行、调词间距
    % #1\llap{\lower 3ex\box2}%
}
\starttext

漢字漢字漢字漢字\Mypy{漢字}{han4 zi4}漢字漢字

\stoptext

测量参考行的盒子宽度，居中排一首诗歌：

\def\startpoem[#1]%
  {\begingroup 
   \setbox0\hbox{ #1}%
   \setupnarrower[left=\dimexpr (\the\hsize-\the\wd0)/2\relax]%
   \startnarrower[left]%
   \startlines%
   }

\def\stoppoem
   {\stoplines
    \stopnarrower
    \endgroup}

\startlines本身也可以设置后用于排版诗歌，参考官网的Verse主题。

尺寸计算必须使用宏\dimexpr，如： \dimexpr 165mm * 2 + 20mm\relax （第一个元素必需是dim，参考： https://wiki.contextgarden.net/Expressions）

还可以结合lua函数string.splitlines(str) buffers.getlines() string.strip()等自动处理各行/逐行处理：

for n,line in ipairs(string.splitlines(str)) do
    io.write(string.format("%u: %s\n", n, line))
end

参考

文本缩放#

参考： https://wiki.contextgarden.net/Command/scale

\starttext

\startlines
\scale[maxwidth=4cm]{Hello}
\scale[maxwidth=4cm]{Hello World}
\scale[maxwidth=4cm]{Hello World! How}
\scale[maxwidth=4cm]{Hello World! How are}
\scale[maxwidth=4cm]{Hello World! How are you}
\scale[maxwidth=4cm]{Hello World! How are you doing?}
\stoplines

\stoptext

悬挂缩进#

\definestartstop
  [exdent]
  [before={\startnarrower[left]\setupindenting[-\leftskip,yes]},
   after=\stopnarrower]

\setuphead[section][indentnext=yes]
\section{Test}
\startexdent
\input knuth \endgraf
\stopexdent

缩放、镜像、剪切#

https://wiki.contextgarden.net/Scaling_Rotating_Mirroring_Clipping

视觉调试与跟踪#

Visual_Debugging
Debugging
\trace... 切换跟踪
- \tracingnodes1 %1,2
\show... 即时显示
- \showlayout[pt,cm,1] % 默认输出4页
- \showsetups % 只输出设置尺寸，与上项等效
- \showglyphs % 显示所有字模的方框
- \showboxes%盒子
- \showframe%框架
  - \showframe[text]
- \showmakeup%额外信息
- \showreferences

跟踪

在可能的错误附近打开所有追踪：

\enabletrackers
\enabletrackers[script*] %脚本跟踪，比如标点后注入罚点
\tracingall

grep脚本(源码全文检索)：

1	`mtxrun --script grep`

显示跟踪器和命令列表：

\showtrackers
\showdirectives

context --global m-trackers.mkiv
context --global m-directives.mkiv

缺字跟踪

\enabletrackers[fonts.missing]

缺字替换

\replacemissingcharacters

缺字体时替换为方块，并且可以拷贝、搜索。

或如下设置字体确实报错信息：

by Marco Patzer

%% alternative:
%% context --errors='*' <file>
\enabledirectives [logs.errors=*]

%% missing font
\definefontfamily [foo] [serif] [no font here really]
\setupbodyfont [foo]

\starttext
  %% missing characters
  𝒜
\stoptext

段落与页面构成

\showmakeup[...]

[...]makeup reset boxes all hbox vbox vtop kern glue penalty fontkern strut whatsit glyph simple simplehbox simplevbox simplevtop user math italic origin discretionary expansion line space depth

三个快捷选项：

makeup，页面布局
boxes，盒子构成
all，大部分有用选项

项目结构#

项目结构

项目—产品—组件
|    |产品环境
项目环境

提供不同类结构之间的加载控制，以免重复、循环和不必要的加载。

层/图文堆叠/图文定位#

layer，它是ConTeXt的页面坐标定位机制，以及元素随页码变化而切换的机制等；组合多个对象为页面的一层。可用于背景/前景设置，给整页图加标签，给页面加页码，等等。未写入正式文档。官方web文档
overlay，在同一点上堆叠多个对象为一个小型图文对象，可用于framed类对象的前景和背景。
collector，相对于可以用坐标定位的overlay，组合多个对象（如图文）为一个对象；本身还可以组合（composedcollector）。参考官方文档details.pdf。也可以用MetaPost（MetaFun）的thetextext[.anchor](str,pos) thelabel(string,pair) draw externalfigure "mycow.pdf" scaled 3cm等实现。

在pdf文件中添加附件#

\setupinteraction[state=start]
\attachment[file=\jobname.tex]
\starttext
\input zapf
\stoptext

生僻字造字拼字#

\hbox{\hbox{辶}\kern-.7em\scale[sx=0.7,sy=0.9]{\raise 0.1em\hbox{頃}}}

压缩会导致笔画变细，且横竖向粗细不协调。在ai中，从结构一致的字中拆部件来用是最好的。

字间距/字符间距#

inter-glyph kerning, Inter-character kerning, or inter-character spacingis, 通常是在字体设计层面处理的。但也可以调整：

\definecharacterkerning [extremekerning] [factor=.125]
\setcharacterkerning[extremekerning] ... text ...

标题拉伸（充满给定宽度）：

\setupcharacterkerning[stretched][factor=max, width=\availablehsize]
% \setupcharacterkerning[stretched][width=] % 或这样
\stretched{\bfd to the limit}

% 或
\stretched[width=]{\bfd to the limit}

% 或
\ruledhbox{\stretched[width=10cm]{\bfd to the limit}}

观察字符字间：

\usemodule[typesetting-kerning]
\starttext
    \showcharacterkerningsteps[
        style=Bold,
        sample=how to violate a proper font design,
        text=rubish,
        first=0,
        last=45,
        step=5]
\stoptext

额外的字体字间（Extra font kerns）#

在字体设计的特定字符组合（如AV）间的字间基础上，再设置额外的幅度：

\setextrafontkerns

观察字体字间：

\showfontkerns

浮动体#

浮动体 \definefloat
- \chemical
- \figure
- \table
- \intermezzo
- \graphic
\startfloattext ... \stopfloattext
- \startchemicaltext ... \stopchemicaltext
- \startfiguretext ... \stopfiguretext
- \starttabletext ... \stoptabletext
- \startintermezzotext ... \stopintermezzotext
- \startgraphictext ... \stopgraphictext
行首/首字下沉（Drop caps） \setupinitial
文本围绕行首浮动体悬挂 \starthanging ... \stophanging

偏置、提高盒子#

\offset 。它的offset参数会像\raise那样影响行高，而使用y参数不会（导致重叠）。 \dontleavehmode 正常文本\offset[y=-3em,x=0em,width=0pt]{偏置文本}正常文本
\glyph xx\glyph yoffset 3emf\relax oo`
\raisebox \dontleavehmode\raisebox{1pt}\hbox{f}oo

存取数据（multi-pass数据）#

\definedataset[mydataset][delay=yes] % delay能添加页码信息
\setdataset[mydataset][mytable][field1=text 1, ...]
\datasetvariable{mydataset}{mytable}{myvariable}

% To define a dataset.
\definedataset[cats]

% 匿名键值表1
\setdataset[cats][name=Gus, job=Theatre Cat]

% 匿名键值表2
\setdataset[cats][scene=crime, name=Macavity, is=not there]

% 命名键值表
\setdataset[cats][culprit][name=Mungojerry]

% 覆盖命名键值表
\setdataset[cats][culprit][name=Rumpleteaser]

% 不能存有逗号的字符串，可以存命令（作为字符串，取回时展开）
\def\mytitle{peanut butter}
\definedataset[looks]
\setdataset[looks][narrower][before=\margintitle{\mytitle}]
\def\mytitle{cheese}
% The margintitle is 'cheese', not 'peanut butter'.
\setupnarrower[before=\datasetvariable{looks}{narrower}{before}]

% 注意：以下用花括号，为的是生成文本
The name of the culprit was \datasetvariable{cats}{culprit}{name}.

% 第二个匿名表中的name
\datasetvariable{cats}{2}{name}.

lua存取数据：

\startluacode
  local setdata = job.datasets.setdata
  setdata {
    name  = "dataset_id",
    tag   = "this",
    data  = {
      "does",
      work = {
        "splendidly",
        "for",
        nested = { "tables", "!", {{}} }
      }
    }
  }


local getdata = job.datasets.getdata
table.print(getdata ("dataset_id", "this"), "this")
\stopluacode

参考： * definedataset * Multi-pass_data

交互控件#

比如可以填写的表单。

https://wiki.contextgarden.net/Widgets

模式#

Modes

可自定义并开、关模式，实现按模式有条件处理。

可以结合Setups使用，实现有条件的切换设置。

有一些常用的系统模式可用（均以*开头）：

*mkii Enabled when running MkII
*mkiv Enabled when running MkIV
*first Enabled during the first compile run
*export Enabled when \setupbackend[export=yes] is set
*project Enabled when inside \startproject ... \stopproject
*component Enabled when inside \startcomponent...\stopcomponent
*environment Enabled when inside \startenvironment ... \stopenvironment
*text Enabled when inside \starttext ... \stoptext.
*frontpart Enabled when inside \startfrontmatter ... \stopfrontmatter
*bodypart Enabled when inside \startbodymatter ... \stopbodymatter
*backpart Enabled when inside \startbackmatter ... \stopbackmatter
*list Enabled inside a list entry
*marking Enabled inside a marking
*register Enabled inside a register
*chapter, *section, etc. Enabled inside the corresponding section head.
*en-us, *nl, etc. Enabled when the current \language is en-us, nl, etc.
*en-us, *nl, etc. Enabled when the \mainlanguage is en-us, nl, etc.
*figure Enabled when a graphic is found
*interaction Enabled when interaction is enabled
*grid Enabled when grid typesetting is enabled
*singlesided Enabled when singlesided layout is enabled
*doublesided Enabled when doublesided layout is enabled
*pdf Enabled when the main output is pdf
*dvi Enabled when the main output is dvi

可在lua和命令行中使用模式：

if (tex.modes["mode1"] and tex.modes["mode2"]) then
 ...
end

context --mode=palatino filename

在第一遍中执行外部系统命令：

\startmode[*first]
   % external program which creates a file fig-1.ps
   \executesystemcommand{some_external_program ...}
   % convert PS into PDF
   \executesystemcommand{pstopdf fig-1.ps}
\stopmode

% include the resulting PDF
\externalfigure[fig-1]