Skip to main content

Characters Listing tool

The Characters Listing tool scans translatable blocks and accumulates the set of distinct characters used, together with how often each one occurs. It also records the number of unique characters per block on the block's properties. The accumulated character set is typically used for font subsetting — determining which glyphs a font must provide for a given body of content.

By default both source and target text are scanned. When target text is included, a target locale must be supplied so the tool knows which translation to read.

IDchars-listing
SourceBuilt-in
Categoryanalysis
Cardinalitymonolingual
Tagsanalysis

Parameters

ParameterTypeDefaultDescription
includeSourcebooleantrueInclude source text in character listing
includeTargetbooleantrueInclude target text in character listing

Configure these parameters interactively and copy the flow-step YAML on the Tool Reference.

Examples

List source characters only

Build the character set from source text alone, for example before any translation exists.

includeSource: true
includeTarget: false

Processing notes

  • Operates on translatable blocks; non-translatable structure passes through unchanged.

  • Frequencies are accumulated across all blocks; the per-block unique-character count is recorded on each block.

Limitations

  • At least one of source or target inclusion must be enabled.

  • Including target text requires a configured target locale.

← Back to the Tool Reference