Command/setupnote

Unofficial ConTeXt Wiki mirror

Last modified: 2025-10-08

Summary

The command \setupnote is used for the design of the (foot)note marker in text.

Settings

\setupnote[...,...][...=...,...]
[...,...] name
interaction yes no number text all
symbolcommand oneargument
textcommand oneargument
indicator yes no
textseparator command
width dimension
height dimension
distance dimension
rulecommand command
rule on off normal left right command paragraph
split tolerant strict verystrict number
factor number
location text page high bottom none columns firstcolumn lastcolumn
next command
n number
rulecolor color
rulethickness dimension
setups name
interlinespace name
paragraph yes no
before command
after command
inbetween command
scope page
columndistance dimension
continue yes no
alternative grid fixed columns note none
criterium page
bodyfont see \setupbodyfont
align see \setupalign
textstyle style command
textcolor color
anchor next
spacebefore see \blank
spaceinbetween see \blank
...=...,... inherits from \setupframed

Option Explanation
interaction
if interaction is active, set links between note number and note text?
textcommand
your own macro for the note number design; default: \high
distance
“in the text, between symbols”; default: .125em
rulecommand
your own macro for the line before the list of notes
rule
set a separator line before the list of notes? default is a black line 20% of the textwidth
split
page breaking of notes; try (very)strict setting if footnotes break needlessly over pages
location
placement of the list of notes
n
number of columns if alternative=columns
rulecolor
color of the separator line
rulethickness
thickness of the separator line; default: \linewidth
before
before the list of notes; default: \blank
columndistance
distance between note columns in multi-column mode; default: 1em
alternative
columns typeset notes in columns
bodyfont
font for the notes; default: \small
textstyle
style of the note number; default: \tx
textcolor
color of the note number

Description

The option scope is ignored. (ML 2019-07-22 "Place footnote after reference")

\setupnote affects the number inside the body text, but \setupnotation affects the text at the bottom of the page (footnote or endnote).

You can also use options of \setupcounter (e.g. conversion and prefix) and \setupframed.

Examples

Custom notes

  • \define[1]\MyNoteTextcommand
       {\offset[y=-0.2ex]{#1}}
    
    \definenote
       [Mynote]
    
    \setupnote
       [Mynote]
       [location=text,
        textstyle=,
        textcommand=\MyNoteTextcommand]
    
    \starttext
    
    \input{knuth}\Mynote{First note.}
    
    \startstyle[style=\ss]
    \input{knuth}\Mynote{Second note.}
    \stopstyle
    
    \startstyle[style=\tt\bf]
    \input{knuth}\Mynote{Third note.}
    \stopstyle
    
    \placenotes[Mynote]
    
    \stoptext
    

Notes

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: