| 1 | [README.Schema] |
|---|
| 2 | |
|---|
| 3 | The schemata offered in the Options/Schema menu are |
|---|
| 4 | taken from from configurations files with a *.schema |
|---|
| 5 | pattern either located in $KDEDIR/share/apps/konsole |
|---|
| 6 | or ~/.kde/share/apps/konsole. |
|---|
| 7 | |
|---|
| 8 | Schemata allow to configure the color set that konsole |
|---|
| 9 | uses, together with some more information on rendition |
|---|
| 10 | processing. |
|---|
| 11 | |
|---|
| 12 | Syntax |
|---|
| 13 | |
|---|
| 14 | File |
|---|
| 15 | :: { [Line] ['#' Comment] '\n' } |
|---|
| 16 | |
|---|
| 17 | Line |
|---|
| 18 | :: "title" Title |
|---|
| 19 | :: "image" Usage PathToPictureFile |
|---|
| 20 | :: "transparency" Fade Red Green Blue |
|---|
| 21 | :: "color" Slot Red Green Blue Transparent Bold |
|---|
| 22 | :: "rcolor" Slot Saturation Value Transparent Bold |
|---|
| 23 | :: "sysfg" Slot Transparent Bold |
|---|
| 24 | :: "sysbg" Slot Transparent Bold |
|---|
| 25 | |
|---|
| 26 | Meaning |
|---|
| 27 | |
|---|
| 28 | - Title is the text to appear in the Option/Schema menu. |
|---|
| 29 | It should be unique among all other schemata therefore. |
|---|
| 30 | |
|---|
| 31 | - The "image" clause allows to place an image on the |
|---|
| 32 | konsole's background. |
|---|
| 33 | |
|---|
| 34 | - Usage can be either |
|---|
| 35 | - "tile" - the image is tilewise replicated. |
|---|
| 36 | - "center" - the image is centered. |
|---|
| 37 | - "full" - the image is stretched to fit the window size. |
|---|
| 38 | |
|---|
| 39 | - The Path of the picture can both be relative |
|---|
| 40 | (to kde wallpapers) or absolute. |
|---|
| 41 | |
|---|
| 42 | When a schema uses a background image (or transparency) |
|---|
| 43 | one has to make at least one color slot transparent to |
|---|
| 44 | achieve any visible effect. Please read below about the |
|---|
| 45 | "Transparent" field in color,sysbg,sysfg. |
|---|
| 46 | |
|---|
| 47 | - The "transparency" clause picks and uses the background |
|---|
| 48 | of the desktop as if it where an image together with |
|---|
| 49 | a fade effect. This effect will fade the background |
|---|
| 50 | to the specified color. |
|---|
| 51 | |
|---|
| 52 | The "Fade" is a real value between 0 and 1, indicating |
|---|
| 53 | the strength of the fade. A value of 0 will not change |
|---|
| 54 | the image, a value of 1 will make it the fade color |
|---|
| 55 | everywhere, and in between. This will make the "glas" |
|---|
| 56 | of the window be of the color given in the clause and |
|---|
| 57 | being more(1) or less(0) intransparent. |
|---|
| 58 | |
|---|
| 59 | - The remaining clauses (color,sysbg,sysfg) are used |
|---|
| 60 | to setup konsoles rendition system. |
|---|
| 61 | |
|---|
| 62 | To this end, konsole offers 20 color slots. |
|---|
| 63 | |
|---|
| 64 | Slot Meaning |
|---|
| 65 | ----- -------------------------- |
|---|
| 66 | 0 regular foreground color |
|---|
| 67 | 1 regular background color |
|---|
| 68 | 2-9 regular bgr color 0-7 |
|---|
| 69 | 10 intensive foreground color |
|---|
| 70 | 11 intensive background color |
|---|
| 71 | 12-19 intensive bgr color 0-7 |
|---|
| 72 | |
|---|
| 73 | The traditional meaning of the "bgr" color codes |
|---|
| 74 | has a bitwise interpretation of an additive three |
|---|
| 75 | primary color scheme inherited from early EGA |
|---|
| 76 | color terminals. |
|---|
| 77 | |
|---|
| 78 | Color Bits Colors |
|---|
| 79 | ----- ---- ------- |
|---|
| 80 | 0 000 Black |
|---|
| 81 | 1 001 Red |
|---|
| 82 | 2 010 Green |
|---|
| 83 | 3 011 Yellow |
|---|
| 84 | 4 100 Blue |
|---|
| 85 | 5 101 Magenta |
|---|
| 86 | 6 110 Cyan |
|---|
| 87 | 7 111 White |
|---|
| 88 | |
|---|
| 89 | One may or may not stick to this tradition. |
|---|
| 90 | Konsole allows to assign colors freely to slots. |
|---|
| 91 | |
|---|
| 92 | The slots fall apart into two groups, regular |
|---|
| 93 | and intensive colors. The later are used when |
|---|
| 94 | BOLD rendition is used by the client. |
|---|
| 95 | |
|---|
| 96 | Each of the groups have a default fore- and |
|---|
| 97 | background color and the said bgr colors. |
|---|
| 98 | Normal terminal processing will simply use |
|---|
| 99 | the default colors. |
|---|
| 100 | |
|---|
| 101 | The color desired for a slot is indicated |
|---|
| 102 | in the Red Green Blue fields of the color |
|---|
| 103 | clause. Use the sysfg or the sysbg clause |
|---|
| 104 | to indicate the default fore and background |
|---|
| 105 | colors of the desktop. |
|---|
| 106 | |
|---|
| 107 | To specify randomized color for a slot use |
|---|
| 108 | the clause rcolor. The two parameters to it |
|---|
| 109 | being Saturation - the amount of colour, |
|---|
| 110 | and Value, the darkness of the colour. |
|---|
| 111 | |
|---|
| 112 | To use transparency/images and to simulate |
|---|
| 113 | the behavior of the xterm, one can supply |
|---|
| 114 | two additional tags to each slot: |
|---|
| 115 | - Transparent (0/1) meaning to show the |
|---|
| 116 | background picture, if any. |
|---|
| 117 | - Bold (0/1) to render characters bold. |
|---|
| 118 | |
|---|
| 119 | |
|---|
| 120 | If you know about the escape codes, you might have |
|---|
| 121 | noticed that intensive and bold rendition are sort |
|---|
| 122 | of confused. This is inherited by the xterm which |
|---|
| 123 | konsole is simulating. |
|---|
| 124 | |
|---|
| 125 | One can use the colortest.sh script supplied |
|---|
| 126 | with the konsole source distribution to test |
|---|
| 127 | a schema. |
|---|
| 128 | |
|---|
| 129 | The schema installed with konsole are more or |
|---|
| 130 | less demonstrations and not really beauty, |
|---|
| 131 | beside the Linux.schema, perhaps, which is |
|---|
| 132 | made after the VGA colors. |
|---|
