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

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. When you specify a table query,
              the braille encoding is always Unicode dot patterns.

              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 (C) 2022 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.29.0                   April 2024                  LOU_TRANSLATE(1)