Translate Characters - Revision history

Jsimlo at 23:35, 20 November 2013

2013-11-20T23:35:27Z

Jsimlo at 15:07, 2 October 2013

2013-10-02T15:07:31Z

Jsimlo at 14:54, 2 October 2013

2013-10-02T14:54:45Z

Jsimlo at 21:19, 1 October 2013

2013-10-01T21:19:21Z

Jsimlo at 21:18, 1 October 2013

2013-10-01T21:18:15Z

Kew at 07:50, 29 June 2011

2011-06-29T07:50:34Z

Jsimlo at 20:31, 7 May 2011

2011-05-07T20:31:30Z

Jsimlo at 19:52, 7 May 2011

2011-05-07T19:52:18Z

Jsimlo: Created page with '{{manversion|5.3.0.2}}NOTOC ====Translate Characters.. (Alt+Ctrl+T)==== Asks for {{field|Find what}} and {{field|Translate to}} {{defined|strings}}. T…'

2011-05-02T16:10:42Z

Created page with '<noinclude>{{manversion|5.3.0.2}}__NOTOC__</noinclude> ====Translate Characters.. (Alt+Ctrl+T)==== Asks for {{field|Find what}} and {{field|Translate to}} {{defined|strings}}. T…'

New page

<noinclude>{{manversion|5.3.0.2}}__NOTOC__</noinclude>
====Translate Characters.. (Alt+Ctrl+T)====

Asks for {{field|Find what}} and {{field|Translate to}} {{defined|strings}}. Then translates in the selection all occurrences of each character from {{field|Find what}} to the corresponding character from {{field|Translate to}}. If {{field|Translate to}} {{defined|string}} is shorter than {{field|Find what}}, the extra characters from {{field|Find what}} are being deleted from the selection instead of translating.

Optionally, it can {{field|Delete all other characters}} that are not included in {{field|Find what}} string. Note: Even if {{field|Delete all other characters}} is turned on, if {{field|Translate to}} string is shorter than {{field|Find what}} string, the extra characters are deleted too.

Note: This tool is always {{defined|case sensitive}}. Convert the text to lower case before this tool to gain case insensitive behaviour.

{{example_start}}Example:
{{example_body}}{{example_select|TED Notepad for Windows}}
{{example_end}}

{{example_start}}Result: (using {{field|Find what}}: {{string|EDNopadfWinws}} and {{field|Translate to}}: {{string|enmeorspparc.}})
{{example_body}}Ten meteors per parsec.
{{example_end}}

@@ Line 36: / Line 36: @@
 Note: Characters not specified in {{field|Translate Characters|Find}} are not modified, unless {{field|Translate Characters|Delete all other characters}} option is turned on.
-Note: This tool is always {{defined|case sensitive}}. You need to specify translation for both {{defined|lower case}} and {{defined|upper case}} characters, if {{defined|case insensitiveness}} is expected.
+Note: This tool is always {{defined|case sensitive}}. You need to specify translation for both {{defined|lower case}} and {{defined|upper case}} characters, if {{defined|case insensitive|case insensitiveness}} is expected.
 {{example_start}}Example:

@@ Line 17: / Line 17: @@
 ** If a range in {{field|Translate Characters|Translate to}} is shorter than a corresponding range in {{field|Translate Characters|Find}}, the last character from the {{field|Translate Characters|Translate to}} range is repeated as many times as necessary to satisfy the orphaned characters from {{field|Translate Characters|Find}} range. For example, translating {{string|a-c}} to {{string|1-2}} would be equivalent to translating {{string|abc}} to {{string|122}}, the last member of the second range being repeated to fill up to the length of the fisrt range.
 ** If both {{field|Translate Characters|Find}} and {{field|Translate Characters|Translate to}} contain mix of ranges and simple characters, they are paired before the ranges are mapped to each other. For example, translating {{string|a-cde-f}} to {{string|1-456}} would be equivalent to translating {{string|a-c}} and {{string|d}} and {{string|e-f}} to {{string|1-4}} and {{string|5}} and {{string|6}}, which would be equivalent to translating {{string|abcdef}} to {{string|123566}}. This is because {{string|a-c}} is mapped to {{string|1-4}} ignoring the overhang; {{string|d}} is mapped to {{string|5}}; and then {{string|e-f}} is mapped to {{string|6}} applying repeating of the last replacement character.
