User Tools

Site Tools


text_hilight

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

text_hilight [2006/08/01 04:39] (current)
Line 1: Line 1:
 +======Special Text Highlighting Techniques======
 +
 +Although EPIC is a text-based irc client, it still has many ways of
 +marking text such that it stands out from the rest.  The simplest kinds
 +of text highlighting are **boldface**,​ __underline__,​ and **reverse
 +video**. ​ They work simply by surrounding the desired text with the
 +appropriate control characters:
 +
 +^   ​Char ​ ^  Input    ^  Name    ^    Description ​              ^
 +|%%^B%% ​  ​|**B** ​     |BOLD      | toggles boldfacing on/​off ​    |
 +|%%^C%% ​  ​|**C** ​     |COLOR ​    | begins a color code sequence ​ |
 +|%%^E%% ​  ​|**E** ​     |ALT_CHAR ​ | toggles alternate character set on/off |
 +|%%^F%% ​  ​|**F** ​     |BLINK ​    | toggles blinking video on/off |
 +|%%^S%% ​  ​|**S** ​     |ND_SPACE ​ | inserts a non-destructive space |
 +|%%^V%% ​  ​|**V** ​     |REVERSE ​  | toggles reverse video on/​off ​ |
 +|%%^_%% ​  ​|**_** ​     |UNDERLINE | toggles underlining on/​off ​   |
 +|%%^O%% ​  ​|**O** ​     |ALL_OFF ​  | turns off all highlighting ​   |
 +
 +The "​char"​ is the default keybinding for the desired effect; ^B
 +means control-b, etc.  The "​input"​ is how the character appears if typed
 +on the input line.  The "​name"​ is how the effect is referred to with 
 +[[set mangle_display]] and [[set mangle_logfiles]] and so on.  You can
 +suppress the effect by including it in the set value.
 +
 +All highlight characters, including color, are always guaranteed to be 
 +cumulative. ​ In older versions, turning certain highlight characters on
 +or off might (or might not) turn off other highlight characters, in 
 +unpredictable ways.  EPIC5 guarantees cumulative behavior.
 +
 +| BOLD + COLOR    | The foreground color is made "​bright" ​            |
 +| REVERSE + COLOR | Foreground color and background color are swapped |
 +| BLINK + COLOR   | The background color is made "​bright" ​            |
 +
 +For legacy reasons, EPIC also supports the use of ANSI escape sequences.
 +Historically,​ this was used by preformatted "ascii art"​. ​ A description ​
 +of ascii art is beyond the scope of this document. ​ If [[set mangle_display]]
 +contains NORMALIZE (and it does by default), ansi escape sequences are 
 +converted into things that are supported by EPIC, or stripped out if they
 +are not supported by EPIC.
 +
 +======Colors======
 +The color code character control-C is followed by one or two comma-separated
 +numbers. ​ The first number sets the text color. ​ The second number, if any,
 +sets the background color. ​ None of the other characters take an argument.
 +
 +All color numbers are converted into a canonical color number 0 to 7, and
 +unconditionally turn bold (for fg colors) and blink (for bg colors) on or off.
 +
 +^ Canonical Color ^ Color Name ^
 +| 0               | Black      |
 +| 1               | Red        |
 +| 2               | Green      |
 +| 3               | Yellow ​    |
 +| 4               | Blue       |
 +| 5               | Magenta ​   |
 +| 6               | Cyan       |
 +| 7               | White      |
 +
 +^  Code  ^ Canonical Color ^ Bold/Blink ^
 +|   ​0 ​   |  7              | Yes  |  ​
 +|   ​1 ​   |  0              | No   |
 +|   ​2 ​   |  4              | No   ​| ​
 +|   ​3 ​   |  2              | No   ​| ​
 +|   ​4 ​   |  1              | Yes  | 
 +|   ​5 ​   |  1              | No   ​| ​
 +|   ​6 ​   |  5              | No   ​| ​
 +|   ​7 ​   |  3              | No   ​| ​
 +|   ​8 ​   |  3              | Yes  | 
 +|   ​9 ​   |  2              | Yes  |
 +|  10    |  6              | No   |
 +|  11    |  6              | Yes  |
 +|  12    |  4              | Yes  |
 +|  13    |  5              | Yes  |
 +|  14    |  0              | Yes  |
 +|  15    |  7              | No   |
 +|  16    |  7              | Yes  |
 +|  30    |  0 (fg only)    | No   |
 +|  31    |  1 (fg only)    | No   |
 +|  32    |  2 (fg only)    | No   |
 +|  33    |  3 (fg only)    | No   |
 +|  34    |  4 (fg only)    | No   |
 +|  35    |  5 (fg only)    | No   |
 +|  36    |  6 (fg only)    | No   |
 +|  37    |  7 (fg only)    | No   |
 +|  40    |  0 (bg only)    | No   ​| ​
 +|  41    |  1 (bg only)    | No   ​| ​
 +|  42    |  2 (bg only)    | No   ​| ​
 +|  43    |  3 (bg only)    | No   ​| ​
 +|  44    |  4 (bg only)    | No   ​| ​
 +|  45    |  5 (bg only)    | No   ​| ​
 +|  46    |  6 (bg only)    | No   ​| ​
 +|  47    |  7 (bg only)    | No   ​| ​
 +|  50    |  0              | Yes  |
 +|  51    |  1              | Yes  |
 +|  52    |  2              | Yes  |
 +|  53    |  3              | Yes  |
 +|  54    |  4              | Yes  |
 +|  55    |  5              | Yes  |
 +|  56    |  6              | Yes  |
 +|  57    |  7              | Yes  |
 +
 +It is important to note that if you want to set the background color but 
 +leave the foreground color alone, you omit the foreground color:
 +   ​^C,​47 ​       (set the background to white)
 +
  
text_hilight.txt ยท Last modified: 2006/08/01 04:39 (external edit)