Scroll to navigation

LOU_TRANSLATE(1) User Commands LOU_TRANSLATE(1)

NAME

lou_translate - A Braille translator for large scale testing of liblouis Braille translation tables

SYNOPSIS

lou_translate [OPTIONS] TABLE

DESCRIPTION

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:

KEY[:VALUE] [KEY[:VALUE] ...]
FILE[,FILE,...]

OPTIONS

display this help and exit
display version information and exit
forward translation using the given table
backward translation using the given table If neither -f nor -b are specified forward translation is assumed
use the given display table for the translation. This is useful when you are specifying the table as a query. This option takes precedence over any display table specified as part of the table file list.

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 --forward en-us-g2.ctb < input.txt
Do a forward translation with table en-us-g2.ctb.
lou_translate unicode.dis,en-us-g2.ctb < input.txt
If you require a specific braille encoding use a display table. Here we do a forward translation with table en-us-g2.ctb and a display table for Unicode braille. The resulting braille is encoded as Unicode dot patterns.
lou_translate -d unicode.dis language:en grade:2 region:en-US < input.txt
Using a query and a specific display table you can achieve basically the same translation as above.
echo ",! qk br{n fox" | lou_translate --backward en-us-g2.ctb
Do a backward translation with table en-us-g2.ctb.

AUTHOR

Written by John J. Boyer.

REPORTING BUGS

Report bugs to liblouis-liblouisxml@freelists.org.
Liblouis home page: <http://www.liblouis.io>

COPYRIGHT

Copyright © 2024 ViewPlus Technologies, Inc. and JJB Software, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

The full documentation for lou_translate is maintained as a Texinfo manual. If the info and lou_translate programs are properly installed at your site, the command

info liblouis

should give you access to the complete manual.

December 2024 Liblouis 3.32.0