Files
rdb/man/translate.man
T

122 lines
2.0 KiB
Groff

.TH translate "" "" "/rdb Command"
.PC "Word-for-word substitution using a translation file"
\fBtranslate \fIlanguage \fB< \fItext \fB> \fItranslatedtext\fB
.PP
.II "text^translate"
The command
.B translate
performs word-for-word replacement on
.IR text .
You can use it to perform crude translations from one language to
another.
.PP
.B translate
uses either
.BR m4 ,
.BR sed ,
or both.
For
.BR m4 ,
.B translate
needs a define file generated by the
.B /rdb
command
.BR tabletom4 ;
the define file must be named
.IR language .
For
.BR sed ,
it needs a preprocessing file and can also use a postprocessing file,
both generated by the command
.BR tabletosed ;
the preprocessing file must be named \fIlanguage\fB.sed.1\fR, and the
postprocessing file must be named \fBlanguage\fB.sed.2\fR.
See the manual pages for these
.B /rdb
commands for a description of the sort of table they require as input.
.SH Example
Suppose we have a simple translation for English to Deutsch (German),
called
.BR ed.t :
.DM
English Deutsch
------- -------
I Ich
love liebe
you dich
widgit
.DE
.PP
The command
.DM
tabletom4 < ed.t > ed
.DE
.PP
generates the
.B m4
definition file
.BR ed ,
which contains the following:
.DM
define(I,Ich)
define(love,liebe)
define(you,dich)
.DE
.PP
Note that
.B tabletom4
did not convert
.B widgit
because this word had no translation in the table.
.PP
Now, if file
.B text
contains the sentence
.DM
I love you.
.DE
.PP
you can use
.B translate
to translate it into German.
Typing
.DM
translate ed text
.DE
.PP
prints the following on the standard output:
.DM
Ich liebe dich.
.DE
.PP
.B translate
has also been used in a biomedical expert system.
The idea is to convert each word into its value after looking it
up in a table.
For example:
.DM
Var Value
------- -------
age 42
weight 80
...
.DE
.PP
This is something the Lisp language does frequently.
.PP
.B translate
can also be used to construct form letters.
.SH "See Also"
.B
tabletom4,
tabletosed,
word
.R
.br
COHERENT Lexicon:
.B
m4,
sed
.R
.SO translate