Command/defineconversionset

Unofficial ConTeXt Wiki mirror

Last modified: 2026-03-11

Summary

This command provides (one way to) ensure that the internal Page Labels of a PDF file agree with the page numbers on the page.

Settings

\defineconversionset[...][...,...][...]
[...] name sectionblock:name
[...,...] name processor->name
[...] name processor->name

Description

Some ways of putting Roman numerals in the frontmatter do not succeed in getting the internal PDF Page Labels (the page "numbers" shown by a PDF viewer) to agree with the numbers seen on the page.

The usage shown below in the example produces a document with the frontmatter numbered with Roman numerals, and the PDF Page Labels are in agreement.

This command may have other uses which are not (yet) documented here.

Examples

Getting Roman numerals into the PDF PageLabels:

Example by Wolfgang Schuster.

The frontmatter of this document is numbered with Roman numerals, which show up correctly both on the pages of the PDF, as well as in the PDF PageLabels.

\startsectionblockenvironment[bodypart]
\setupuserpagenumber[number=1]
\stopsectionblockenvironment

\defineconversionset[frontpart:pagenumber][][romannumerals]

\starttext

\startfrontmatter
\dorecurse{3}{\page[dummy]}
\stopfrontmatter

\startbodymatter
\dorecurse{3}{\page[dummy]}
\stopbodymatter

\stoptext

Notes

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: