# The PreTeXt Guide

## Section4.32Braille Best Practices

This is an evolving list of best practices for authoring (and publishing) so that a conversion to braille is as useful as possible for the blind reader.
Many recommendations for mathematics will be useful to any reader, but perhaps even moreso for a blind reader, so read Section 4.10. Recommendations here may also improve your project for all readers. See Chapter 33 for more about the mechanics of producing output as braille.

### Division Numbering.

Braille uses various devices to indicate division headings, since font weight, size, and color are not available. These include starting on a new page, centering text, preceding with a blank lines, standard levels of indentation (4 or 6 cells), and combinations of these devices.
In a conversion from PreTeXt, the text of each heading is the number of the division, followed by the title. So the formatting and the presence of a hierarchical number are together good clues that a new division is starting. And the number of parts in the hierarchical number will also serve as a precise indicator of the depth of the division.
As a publisher, you can “turn off” division numbering below some level (Section 44.2). Think carefully about the impact this will have on a blind reader, since lesser division headings will be harder to recognize without a leading number.

### Side-By-Side Layout.

A <sidebyside> can be a very useful device, but think carefully about its suitability. As of 2022-11-30, we have yet to even handle them carefully in a braille conversion. And if your panels hold images, that is even harder, since we do not have good support for tactile images yet.
In any event, we will likely “unwind” a <sidebyside> into a series of its panels running down the page, rather than across, along with a note about how many panels to expect. So when you author a <sidebyside>, consider how this alternate presentation in braille will be received by the reader.