[New-bugs-announce] [issue35221] Enhance venv activate commands readability
Julien Palard
report at bugs.python.org
Mon Nov 12 16:57:54 EST 2018
New submission from Julien Palard <julien+python at palard.fr>:
I'd like to enhance the readability of the "venv activation commands" in library/venv.html, my students are often confused by it, sometimes they copy the angle brackets, sometime even the prompt.
I don't think we can fix everything, but maybe enhance a bit, I ran a few tests.
Before modification: https://screenshotscdn.firefoxusercontent.com/images/77cf6612-1934-4a3b-9376-87a012a76bc3.png
First try with a :file:, not better: https://screenshotscdn.firefoxusercontent.com/images/db4e1191-a740-4828-b53a-ccc4a8d33dae.png
Second try, simply double backquotes:
https://screenshotscdn.firefoxusercontent.com/images/d6be92a1-e4af-40f5-9281-d9c09d8a0908.png
Third try using bold but it hurt the eyes:
https://screenshotscdn.firefoxusercontent.com/images/6fb1026f-064b-41dd-822b-3b258e37a85e.png
4th try using simply capslock, maybe better:
https://screenshotscdn.firefoxusercontent.com/images/9e9c3f7b-639c-4f26-abcc-20948e15a65d.png
5th try using capslock and italics, I like it:
https://screenshotscdn.firefoxusercontent.com/images/b5ae5582-1706-4ea9-a702-910daf2c69bc.png
Someone on #python-fr proposed https://framapic.org/XnBQZcJVRlZw/F05D7I8nSKd0.png (rendered from markdown in github). I like it but it would require a specific role to render bold-italic in code block.
----------
assignee: mdk
components: Documentation
messages: 329762
nosy: mdk
priority: normal
severity: normal
status: open
title: Enhance venv activate commands readability
_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35221>
_______________________________________
More information about the New-bugs-announce
mailing list