|
Size: 1986
Comment: Added discussion about the colors.
|
Size: 2839
Comment: add link to sources
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| == Color Extension == | Color Extension |
| Line 3: | Line 3: |
| '''This extension is distributed with Mercurial.''' | '''This extension is distributed with Mercurial''' ([[https://www.mercurial-scm.org/repo/hg/file/tip/hgext/color.py|source]]) |
| Line 8: | Line 8: |
| This extension modifies the status command to add color to its output to reflect file status, and the qseries command to add color to reflect patch status (applied, unapplied, missing). Other effects in addition to color, like bold and underlined text, are also available. Effects are rendered with the ECMA-48 SGR control function (aka ANSI escape codes). This module also provides the render_text function, which can be used to add effects to any text. |
This extension modifies the status command to add color to its output to reflect file status, the qseries command to add color to reflect patch status (applied, unapplied, missing), and to diff-related commands to highlight additions, removals, diff headers, and trailing whitespace. Other effects in addition to color, like bold and underlined text, are also available. Effects are rendered with the ECMA-48 SGR control function (aka ANSI escape codes). This module also provides the render_text function, which can be used to add effects to any text. |
| Line 23: | Line 19: |
| The color extension supports both ANSI consoles and Windows consoles. It will use Windows console mode automatically on Windows platforms unless it finds TERM defined in the environment, in which case it assumes you are using an ANSI shell on Windows. If this auto-detection fails, you can explicitly set the mode by: | |
| Line 24: | Line 21: |
| Default effects my be overriden from the .hgrc file: | {{{ [color] # valid modes are win32, ansi, auto, off mode = win32 }}} Default effects may be overriden from the .hgrc file: |
| Line 34: | Line 37: |
| 'none' turns off all effects: | |
| Line 35: | Line 39: |
| 'none' turns off all effects: | |
| Line 40: | Line 43: |
| qseries can be customized in a similar way: | |
| Line 41: | Line 45: |
| qseries can be customized in a similar way: | |
| Line 47: | Line 50: |
| ---- CategoryExtension |
as can diff, and any commands that output diffs: |
| Line 50: | Line 52: |
| {{{ diff.diffline = bold diff.extended = cyan bold diff.file_a = red bold diff.file_b = green bold diff.hunk = magenta diff.deleted = red diff.inserted = green diff.changed = white diff.trailingwhitespace = bold red_background }}} === Discussion === The default colors are a bit painful to read for me, so I modified them to the following: |
|
| Line 51: | Line 66: |
| === Discussion === The default colors are a bit painful to read for me, so I modified them to the following: |
|
| Line 62: | Line 75: |
| Mainly I removed the color backgrounds and made the info which is most important for me stand out the most: | |
| Line 63: | Line 77: |
| Mainly I removed the color backgrounds and made the info which is most important for me stand out the most: | 1. modified 1. deleted 1. removed |
| Line 65: | Line 81: |
| - modified | I normally have temporary files in my dirs, so "unknown" shouldn't stand out for me (as it does in magenta), I don't know if that applies to most people. |
| Line 67: | Line 83: |
| - deleted | Besides: "black bold" is in grey for me (which is good). |
| Line 69: | Line 85: |
| - removed I normally have temporary files in my dirs, so "unknown" shouldn't stand out for me (as it does in magenta), I don't know if that applies to most people. Besides: "black bold" is in fact grey for me (which is good). |
---- CategoryBundledExtension |
Color Extension
This extension is distributed with Mercurial (source)
Author: Kevin Christen
Overview
This extension modifies the status command to add color to its output to reflect file status, the qseries command to add color to reflect patch status (applied, unapplied, missing), and to diff-related commands to highlight additions, removals, diff headers, and trailing whitespace.
Other effects in addition to color, like bold and underlined text, are also available. Effects are rendered with the ECMA-48 SGR control function (aka ANSI escape codes). This module also provides the render_text function, which can be used to add effects to any text.
Configuration
Configure your .hgrc to enable the extension by adding the following lines:
[extensions] color =
The color extension supports both ANSI consoles and Windows consoles. It will use Windows console mode automatically on Windows platforms unless it finds TERM defined in the environment, in which case it assumes you are using an ANSI shell on Windows. If this auto-detection fails, you can explicitly set the mode by:
[color] # valid modes are win32, ansi, auto, off mode = win32
Default effects may be overriden from the .hgrc file:
[color] status.modified = blue bold underline red_background status.added = green bold status.removed = red bold blue_background status.deleted = cyan bold underline status.unknown = magenta bold underline status.ignored = black bold
'none' turns off all effects:
status.clean = none status.copied = none
qseries can be customized in a similar way:
qseries.applied = blue bold underline qseries.unapplied = black bold qseries.missing = red bold
as can diff, and any commands that output diffs:
diff.diffline = bold diff.extended = cyan bold diff.file_a = red bold diff.file_b = green bold diff.hunk = magenta diff.deleted = red diff.inserted = green diff.changed = white diff.trailingwhitespace = bold red_background
Discussion
The default colors are a bit painful to read for me, so I modified them to the following:
[color] status.modified = magenta bold status.added = green bold status.removed = red bold status.deleted = cyan bold status.unknown = blue bold status.ignored = black bold
Mainly I removed the color backgrounds and made the info which is most important for me stand out the most:
- modified
- deleted
- removed
I normally have temporary files in my dirs, so "unknown" shouldn't stand out for me (as it does in magenta), I don't know if that applies to most people.
Besides: "black bold" is in grey for me (which is good).