sphinx-doc / sphinx-autobuild

Watch a Sphinx directory and rebuild the documentation when a change is detected. Also includes a hot-reload web server.
MIT License
523 stars 75 forks source link

Output is Black on Black in VS Code #107

Closed eightbit closed 3 months ago

eightbit commented 3 years ago

Thanks so much for providing this great tool!

Describe the bug

When I run auto build in VS Code, much of the output is almost the same black color as the background of the terminal. After terminating the server, invoking 'Crtl-C' a couple of times is required to restore the default color to the terminal prompt.

To Reproduce

Run the code: sphinx-autobuild . --port 8020 _build/html

Expected behavior

Expect the terminal output text to be default color - almost white.

Environment

sphxAutoBld01

pradyunsg commented 3 months ago

This is not related to this tool itself, but rather the colors are controlled by your VS Code theme: this theme is merely telling the terminal to "show this as cyan/blue etc", and your VS Code configuration is presenting that as a color with really low contrast.

Further, since this issue was filed, VS Code has fixed this on their end by enforcing minimum contrast on the integrated terminal by default: https://code.visualstudio.com/docs/terminal/appearance#_minimum-contrast-ratio