diff options
| author | Saturnus Numerius <parvus.mortalis@gmail.com> | 2018-07-04 15:58:14 -0400 |
|---|---|---|
| committer | Saturnus Numerius <parvus.mortalis@gmail.com> | 2018-07-04 15:58:14 -0400 |
| commit | 7b8087a24da8aa08347d3556c421a00351bf6419 (patch) | |
| tree | 266f36ad7410be6eb466af82e110d6fca35c5891 | |
| parent | 3c10cc590d7f0374177e21a75b8e763c3c161128 (diff) | |
| download | ranger-7b8087a24da8aa08347d3556c421a00351bf6419.tar.gz | |
Make more changes
| -rw-r--r-- | doc/colorschemes.md | 13 |
1 files changed, 7 insertions, 6 deletions
diff --git a/doc/colorschemes.md b/doc/colorschemes.md index 4116a843..c7600700 100644 --- a/doc/colorschemes.md +++ b/doc/colorschemes.md @@ -6,7 +6,7 @@ This text explains colorschemes and how they work. Context Tags ------------ -Context Tags provide information about the context. If the tag `in_titlebar` is +Context tags provide information about the context. If the tag `in_titlebar` is set, you probably want to know about the color of a part of the titlebar now. There are a number of context tags, specified in `/ranger/gui/context.py` in the @@ -16,16 +16,17 @@ A Context object, defined in the same file, contains attributes with the names of all tags, whose values are either `True` or `False`. Implementation in the GUI Classes +--------------------------------- -The class CursesShortcuts in the file `/ranger/gui/curses_shortcuts.py` defines +The class `CursesShortcuts` in the file `/ranger/gui/curses_shortcuts.py` defines the methods `color(*tags)`, `color_at(y, x, wid, *tags)` and `color_reset()`. -This class is a superclass of Displayable, so these methods are available almost +This class is a superclass of `Displayable`, so these methods are available almost everywhere. Something like `color("in_titlebar", "directory")` will be called to get the color of directories in the titlebar. This creates a `ranger.gui.context.Context` object, sets its attributes `in_titlebar` and `directory` to True, leaves the -others as False, and passes it to the colorscheme's `use(context)` method. +others as `False`, and passes it to the colorscheme's `use(context)` method. The Color Scheme ---------------- @@ -37,14 +38,14 @@ it. `foreground` and `background` are integers representing colors, `attribute` is another integer with each bit representing one attribute. These integers are -interpreted by the used terminal emulator. +interpreted by the terminal emulator in use. Abbreviations for colors and attributes are defined in `ranger.gui.color`. Two attributes can be combined via bitwise OR: `bold | reverse` Once the color for a set of tags is determined, it will be cached by default. If you want more dynamic colorschemes (such as a different color for very large -files), you will need to dig into the source code, perhaps add an own tag and +files), you will need to dig into the source code, perhaps add a custom tag and modify the draw-method of the widget to use that tag. Run `tc_colorscheme` to check if your colorschemes are valid. |