DOC: fix formatting of shell commands

[partev]

"sudo zypper in python3-idle" gets highlighted as Python code. specifically "in" is highlighted in green. Since this is a shell command it needs to be formatted as such.

---

📚 Documentation preview 📚: https://cpython-previews--131295.org.readthedocs.build/en/131295/using/unix.html

[picnixz]

Do we use shell or bash in general? also are you interested in fixing the other places which use incorrect highlighting?

[picnixz]

Actually in is also a keyword in shell, but I don't think it should be highlighted here. I don't really know whether we need to do something here or report to Pygments so that their highlighter is a bit more suitable. I also don't remember whether we have a better syntax highlighting language for that

[picnixz]

There is a small distinction between shell (https://pygments.org/docs/lexers/#pygments.lexers.shell.BashLexer) for shell scripts and shell-session for console (https://pygments.org/docs/lexers/#pygments.lexers.shell.BashSessionLexer).

Using https://pygments.org/demo/: With Bash (equivalent to shell):

With Bash Session (equivalent to shell-session):

To avoid this weird formatting, I would advise using the full name zypper install instead of in (though usually we only write in indeed)

[picnixz]

As I said, this will still be highlighted as in is a valid shell keyword :( so let's use install.

Suggested change

	sudo zypper in python3-idle
	sudo zypper install python3-idle

[partev]

what if we use shell-session lexer?

[picnixz]

The shell-session lexer seems to work but if we put a prompt (say $) in front of the command, it doesn't work. So I'm not sure what would be the best:

@hugovk what do you recommend here? I think it's not the only place where we're probably mixing lexers but I think it's better if we don't highlight in here. But using shell-session without a prompt looks a bit... weird =/

[hugovk]

Let's use install like in the Zypper docs:

https://documentation.suse.com/smart/systems-management/html/concept-zypper/index.html#general-usage-zypper

[hugovk]

Let's also take care with the indents inside bullet points.

Before:

https://docs.python.org/3/using/unix.html#installing-idle

After:

https://cpython-previews--131295.org.readthedocs.build/en/131295/using/unix.html#installing-idle

[partev]

Let's also take care with the indents inside bullet points.

Before:

https://docs.python.org/3/using/unix.html#installing-idle

After:

https://cpython-previews--131295.org.readthedocs.build/en/131295/using/unix.html#installing-idle

ok, I will submit a new pull request that just replaces "in" -> "install"

[partev]

submitted a new pull request #131310 instead of this one