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:
       - 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. 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.

Liblouis 3.33.0                                    March 2025                                   LOU_TRANSLATE(1)