.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH LOU_TRANSLATE "1" "March 2024" "Liblouis 3.29.0" "User Commands"
.SH NAME
lou_translate \- A Braille translator for large scale testing of liblouis Braille translation tables
.SH SYNOPSIS
.B lou_translate
[\fI\,OPTIONS\/\fR] \fI\,TABLE\/\fR
.SH 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.
.SS "TABLE is either:"
.TP
\- a query
KEY[:VALUE] [KEY[:VALUE] ...]
.TP
\- a file list
FILE[,FILE,...]
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
display this help and exit
.TP
\fB\-v\fR, \fB\-\-version\fR
display version information and exit
.TP
\fB\-f\fR, \fB\-\-forward\fR
forward translation using the given table
.TP
\fB\-b\fR, \fB\-\-backward\fR
backward translation using the given table
If neither \fB\-f\fR nor \fB\-b\fR are specified forward translation
is assumed
.SH EXAMPLES
.IP
lou_translate language:en grade:2 region:en\-US < input.txt
.IP
Do a forward translation of English text to grade 2 contracted braille
according to the U.S. braille standard.
.IP
lou_translate \-\-forward en\-us\-g2.ctb < input.txt
.IP
Do a forward translation with table en\-us\-g2.ctb.
.IP
lou_translate unicode.dis,en\-us\-g2.ctb < input.txt
.IP
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.
.IP
echo ",! qk br{n fox" | lou_translate \-\-backward en\-us\-g2.ctb
.IP
Do a backward translation with table en\-us\-g2.ctb.
.SH AUTHOR
Written by John J. Boyer.
.SH "REPORTING BUGS"
Report bugs to liblouis\-liblouisxml@freelists.org.
.br
Liblouis home page: <http://www.liblouis.io>
.SH COPYRIGHT
Copyright \(co 2022 ViewPlus Technologies, Inc. and JJB Software, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B lou_translate
is maintained as a Texinfo manual.  If the
.B info
and
.B lou_translate
programs are properly installed at your site, the command
.IP
.B info liblouis
.PP
should give you access to the complete manual.