home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 April / Chip_2004-04_cd1.bin / software / tux / tuxpaint.exe / docs / ESCAPES.txt < prev    next >
Encoding:
Text File  |  2003-12-24  |  7.0 KB  |  215 lines

  1. ESCAPES.txt for Tux Paint
  2.  
  3. Tux Paint - A simple drawing program for children.
  4.  
  5. Copyright 2003 by Bill Kendrick
  6. bill@newbreedsoftware.com
  7. http://www.newbreedsoftware.com/tuxpaint/
  8.  
  9. February 1, 2003 - February 1, 2003
  10.  
  11.  
  12. About Escape Sequences
  13. ----------------------
  14.   Tux Paint allows the use of HTML escape sequences in the description files
  15.   (".txt" files) it reads when loading Rubber Stamp images.
  16.   (See README.txt for more information on creating your own rubber stamps.)
  17.   
  18.   The escape sequences provide a way of entering hard-to-type ASCII
  19.   characters into the text file.  The escape sequences Tux Paint supports
  20.   are identical to those used in HTML pages on the web.
  21.  
  22.   A sequence begins with the "&" character (ampersand), and ends with
  23.   the ";" character (semicolon).  For example: "ï".
  24.  
  25.  
  26. Using Escape Sequences in Tux Paint
  27. -----------------------------------
  28.   To use a string containing escape sequences in a rubber stamp description
  29.   file (the ".txt" file that corresponds to the stamps ".png" image file),
  30.   the line containing the translated description should begin with the
  31.   language's "locale code", followed by ".esc=" and the description text.
  32.  
  33.   For example, a Spanish translation of a string in plain ASCII might look
  34.   like this:
  35.  
  36.     es=Hola
  37.  
  38.   A Spanish translation that takes advantage of the HTML-style escape
  39.   sequences might look like this:
  40.  
  41.     es.esc=¡Hola niños!
  42.   
  43.  
  44.   In both cases, the "es" at the beginning of the line corresponds to the
  45.   language of the description: Spanish.
  46.   (See README.txt for a list of languages supported by Tux Paint, and their
  47.   locale codes.)
  48.  
  49.   In the latter example, the "¡" is an 'escape sequence' that
  50.   represents an inverted (upside-down) exclamation point ("!"), which
  51.   looks like this:  "í"
  52.  
  53.   The "ñ" represents an "n" with a tilde ("~") over it.
  54.   The Spanish character:  "±"
  55.  
  56.  
  57.   This example could have been easily done using plain ASCII, like so:
  58.  
  59.     es=íHola ni±os!
  60.  
  61.   However, depending on the text editor being used, typing that literally
  62.   may not be an easy task.  Typing the letters A-Z and punctuation should
  63.   never be a problem, though.  This is why escape sequence support was
  64.   added to Tux Paint.
  65.  
  66.  
  67.   NOTE: Since the ampersand character ("&") is used to denote the beginning
  68.   of an escape sequence, it itself must be escaped.  Use the sequence "&"
  69.  
  70.   For example, in plain ASCII:
  71.  
  72.     xx=This & that
  73.  
  74.   Should be written as follows when using the escape sequence mode:
  75.  
  76.     xx.esc=This & that
  77.  
  78.  
  79.   The following is INCORRECT, and will end up truncated to just the word "This":
  80.  
  81.     xx.esc=This & that
  82.  
  83.  
  84.  
  85. Supported Escape Sequences
  86. --------------------------
  87.   Sequence   Character   Description
  88.   --------   ---------   -----------
  89.   à       α       Lowercase a grave
  90.   á       ß       Lowercase a acute
  91.   â        Γ       Lowercase a circumflex
  92.   ã       π       Lowercase a tilde
  93.   ä         Σ       Lowercase a umlaut
  94.   å        σ       Lowercase a ring
  95.  
  96.   À       └       Uppercase A grave
  97.   Á       ┴       Uppercase A acute
  98.   Â        ┬       Uppercase A circumflex
  99.   Ã       ├       Uppercase A tilde
  100.   Ä         ─       Uppercase A umlaut
  101.   Å        ┼       Uppercase A ring
  102.  
  103.   æ        µ       Lowercase ae ligature
  104.   Æ        ╞       Uppercase AE ligature
  105.  
  106.   ç       τ       Lowercase c cedil
  107.   Ç       ╟       Uppercase C cedil
  108.  
  109.   ð          ≡       Lowercase eth
  110.   Ð          ╨       Uppercase Eth
  111.  
  112.   è       Φ       Lowercase e grave
  113.   é       Θ       Lowercase e acute
  114.   ê        Ω       Lowercase e circumflex
  115.   ë         δ       Lowercase e umlaut
  116.  
  117.   È       ╚       Uppercase E grave
  118.   É       ╔       Uppercase E acute
  119.   Ê        ╩       Uppercase E circumflex
  120.   Ë         ╦       Uppercase E umlaut
  121.  
  122.   ì       ∞       Lowercase i grave
  123.   í       φ       Lowercase i acute
  124.   î        ε       Lowercase i circumflex
  125.   ï         ∩       Lowercase i umlaut
  126.  
  127.   Ì       ╠       Uppercase I grave
  128.   Í       ═       Uppercase I acute
  129.   Î        ╬       Uppercase I circumflex
  130.   Ï         ╧       Uppercase I umlaut
  131.  
  132.   ò       ≥       Lowercase o grave
  133.   ó       ≤       Lowercase o acute
  134.   ô        ⌠       Lowercase o circumflex
  135.   õ       ⌡       Lowercase o tilde
  136.   ö         ÷       Lowercase o umlaut
  137.   ø       °       Lowercase o slash
  138.  
  139.   Ò       ╥       Uppercase O grave
  140.   Ó       ╙       Uppercase O acute
  141.   Ô        ╘       Uppercase O circumflex
  142.   Õ       ╒       Uppercase O tilde
  143.   Ö         ╓       Uppercase O umlaut
  144.   Ø       ╪       Uppercase O slash
  145.  
  146.   ù       ∙       Lowercase u grave
  147.   ú       ·       Lowercase u acute
  148.   û        √       Lowercase u circumflex
  149.   ü         ⁿ       Lowercase u umlaut
  150.  
  151.   Ù       ┘       Uppercase U grave
  152.   Ú       ┌       Uppercase U acute
  153.   Û        █       Uppercase U circumflex
  154.   Ü         ▄       Uppercase U umlaut
  155.  
  156.   ñ       ±       Lowercase n tilde
  157.   Ñ       ╤       Uppercase N tilde
  158.  
  159.   ß        ▀       Sharp S
  160.  
  161.   ý       ²       Lowercase y acute
  162.   ÿ                 Lowercase y umlaut
  163.   Ý       ▌       Uppercase Y acute
  164.  
  165.   þ        ■       Lowercase thorn
  166.   Þ        ▐       Uppercase thorn
  167.  
  168.   ¡        í       Inverted exclamation
  169.   ¿       ┐       Inverte question mark
  170.   «        ½       Left angle quotes
  171.   »        ╗       Right angle quotes
  172.  
  173.   ¢         ó       Cent sign
  174.   £        ú       Pound sign
  175.   ¤       ñ       Currency sign
  176.   ¥          Ñ       Yen sign
  177.  
  178.   ´        ┤       Acute
  179.   ¸        ╕       Cedil
  180.   ¨          ¿       Umlaut
  181.  
  182.   "         "       Quote
  183.   &          &       Ampersand
  184.   <           <       Less than
  185.   >           >       Greater than
  186.  
  187.   ±       ▒       Plus-minus sign
  188.   ×        ╫       Times sign
  189.   ÷       ≈       Division sign
  190.   ¬          ¼       Logical not sign
  191.   °          ░       Degree sign
  192.   µ        ╡       Micro sign
  193.  
  194.   ¼       ╝       One quarter (1/4)
  195.   ½       ╜       One half (1/2)
  196.   ¾       ╛       Three quarters (3/4)
  197.  
  198.   ¹         ╣       Superscript 1
  199.   ²         ▓       Superscript 2
  200.   ³         │       Superscript 3
  201.  
  202.   ¦       ª       Broken vertical bar
  203.   §         º       Section sign
  204.   ¶         ╢       Paragraph sign
  205.   ·       *       Middle dot
  206.  
  207.   ©         ⌐       Copyright sign ((C))
  208.   ®          «       Registered trademark sign ((R))
  209.  
  210.   ª         ¬       Feminine ordinal
  211.   º         ║       Masculine ordinal
  212.   ­          ¡       Soft hyphen
  213.   ¯         »       Spacing macron
  214.  
  215.