-
Notifications
You must be signed in to change notification settings - Fork 1
/
README
124 lines (81 loc) · 3.87 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
xtheme - An XTerm/UXTerm/RXVT/URXVT themeing tool
gh: emctague/xtheme
Generates .Xresources and .Xdefaults based on a simpler theme configuration
file format than the standard XRDB one. Made specifically for themeing.
Usage: xtheme <file>
Dependencies:
All you need is gcc on a linux system.
Building:
$ make
Installing:
# make install
Why?
Because I've gotten tired of searching for the options I want for my XResources
file - the names tend to be a bit weird, they're long and repetitive, and for
some reason various sources of documentation seem to disagree on what options
are available to use. To solve this problem, I wrote my own, simpler format
that includes only themeing-related options that a sane person would actually
want to use. I also documented each option clearly below.
Frankly, if you're comfortable editing your regular .Xresources file and don't
plan on changing it often, you probably shouldn't bother with this. I made it
for myself, to fix a problem I have personally, and figured I'd share it.
Writing a Theme:
A theme/config file consists of lines containing a property, along with any
other information that particular property requires. See `example.xth` for an
example configuration.
There are three types of options that can be set:
- Flags
These options are simply listed on a line, and they enable or disable a
certain feature. No value is given for this sort of option.
- Values
These options have a specific value that should come after them on the
same line, separated by a space.
- Lists
These options are given on a line on their own, followed by a certain number
of lines, each containing a single value for the list.
Please note:
- Colors must be in hex (#xxxxxx) or basic name (red, green, blue, etc.) format.
- Any lines that aren't valid config options will be silently ignored, so you
don't need any particular formatting to make a comment.
- Indentation of a line will probably result in xtheme failing to recognize the option.
Options:
- color fg (Value)
Sets the foreground color to the one specified.
- color bg (Value)
Sets the background color to the one specified.
- color cursor (Value)
Sets the cursor color to the one specified.
- color bold (Value)
Sets the bold color to the one specified. This will also tell XTerm to use
colored text for "bold" instead of actual bold text.
- color italic (Value)
Sets the italic color to the one specified. This will also tell XTerm to use
colored text for "italic" instead of actual italic text.
- color underline (Value)
Sets the underline color to the one specified. This will also tell XTerm to
use colored text for "underline" instead of actual underlined text.
- colors (List)
Sets all 16 terminal colors (color0 to color15). These colors must be
specified in proper order on the following lines. 16 lines of color values
must follow.
- font face (Value)
Sets the font to the one whose name is specified.
- font size (Value)
Sets the font's size, in points, to the value specified.
- padding (Value)
Sets the padding around the outer edges of the terminal, in pixels, to the
value specified
- use scrollbar (Value)
Set to true to enable the scrollbar, or false to disable. This isn't a
flag because the default can be a bit more inconsistent, so we need the
ability to turn it off or on.
- cursor blink (Flag)
Makes the cursor blink.
- use clipboard (Flag)
Enables using Ctrl+Shift+V and Ctrl+Shift+C to copy and paste.
Copyright / Licensing:
Source Code, associated/accompanying project files, documentation, and binaries
resulting from the compilation of source code are Copyright 2018 Ethan McTague.
Source code, associated/accompanying project files, documentation, and binaries
resulting from the compilation of source code licensed under the BSD 2-Clause
License, see accompanying "COPYING" file for license terms.