+* Escapes provide an easy way to enter special characters, which are difficult to type:
+** {{string|\n}} &mdash; newline (NL).
+** {{string|\r}} &mdash; carriage return (CR).
-{{todo|Escapes
+** {{string|\t}} &mdash; horizontal tab character (TAB).
+** {{string|\f}} &mdash; form feed character (FF).
- 	 \t: \t
+** {{string|\a}} &mdash; bell character (BEL).
- 	 \f: \f
+** {{string|\v}} &mdash; vertical tab (VT).
- 	 \a: \a
+** {{string|\e}} &mdash; escape character (ESC).
- 	 \v: \v
+** {{string|\0}} &mdash; null character (NUL).
- 	 \e: \x1B
+** {{string|\x}}''hh'' &mdash; character given in ''hh'' hex notation.
- 	 \b: \b
+** {{string|\u}}''hhhh'' &mdash; character given in ''hhhh'' unicode notation (unicode version only).
- 	 \n: NL
+** {{string|\c}}''K'' &mdash; character given in control notation. The letter ''K'' can be any capital letter from A to Z, where A stands for {{string|\x00}}, B stands for {{string|\x01}}, C stands for {{string|\x03}}, etc.
- 	 \r: CR
+** {{string|\\}} &mdash; ordinary back-slash {{string|\}} character.
- 	 \0: NUL
+** {{string|\-}} &mdash; ordinary dash {{string|-}} character.
- 	 \x: \xhh
+* All other escapes are left as they appear and are considered to be two ordinary characters for user convenience. Using {{string|\?}} is therefore allowed and is equivalent to an escaped version {{string|\\?}}.
- 	 \u: \xhhhh
+* Note: It is allowed to use escapes within ranges, i.e. it is allowed to {{field|Translate Characters|Find}} range {{string|\cA-\cZ}} and {{field|Translate Characters|Translate to}} range {{string|A-Z}}.
 Note: Characters not specified in {{field|Translate Characters|Find}} are not modified, unless {{field|Translate Characters|Delete all other characters}} option is turned on.

@@ Line 12: / Line 12: @@
 Optionally, {{field|Translate Characters|Delete all other characters}} option can be used to delete all characters, which are not specified in the {{field|Translate Characters|Find}}. Note: Even if {{field|Translate Characters|Delete all other characters}} is turned on, the translation of characters still requires that every character from {{field|Translate Characters|Find}} has a corresponding character in {{field|Translate Characters|Translate to}}. If {{field|Translate Characters|Translate to}} is shorter than {{field|Translate Characters|Find}}, extra characters from {{field|Translate Characters|Find}} are again translated to ''nothing'', deleting them from the results as well.
-Optionally, {{field|Translate Characters|Escapes & ranges}} option can be used to turn on recognition of character ranges within {{field|Translate Characters|Find}} and {{field|Translate Characters|Translate to}}. Character ranges allow to easily specify entire sets of characters, e.g. {{string|a-z}} or {{string|0-9}}. Note however, that using ranges has a few limitations/caveats.
+Optionally, {{field|Translate Characters|Escapes & ranges}} option can be used to turn on recognition of character ranges within {{field|Translate Characters|Find}} and {{field|Translate Characters|Translate to}}.
 {{todo|Escapes
@@ Line 35: / Line 41: @@
           \l   ordinary l character
           ...  ........
 }}

@@ Line 16: / Line 16: @@
 {{todo|Escapes
-	 \t: \t
+ 	 \t: \t
-	 \f: \f
+ 	 \f: \f
-	 \a: \a
+ 	 \a: \a
-	 \v: \v
+ 	 \v: \v
-	 \e: \x1B
+ 	 \e: \x1B
-	 \b: \b
+ 	 \b: \b
-	 \n: NL
+ 	 \n: NL
-	 \r: CR
+ 	 \r: CR
-	 \0: NUL
+ 	 \0: NUL
-	 \x: \xhh
+ 	 \x: \xhh
-	 \u: \xhhhh
+ 	 \u: \xhhhh
-	 \c: \cA
+ 	 \c: \cA
-	 \\: back-slash
+ 	 \\: back-slash
           \-: dash
@@ Line 39: / Line 39: @@
 {{todo|Ranges
 -on-1 (range-on-range) mapping between find and replace
       -- extra replace characters are discarded if too many in repl range
       -- and last replace character is repeated if too few in repl range

@@ Line 12: / Line 12: @@
 Optionally, {{field|Translate Characters|Delete all other characters}} option can be used to delete all characters, which are not specified in the {{field|Translate Characters|Find}}. Note: Even if {{field|Translate Characters|Delete all other characters}} is turned on, the translation of characters still requires that every character from {{field|Translate Characters|Find}} has a corresponding character in {{field|Translate Characters|Translate to}}. If {{field|Translate Characters|Translate to}} is shorter than {{field|Translate Characters|Find}}, extra characters from {{field|Translate Characters|Find}} are again translated to ''nothing'', deleting them from the results as well.
-Optionally, {{field|Translate Characters|Escapes & ranges}} option can be used to turn on recognition of character ranges within {{field|Translate Characters|Find}} and {{field|Translate Characters|Translate to}}. Character ranges allow to easily specify entire sets of characters, e.g. {{string|a-z}} or {{string|0-9}}. Note however, that using ranges has a few limitations/caveats. {{todo|Escapes & ranges specifics}}
+Optionally, {{field|Translate Characters|Escapes & ranges}} option can be used to turn on recognition of character ranges within {{field|Translate Characters|Find}} and {{field|Translate Characters|Translate to}}. Character ranges allow to easily specify entire sets of characters, e.g. {{string|a-z}} or {{string|0-9}}. Note however, that using ranges has a few limitations/caveats.
 Note: Characters not specified in {{field|Translate Characters|Find}} are not modified, unless {{field|Translate Characters|Delete all other characters}} option is turned on.

@@ Line 1: / Line 1: @@
-<noinclude>{{manversion|6.0.0.16|feature}}__NOTOC__</noinclude>
+<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
-====Translate Characters.. (Alt+Ctrl+T)====
+{{#headline:Text tools|Translate Characters.. (Alt+Ctrl+T)}}
 Asks for {{field|Translate Characters|Find}} and {{field|Translate Characters|Translate to}} character maps. Then translates the characters in the selection by replacing all occurrences of each character from {{field|Translate Characters|Find}} with corresponding character from {{field|Translate Characters|Translate to}}.

@@ Line 12: / Line 12: @@
 Optionally, {{field|Translate Characters|Delete all other characters}} option can be used to delete all characters, which are not specified in the {{field|Translate Characters|Find}}. Note: Even if {{field|Translate Characters|Delete all other characters}} is turned on, the translation of characters still requires that every character from {{field|Translate Characters|Find}} has a corresponding character in {{field|Translate Characters|Translate to}}. If {{field|Translate Characters|Translate to}} is shorter than {{field|Translate Characters|Find}}, extra characters from {{field|Translate Characters|Find}} are again translated to ''nothing'', deleting them from the results as well.
-Optionally, {{field|Translate Characters|Escapes & ranges}} option can be used to turn on recognization of character ranges within {{field|Translate Characters|Find}} and {{field|Translate Characters|Translate to}}. Character ranges allow to easily specify entire sets of characters, e.g. {{string|a-z}} or {{string|0-9}}. Note however, that using ranges has a few limitations/caveats. {{todo|Escapes & ranges}}
+Optionally, {{field|Translate Characters|Escapes & ranges}} option can be used to turn on recognition of character ranges within {{field|Translate Characters|Find}} and {{field|Translate Characters|Translate to}}. Character ranges allow to easily specify entire sets of characters, e.g. {{string|a-z}} or {{string|0-9}}. Note however, that using ranges has a few limitations/caveats. {{todo|Escapes & ranges specifics}}
 Note: Characters not specified in {{field|Translate Characters|Find}} are not modified, unless {{field|Translate Characters|Delete all other characters}} option is turned on.
-Note: This tool is always {{defined|case sensitive}}. You may need to specify translation for both {{defined|lower case}} and {{defined|upper case}} characters, if {{defined|case insensitiveness}} is expected.
+Note: This tool is always {{defined|case sensitive}}. You need to specify translation for both {{defined|lower case}} and {{defined|upper case}} characters, if {{defined|case insensitiveness}} is expected.
 {{example_start}}Example:
@@ Line 26: / Line 26: @@
 {{example_end}}
-Note: {{feature|Translate Characters}} tool can have similar effect as, for example, {{feature|All Upper Case}} tool:
+{{feature|Translate Characters}} tool can have similar effect as, for example, {{feature|All Upper Case}} tool:
 {{example_start}}Result: (using {{field|Translate Characters|Find}}: {{string|a-z}} and {{field|Translate Characters|Translate to}}: {{string|A-Z}})
 {{example_body}}TED NOTEPAD FOR WINDOWS
 {{example_end}}

@@ Line 1: / Line 1: @@
-<noinclude>{{manversion|5.3.0.2}}__NOTOC__</noinclude>
+<noinclude>{{manversion|6.0.0.16|feature}}__NOTOC__</noinclude>
 ====Translate Characters.. (Alt+Ctrl+T)====
-Asks for {{field|Find what}} and {{field|Translate to}} {{defined|strings}}. Then translates in the selection all occurrences of each character from {{field|Find what}} to the corresponding character from {{field|Translate to}}. If {{field|Translate to}} {{defined|string}} is shorter than {{field|Find what}}, the extra characters from {{field|Find what}} are being deleted from the selection instead of translating.
+Asks for {{field|Translate Characters|Find}} and {{field|Translate Characters|Translate to}} character maps. Then translates the characters in the selection by replacing all occurrences of each character from {{field|Translate Characters|Find}} with corresponding character from {{field|Translate Characters|Translate to}}.
-Optionally, it can {{field|Delete all other characters}} that are not included in {{field|Find what}} string. Note: Even if {{field|Delete all other characters}} is turned on, if {{field|Translate to}} string is shorter than {{field|Find what}} string, the extra characters are deleted too.
+Note that {{field|Translate Characters|Find}} and {{field|Translate Characters|Translate to}} represent ''lists'' of characters rather than entire phrases. By assigning the first character from {{field|Translate Characters|Find}} to the first character from {{field|Translate Characters|Translate to}}, the second character from {{field|Translate Characters|Find}} to the second character from {{field|Translate Characters|Translate to}}, etc., the tool creates a so called ''character translation map'' (similar to one used by Boy Scouts for substitution cipher encryption). With this ''translation map'', individual characters of the selection are then substituted for other characters (as Boy Scouts are encrypting a secret message).
-Note: This tool is always {{defined|case sensitive}}. Convert the text to lower case before this tool to gain case insensitive behaviour.
+If {{field|Translate Characters|Translate to}} is shorter than {{field|Translate Characters|Find}}, extra characters from {{field|Translate Characters|Find}} are translated to ''nothing'', effectively deleting them from the results.
 {{example_start}}Example:
@@ Line 12: / Line 22: @@
 {{example_end}}
-{{example_start}}Result: (using {{field|Find what}}: {{string|EDNopadfWinws}} and {{field|Translate to}}: {{string|enmeorspparc.}})
+{{example_start}}Result: (using {{field|Translate Characters|Find}}: {{string|EDNopadfWinws}} and {{field|Translate Characters|Translate to}}: {{string|enmeorspparc.}})
 {{example_body}}Ten meteors per parsec.
 {{example_end}}