Tips for translators - Revision history

Marcriera at 11:01, 19 April 2025

2025-04-19T11:01:33Z

Rcrowther at 18:56, 26 September 2016

2016-09-26T18:56:07Z

Unhammer: /* Are there any graphical user interfaces or apps? */

2014-10-23T11:18:42Z

Are there any graphical user interfaces or apps?

Unhammer at 11:18, 23 October 2014

2014-10-23T11:18:15Z

Unhammer: /* See also */

2014-05-30T09:12:06Z

Unhammer at 07:54, 5 April 2014

2014-04-05T07:54:56Z

Unhammer at 07:53, 5 April 2014

2014-04-05T07:53:58Z

Unhammer: /* How do I make the translator ignore certain strings? */

2014-04-05T07:52:29Z

How do I make the translator ignore certain strings?

Unhammer: /* The HTML format adds entities, I want plain (Unicode) symbols */

2014-04-05T07:49:15Z

The HTML format adds entities, I want plain (Unicode) symbols

Unhammer: /* The HTML format adds entities, I want plain (Unicode) symbols */

2014-04-05T07:48:29Z

The HTML format adds entities, I want plain (Unicode) symbols

@@ Line 42: / Line 42: @@
 ==See also==
-* [[Translation memory]] for translating TMX / .tmx files
+* [[Translation memory]] for translating with the help of TMX / .tmx files
 * [[Translating QT Linguist TS-files]] for how to translate .ts files
 * [[Translating gettext]] for how to translate .po files

← Older revision		Revision as of 18:56, 26 September 2016
Line 52:		Line 52:

	[[Category:Using Apertium]]		[[Category:Using Apertium]]
			[[Category:Documentation in English]]

@@ Line 12: / Line 12: @@
 ==Are there any graphical user interfaces or apps?==
-Other than http://apertium.org, see [[Tools#Tools_for_users_.2F_translators]]
+Other than our web site http://apertium.org, see [[Tools#Tools_for_users_.2F_translators]]
 ==What do the funny symbols like */#@ mean?==

@@ Line 4: / Line 4: @@
 {{TOCD}}
+==General tips==
-==Are there any GUI's?==
+If you're translating something that is to be published, you'll get the best results if you
-See [[Tools#Tools_for_users_.2F_translators]]
+* run a spellcheck on the source text before translating, and
+* run a spellcheck on the target text after translating
+Remember that any machine translated text needs to be [[Post-editing|post-edited]] before publication.
+==Are there any graphical user interfaces or apps?==
+Other than http://apertium.org, see [[Tools#Tools_for_users_.2F_translators]]
+==What do the funny symbols like */#@ mean?==
+A star * means a word was unknown to the translator and passed through unchanged. For proper nouns, this is often OK, but other words might need manual correction. (Some times you might see other symbols like #/@, these are [[Apertium stream format|debug symbols]] which indicate a bug in the translator.)
 ==How do I make the translator ignore certain strings?==

@@ Line 35: / Line 35: @@
 * [[Translating QT Linguist TS-files]] for how to translate .ts files
 * [[Translating gettext]] for how to translate .po files
+* [[Translating JSON]] for how not to translate .json files
 * [[Translating subtitles]]
 * [[Translating wikimedia]]

@@ Line 4: / Line 4: @@
 ==How do I make the translator ignore certain strings?==
+Use one of the XML based modes, e.g. '''html''' and put <code><apertium-notrans></code> tags around the text you don't want translated. E.g.
-To ensure certain text is not translated, you can use the HTML format and put it in e.g. an html attribute. Say you're translating for some software and you have the input string:
-<pre>Today's date is DATE, and the weather outside is WEATHER.</pre>
-Then you could change it to e.g.
-<pre>Today's date is <a rel="DATE"/>, and the weather outside is <a rel="WEATHER"/>.</pre>
-and translate it with apertium -f html, then strip the html you added after it's translated, e.g.
-<pre>$ cat input.html
+<pre>
+$ echo "Translate me <apertium-notrans>don't translate me</apertium-notrans> but translate me" |apertium en-es -f html
-Today's date is <a rel="DATE"/>, and the weather outside is <a rel="WEATHER"/>
+Me traduzco <apertium-notrans>don't translate me</apertium-notrans> pero traducirme
-$ apertium en-ca -f html input.html | sed 's%<a rel="\([^"]*\)"/>%\1%g'
+</pre>
-Avui  la data &eacute;s DATE, i el temps exterior &eacute;s WEATHER</pre>
 ==The HTML format adds entities, I want plain (Unicode) symbols==

← Older revision		Revision as of 07:49, 5 April 2014
Line 21:		Line 21:
	This might not be preferable.		This might not be preferable.

	You can use the ~~<code>~~html-noent~~</code>~~ mode instead to avoid this.		You can use the '''html-noent''' mode instead to avoid this.

@@ Line 17: / Line 17: @@
 ==The HTML format adds entities, I want plain (Unicode) symbols==
 When using the HTML format, most non-ASCII characters are turned into HTML entities:
-<pre>$ echo "Today's <a href="http://time.org"/>date</a> is March 12th" |apertium -f html en-ca
+<pre>$ echo "Today's <a id="foo" href="http://time.org"/>date</a> is March 12th" |apertium -f html en-ca
-Avui  <a href=http://time.org/>la data</a> &eacute;s March 12&egrave;</pre>
+Avui  <a id="foo" href=http://time.org/>la data</a> &eacute;s March 12&egrave;</pre>
 This might not be preferable.
+You can use the <code>html-noent</code> mode instead to avoid this.
-If you have perl and perl-html-parser installed, you can append the following little script to the command:
+With older versions of apertium you have to use this hack: With have perl and perl-html-parser installed, you can append the following little script to the command:
 <pre>perl -we 'use HTML::Entities;binmode(STDOUT,":utf8");while(<STDIN>){print decode_entities($_);}'</pre>
 e.g.
-<pre>$ echo "Today's <a href="http://time.org"/>date</a> is March 12th" |apertium -f html en-ca|perl -we 'use HTML::Entities; binmode(STDOUT, ":utf8");while(<STDIN>) { print decode_entities($_); }'
+<pre>$ echo "Today's <a id="foo" href="http://time.org"/>date</a> is March 12th" |apertium -f html en-ca|perl -we 'use HTML::Entities; binmode(STDOUT, ":utf8");while(<STDIN>) { print decode_entities($_); }'
-Avui  <a href=http://time.org/>la data</a> és March 12è</pre>
+Avui  <a id="foo" href=http://time.org/>la data</a> és March 12è</pre>
 ==How do I use my translation memory (TMX) with Apertium?==