Command/setupregister

From ConTeXt wiki
< Command
Revision as of 08:30, 15 May 2018 by Massifr (talk | contribs) (pageleft and pageright in setupregister)

\setupregister

Syntax

\setupregister[...][...][...,...=...,...]
[...] singular
[...] name
n number
balance yes no
align yes no
style normal bold slanted boldslanted type cap small... command
pagestyle normal bold slanted boldslanted type cap small... command
textstyle normal bold slanted boldslanted type cap small... command
indicator yes no
coupling yes no
sectionnumber yes no
criterium section local all
distance dimension
symbol 1 2 ... n a ... none
interaction pagenumber text
expansion yes no command
referencing on off
location left middle right
maxwidth dimension
unknownreference empty none
alternative a b A B
prefix both first none
pagecommand command
textcommand command
compress yes no
method default before after first last
pageleft command
pageright command

Description

The options are as follows:

Option Description
n number of columns
balance balance columns?
align balance related (it’s difficult; try which combination suits you)
style overall style (no effect, at least in MkIV)
pagestyle style of page number
textstyle style of index word
indicator create letter sections?
coupling special feature for screen documents (no effect in MkIV?)
(section)number print part/... numbers?
criterium for part/chapter/section registers
distance between text and pagenumber
symbol for pagenumber (a=a,b,c; n=1,2,3; 1=dots; 2=blocks)
interaction which part should be clickable?
expansion When the entry is a command, it is expanded before writing to the register
referencing create references for letter sections (like "index:a")?
textcommand custom command for index word
pagecommand custom command for page number
location ?
compress collapse page numbers
maxwidth Set the maximum length for the text of the index entry in the registerlist (the command uses \limitatetext to do this)
unknownreference insert a horizontal space before and after the reference in the text if you use interactive mode to move from one entry in the text to next or previous one and there is no previous or next reference.
alternative ?
method sets up the sorter used for \placeregister
pageleft custom command before the first page number
pageright custom command after the last page number

Some options don’t seem to have any effect, at least in MkIV.

Example

Here is an example for MkII:

\defineregister[nickname][nicknames]

\setupregister [nickname]
  [partnumber=no,alternative=A,criterium=all,n=3,balance=yes,pagestyle=normal]
\setupregister [nickname][foto][pagestyle=bold]

\starttext

Text about Mamut\nickname{Mamut}.
\placefigure[]
  {Kuba\nickname[foto::]{Kuba} on the photo.}
  {\externalfigure[kuba][width=0.2\textwidth]}

\page
And text about Kuba\nickname{Kuba}.

\completenickname
\stoptext 

yields


I found it safer to put \register command after punctuation e.g.: Mamut.\nickname{Mamut} [P.K.]

For the MkIV version of setting the pagestyle, and more, see the material on \defineprocessor that is on this page.

pageleft and pageright

They were introduced in ConTeXt MkIV version 1.02 (2018.05.12 00:07).

You can use them, for example, to move the page numbers to the right, with:

\setupregister[index][pageleft=\wordright\bgroup,pageright=\egroup]

See this thread on the mailing list.

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: