[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:

Third try using bold but it hurt the eyes:

4th try using simply capslock, maybe better:

5th try using capslock and italics, I like it:

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>

More information about the New-bugs-announce mailing list