diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index eede70e58..ebd09d151 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -81,6 +81,9 @@ jobs: - name: Test for trailing whitespace run: if grep -Inr '\s$' kitty kitty_tests kittens docs *.py *.asciidoc *.rst *.go .gitattributes .gitignore; then echo Trailing whitespace found, aborting.; exit 1; fi + - name: Test for bad code block formatting + run: if grep -Inr ':code:`\s' kitty kitty_tests kittens docs *.py *.asciidoc *.rst *.go .gitattributes .gitignore; then echo Space at code block start found, aborting.; exit 1; fi + - name: Set up Python uses: actions/setup-python@v4 with: diff --git a/kitty/options/definition.py b/kitty/options/definition.py index 34e39fc3f..660984dcd 100644 --- a/kitty/options/definition.py +++ b/kitty/options/definition.py @@ -271,14 +271,14 @@ well with your preferred color scheme. The default value is :code:`0`, which means no color overriding is performed. There are two modes of operation: -A value with the suffix :code:` ratio` represents the minimum accepted contrast ratio between the foreground and background color. +A value with the suffix :code:`ratio` represents the minimum accepted contrast ratio between the foreground and background color. Possible values range from :code:`0.0 ratio` to :code:`21.0 ratio`. For example, to meet :link:`WCAG level AA ` a value of :code:`4.5 ratio` can be provided. The algorithm is implemented using :link:`HSLuv ` which enables it to change the perceived lightness of a color just as much as needed without really changing its hue and saturation. -A value with the suffix :code:` %` represents the minimum accepted difference in luminance +A value with the suffix :code:`%` represents the minimum accepted difference in luminance between the foreground and background color, below which kitty will override the foreground color. It is percentage ranging from :code:`0 %` to :code:`100 %`. If the difference in luminance of the foreground and background is below this threshold, the foreground color will be set