ocrd-page-to-alto

Convert PAGE (v. 2019) to ALTO (v. 2.0 - 4.2)

Introduction

This software converts PAGE XML files to the ALTO XML OCR result format. It enables using PAGE XML generating software in a context where ALTO is needed to display the results, i.e. in libraries.

Installation

In a Python virtualenv:

make install     # or pip install .
# or to install from PyPI
pip install ocrd_page_to_alto

Usage

To convert the PAGE XML document example.xml to ALTO:

page-to-alto example.xml > example.alto.xml

You can get an exhaustive list of page-to-alto's many options with --help:

CLI

Usage: page-to-alto [OPTIONS] FILENAME
  Convert PAGE to ALTO
Options:
  -l, --log-level [OFF|ERROR|WARN|INFO|DEBUG|TRACE]
                                  Log level
  --alto-version [4.2|4.1|4.0|3.1|3.0|2.1|2.0]
                                  Choose version of ALTO-XML schema to produce
                                  (older versions may not preserve all
                                  features)
  --check-words / --no-check-words
                                  Check whether PAGE-XML contains any Words
                                  and fail if not
  --check-border / --no-check-border
                                  Check whether PAGE-XML contains Border or
                                  PrintSpace
  --skip-empty-lines / --no-skip-empty-lines
                                  Whether to omit or keep empty lines in PAGE-
                                  XML
  --trailing-dash-to-hyp / --no-trailing-dash-to-hyp
                                  Whether to add a  element if the last
                                  word in a line ends in "-"
  --dummy-textline / --no-dummy-textline
                                  Whether to create a TextLine for regions
                                  that have TextEquiv/Unicode but no TextLine
  --dummy-word / --no-dummy-word  Whether to create a Word for TextLine that
                                  have TextEquiv/Unicode but no Word
  --textequiv-index INTEGER       If multiple textequiv, use the n-th
                                  TextEquiv by @index
  --textequiv-fallback-strategy [raise|first|last]
                                  What to do if nth textequiv isn't available.
                                  'raise' will lead to a runtime error,
                                  'first' will use the first TextEquiv, 'last'
                                  will use the last TextEquiv on the element
  -O, --output-file FILE          Output filename (or "-" for standard output,
                                  the default)
  -h, --help                      Show this message and exit.

To process an OCR-D workspace, use ocrd_fileformat, which uses page-to-alto by default:

ocrd-fileformat-transform -I OCRD-OCR-OUTPUT-PAGE -O OCRD-OCR-OUTPUT-ALTO \
  -P script-args "--dummy-word --no-check-words --no-check-border"

TODO

AlternativeImage
unmappable regions
handle Border
TextStyle
ParagraphStyle
table regions
recursive regions for *Region
Set PAGECLASS from pc:Page/@type #4
Layers / z-level via StructureTag? #4
<SP/>
<HYP/>
rotation
reading order
input PAGE-XML not having words #5
multiple pc:TextEquivs
language
~~script~~ no equivalent in ALTO :(
~~kerning~~ no equivalent in ALTO :(
~~underlineStyle~~ no equivalent in ALTO :(
~~bgColour~~ no equivalent in ALTO :(
~~bgColourRgb~~ no equivalent in ALTO :(
~~reverseVideo~~ no equivalent in ALTO :(
~~xHeight~~ no equivalent in ALTO :(
~~letterSpaced~~ no equivalent in ALTO :(
ProcessingStep
differentiate/select ALTO versions

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ocrd_page_to_alto-2.2.12.tar.gz (20.9 kB view details)

Uploaded Jul 29, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ocrd_page_to_alto-2.2.12-py3-none-any.whl (19.6 kB view details)

Uploaded Jul 29, 2026 Python 3

File details

Details for the file ocrd_page_to_alto-2.2.12.tar.gz.

File metadata

Download URL: ocrd_page_to_alto-2.2.12.tar.gz
Upload date: Jul 29, 2026
Size: 20.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for ocrd_page_to_alto-2.2.12.tar.gz
Algorithm	Hash digest
SHA256	`b2702274c107c00e4f930d76413cd7e37ca6fb52ea716909c66ba901b1e8e29c`
MD5	`7b8c9b07ec3d5b43ebe618d4495614b9`
BLAKE2b-256	`0e4a4a49d8fe00f6ecd6bc6af3a08da0e470bd0b81a894bd3d16c12ce30dcc04`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ocrd_page_to_alto-2.2.12.tar.gz:

Publisher: cd-pypi.yml on OCR-D/page-to-alto

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ocrd_page_to_alto-2.2.12.tar.gz
- Subject digest: b2702274c107c00e4f930d76413cd7e37ca6fb52ea716909c66ba901b1e8e29c
- Sigstore transparency entry: 2281506071
- Sigstore integration time: Jul 29, 2026
Source repository:
- Permalink: OCR-D/page-to-alto@3440591f3178c6b2324986567c5000c9a143d797
- Branch / Tag: refs/tags/v2.2.12
- Owner: https://github.com/OCR-D
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: cd-pypi.yml@3440591f3178c6b2324986567c5000c9a143d797
- Trigger Event: release

File details

Details for the file ocrd_page_to_alto-2.2.12-py3-none-any.whl.

File metadata

Download URL: ocrd_page_to_alto-2.2.12-py3-none-any.whl
Upload date: Jul 29, 2026
Size: 19.6 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for ocrd_page_to_alto-2.2.12-py3-none-any.whl
Algorithm	Hash digest
SHA256	`42b599aa90b7e2ae157d436da647dcf59d7bcfa8d04158039e0a7d742fd11142`
MD5	`7901dda7897d03c5a70ae77d9e6ebce1`
BLAKE2b-256	`68444871d36cdc1cc471a1bad89be7a895d00afd514341d26cd2883f1bc63bb7`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ocrd_page_to_alto-2.2.12-py3-none-any.whl:

Publisher: cd-pypi.yml on OCR-D/page-to-alto

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ocrd_page_to_alto-2.2.12-py3-none-any.whl
- Subject digest: 42b599aa90b7e2ae157d436da647dcf59d7bcfa8d04158039e0a7d742fd11142
- Sigstore transparency entry: 2281506095
- Sigstore integration time: Jul 29, 2026
Source repository:
- Permalink: OCR-D/page-to-alto@3440591f3178c6b2324986567c5000c9a143d797
- Branch / Tag: refs/tags/v2.2.12
- Owner: https://github.com/OCR-D
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: cd-pypi.yml@3440591f3178c6b2324986567c5000c9a143d797
- Trigger Event: release

Release history Release notifications | RSS feed

This release

2.2.12

Jul 29, 2026

2.2.11

Jun 5, 2026

2.2.8

May 5, 2026

2.1.0

May 6, 2025

2.0.1

Apr 30, 2025

2.0.0

Apr 30, 2025

1.5.0

Apr 30, 2025

1.4.1

Apr 30, 2025

1.4.0

Oct 10, 2024

1.3.0

Jan 11, 2024

1.2.0

Sep 13, 2022

1.1.0

Feb 1, 2022

1.0.1

Nov 9, 2021

0.0.1

Nov 9, 2021

ocrd-page-to-alto 2.2.12

ocrd-page-to-alto

Introduction

Installation

Usage

TODO

Project links

Key dates

2 maintainers

Credits

GitHub Statistics

License

Requires

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed