tuxpaint-pencil-sharpener/docs/ESCAPES.txt
2003-02-24 01:46:52 +00:00

214 lines
6.8 KiB
Text
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

ESCAPES.txt for Tux Paint
Tux Paint - A simple drawing program for children.
Copyright 2003 by Bill Kendrick
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/tuxpaint/
February 1, 2003 - February 1, 2003
About Escape Sequences
----------------------
Tux Paint allows the use of HTML escape sequences in the description files
(".txt" files) it reads when loading Rubber Stamp images.
(See README.txt for more information on creating your own rubber stamps.)
The escape sequences provide a way of entering hard-to-type ASCII
characters into the text file. The escape sequences Tux Paint supports
are identical to those used in HTML pages on the web.
A sequence begins with the "&" character (ampersand), and ends with
the ";" character (semicolon). For example: "ï".
Using Escape Sequences in Tux Paint
-----------------------------------
To use a string containing escape sequences in a rubber stamp description
file (the ".txt" file that corresponds to the stamps ".png" image file),
the line containing the translated description should begin with the
language's "locale code", followed by ".esc=" and the description text.
For example, a Spanish translation of a string in plain ASCII might look
like this:
es=Hola
A Spanish translation that takes advantage of the HTML-style escape
sequences might look like this:
es.esc=¡Hola niños!
In both cases, the "es" at the beginning of the line corresponds to the
language of the description: Spanish.
(See README.txt for a list of languages supported by Tux Paint, and their
locale codes.)
In the latter example, the "¡" is an 'escape sequence' that
represents an inverted (upside-down) exclamation point ("!"), which
looks like this: "¡"
The "ñ" represents an "n" with a tilde ("~") over it.
The Spanish character: "ñ"
This example could have been easily done using plain ASCII, like so:
es=¡Hola niños!
However, depending on the text editor being used, typing that literally
may not be an easy task. Typing the letters A-Z and punctuation should
never be a problem, though. This is why escape sequence support was
added to Tux Paint.
NOTE: Since the ampersand character ("&") is used to denote the beginning
of an escape sequence, it itself must be escaped. Use the sequence "&"
For example, in plain ASCII:
xx=This & that
Should be written as follows when using the escape sequence mode:
xx.esc=This & that
The following is INCORRECT, and will end up truncated to just the word "This":
xx.esc=This & that
Supported Escape Sequences
--------------------------
Sequence Character Description
-------- --------- -----------
à à Lowercase a grave
á á Lowercase a acute
â â Lowercase a circumflex
ã ã Lowercase a tilde
ä ä Lowercase a umlaut
å å Lowercase a ring
À À Uppercase A grave
Á Á Uppercase A acute
  Uppercase A circumflex
à à Uppercase A tilde
Ä Ä Uppercase A umlaut
Å Å Uppercase A ring
æ æ Lowercase ae ligature
Æ Æ Uppercase AE ligature
ç ç Lowercase c cedil
Ç Ç Uppercase C cedil
ð ð Lowercase eth
Ð Ð Uppercase Eth
è è Lowercase e grave
é é Lowercase e acute
ê ê Lowercase e circumflex
ë ë Lowercase e umlaut
È È Uppercase E grave
É É Uppercase E acute
Ê Ê Uppercase E circumflex
Ë Ë Uppercase E umlaut
ì ì Lowercase i grave
í í Lowercase i acute
î î Lowercase i circumflex
ï ï Lowercase i umlaut
Ì Ì Uppercase I grave
Í Í Uppercase I acute
Î Î Uppercase I circumflex
Ï Ï Uppercase I umlaut
ò ò Lowercase o grave
ó ó Lowercase o acute
ô ô Lowercase o circumflex
õ õ Lowercase o tilde
ö ö Lowercase o umlaut
ø ø Lowercase o slash
Ò Ò Uppercase O grave
Ó Ó Uppercase O acute
Ô Ô Uppercase O circumflex
Õ Õ Uppercase O tilde
Ö Ö Uppercase O umlaut
Ø Ø Uppercase O slash
ù ù Lowercase u grave
ú ú Lowercase u acute
û û Lowercase u circumflex
ü ü Lowercase u umlaut
Ù Ù Uppercase U grave
Ú Ú Uppercase U acute
Û Û Uppercase U circumflex
Ü Ü Uppercase U umlaut
ñ ñ Lowercase n tilde
Ñ Ñ Uppercase N tilde
ß ß Sharp S
ý ý Lowercase y acute
ÿ ÿ Lowercase y umlaut
Ý Ý Uppercase Y acute
þ þ Lowercase thorn
Þ Þ Uppercase thorn
¡ ¡ Inverted exclamation
¿ ¿ Inverte question mark
« « Left angle quotes
» » Right angle quotes
¢ ¢ Cent sign
£ £ Pound sign
¤ ¤ Currency sign
¥ ¥ Yen sign
´ ´ Acute
¸ ¸ Cedil
¨ ¨ Umlaut
" " Quote
& & Ampersand
&lt; < Less than
&gt; > Greater than
&plusmn; ± Plus-minus sign
&times; × Times sign
&divide; ÷ Division sign
&not; ¬ Logical not sign
&deg; ° Degree sign
&micro; µ Micro sign
&frac14; ¼ One quarter (1/4)
&frac12; ½ One half (1/2)
&frac34; ¾ Three quarters (3/4)
&sup1; ¹ Superscript 1
&sup2; ² Superscript 2
&sup3; ³ Superscript 3
&brvbar; ¦ Broken vertical bar
&sect; § Section sign
&para; ¶ Paragraph sign
&middot; * Middle dot
&copy; © Copyright sign ((C))
&reg; ® Registered trademark sign ((R))
&ordf; ª Feminine ordinal
&ordm; º Masculine ordinal
&shy; ­ Soft hyphen
&macr; ¯ Spacing macron