lou_translate(1)

lou_translate1

A braille translator for large scale testing of liblouis braille translation tables

Usage

lou_translate [OPTIONS] TABLE

Overview

Translate whatever is on standard input and print it on standard output. It is intended for large-scale testing of the accuracy of braille translation and back-translation.

TABLE is either:

- a query

KEY[:VALUE] [KEY[:VALUE] ...]

- a file list

FILE[,FILE,...]

Options

-h, --help

display this help and exit

-v, --version

display version information and exit

-f, --forward

forward translation using the given table

-b, --backward

backward translation using the given table If neither -f nor -b are specified forward translation is assumed

-d, --display-table

use the given display table for the translation. The display table determines how braille dot patterns are encoded as text (decoded in case of backward translation). Without a display table, the braille encoding is determined by the translation table, when it is specified as a file list, or Unicode braille when the table is specified as a query. For clarity and reliability, it is recommended to always make the display table explicit.

Examples

lou_translate language:en grade:2 region:en-US < input.txt

Do a forward translation of English text to grade 2 contracted braille according to the U.S. braille standard.

lou_translate -d en-us-brf.dis language:en grade:2 region:en-US < input.txt

Here we do the same forward translation but with a specific ASCII braille encoding instead of Unicode braille.

lou_translate -d unicode.dis en-us-g2.ctb < input.txt

Do a forward translation with table en-us-g2.ctb and Unicode braille encoding.

echo ",! qk br{n fox" | lou_translate -b -d text_nabcc.dis language:en grade:2 region:en-US

Do a backward translation with the English grade 2 table. Note that the ASCII braille input (as shown here) must match the specified display table (North American Braille Computer Code in this case).

Releases

9 releases since Debian 6.0 (Squeeze); the text changed 8 times.

  1. 6.0
  2. 7
  3. 8
  4. 9
  5. 10
  6. 11
  7. 12
  8. 13
  9. Arch

--display-table since Debian 13 (Trixie); -d since Debian 13 (Trixie).

Author

Written by John J. Boyer.

Reporting bugs

Report bugs to [email protected].
Liblouis home page: <http://www.liblouis.io>

From liblouis 3.39.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.