docs: Even more highlighting improvesments

Author: tony

docs/cli.md

@@ -14,15 +14,15 @@ See the [click library's documentation on shell completion](https://click.pallet
 
 In bash (`~/.bashrc`):
 
-```{code-block} sh
+```console
 
 eval "$(_TMUXP_COMPLETE=bash_source tmuxp)"
 
 ```
 
 In zsh (`~/.zshrc`):
 
-```{code-block} sh
+```console
 
 eval "$(_TMUXP_COMPLETE=zsh_source tmuxp)"
 
@@ -78,7 +78,7 @@ Pane(%6 Window(@3 1:your_window, Session($1 your_project)))
 Python 3.7 supports [PEP 553][pep 553]'s `PYTHONBREAKPOINT` and supports
 compatible debuggers, for instance [ipdb][ipdb]:
 
-```{code-block} sh
+```console
 
 $ pip install --user ipdb
 $ env PYTHONBREAKPOINT=ipdb.set_trace tmuxp shell
@@ -87,7 +87,7 @@ $ env PYTHONBREAKPOINT=ipdb.set_trace tmuxp shell
 You can also pass in python code directly, similar to `python -c`, do
 this via `tmuxp -c`:
 
-```{code-block} shell
+```consoleell
 
 $ tmuxp shell -c 'print(session.name); print(window.name)'
 my_server
@@ -157,25 +157,25 @@ shorthands:
 2. The name of the project file in your {}`$HOME/.tmuxp` folder
 3. The direct path of the tmuxp file you want to load
 
-```
+```console
 # path to folder with .tmuxp.{yaml,yml,json}
-tmuxp load .
-tmuxp load ../
-tmuxp load path/to/folder/
-tmuxp load /path/to/folder/
+$ tmuxp load .
+$ tmuxp load ../
+$ tmuxp load path/to/folder/
+$ tmuxp load /path/to/folder/
 
 # name of the config, assume $HOME/.tmuxp/myconfig.yaml
-tmuxp load myconfig
+$ tmuxp load myconfig
 
 # direct path to json/yaml file
-tmuxp load ./myfile.yaml
-tmuxp load /abs/path/to/myfile.yaml
-tmuxp load ~/myfile.yaml
+$ tmuxp load ./myfile.yaml
+$ tmuxp load /abs/path/to/myfile.yaml
+$ tmuxp load ~/myfile.yaml
 ```
 
 Absolute and relative directory paths are supported.
 
-```{code-block} bash
+```console
 
 $ tmuxp load <filename>
 
@@ -184,7 +184,7 @@ $ tmuxp load <filename>
 Files named `.tmuxp.yaml` or `.tmuxp.json` in the current working
 directory may be loaded with:
 
-```{code-block} bash
+```console
 
 $ tmuxp load .
 
@@ -202,15 +202,17 @@ Or (a)ppend windows in the current active session?
 
 All of these options can be preselected to skip the prompt:
 
-```{code-block} bash $ tmuxp load -y config # load attached $ tmuxp load -d config # load detached $ tmuxp load -a config # append windows
-
+```console
+$ tmuxp load -y config  # load attached
+$ tmuxp load -d config  # load detached
+$ tmuxp load -a config  # append windows
 ```
 
 Multiple sessions can be loaded at once. The first ones will be created
 without being attached. The last one will be attached if there is no
 `-d` flag on the command line.
 
-```{code-block} bash
+```console
 
 $ tmuxp load <filename1> <filename2> ...
 
@@ -219,7 +221,7 @@ $ tmuxp load <filename1> <filename2> ...
 A session name can be provided at the terminal. If multiple sessions
 are created, the last session is named from the terminal.
 
-```{code-block} bash
+```console
 
 $ tmuxp load -s <new_session_name> <filename1> ...
 
@@ -229,7 +231,7 @@ The output of the `load` command can be logged to a file for
 debugging purposes. the log level can be controlled with the global
 `--log-level` option (defaults to INFO).
 
-```{code-block} bash
+```console
 
 $ tmuxp load <filename> --log-file <log_filename>
 $ tmuxp --log-level <LEVEL> load <filename> --log-file <log_filename>
@@ -243,7 +245,7 @@ $ tmuxp --log-level <LEVEL> load <filename> --log-file <log_filename>
 Use to collect all relevant information for submitting an issue to
 the project.
 
-```{code-block} bash
+```console
 
 $ tmuxp debug-info
 --------------------------

docs/developing.md

@@ -23,7 +23,7 @@ using `$ tmux -L test_case`.
 
 To begin developing, check out the code from github:
 
-```{code-block} bash
+```console
 
 $ git clone git@github.com:tmux-python/tmuxp.git
 $ cd tmuxp
@@ -35,23 +35,23 @@ $ cd tmuxp
 Now create a virtualenv, if you don't know how to, you can create a
 virtualenv with:
 
-```{code-block} bash
+```console
 
 $ virtualenv .venv
 
 ```
 
 Then activate it to your current tty / terminal session with:
 
-```{code-block} bash
+```console
 
 $ source .venv/bin/activate
 
 ```
 
 Good! Now let's run this:
 
-```{code-block} bash
+```console
 
 $ pip install -e .
 
@@ -61,7 +61,7 @@ This has `pip`, a python package manager install the python package
 in the current directory. `-e` means `--editable`, which means you can
 adjust the code and the installed software will reflect the changes.
 
-```{code-block} bash
+```console
 
 $ tmuxp
 
@@ -75,7 +75,7 @@ For information on installing poetry visit the [poetry's documentation][poetry's
 
 To begin developing, check out the code from github:
 
-```{code-block} bash
+```console
 
 $ git clone git@github.com:tmux-python/tmuxp.git
 $ cd tmuxp
@@ -85,7 +85,7 @@ $ cd tmuxp
 You can create a virtualenv, and install all of the locked
 packages as listed in poetry.lock:
 
-```{code-block} bash
+```console
 
 $ poetry install
 
@@ -95,7 +95,7 @@ If you ever need to update packages during your development session, the
 following command can be used to update all packages as per poetry settings or
 individual package (second command):
 
-```{code-block} bash
+```console
 
 $ poetry update
 $ poetry update requests
@@ -104,7 +104,7 @@ $ poetry update requests
 
 Then activate it to your current tty / terminal session with:
 
-```{code-block} bash
+```console
 
 $ poetry shell
 
@@ -122,7 +122,7 @@ since you are in the virtual environment, your {}`PATH` environment was
 updated to include a special version of `python` inside your `.venv`
 folder with its own packages.
 
-```{code-block} bash
+```console
 
 $ make test
 
@@ -139,15 +139,15 @@ If you found a problem or are trying to write a test, you can file an
 
 Test only a file:
 
-```{code-block} bash
+```console
 
 $ py.test tests/test_config.py
 
 ```
 
 will test the `tests/test_config.py` tests.
 
-```{code-block} bash
+```console
 
 $ py.test tests/test_config.py::test_export_json
 
@@ -157,7 +157,7 @@ tests `test_export_json` inside of `tests/test_config.py`.
 
 Multiple can be separated by spaces:
 
-```{code-block} bash
+```console
 
 $ py.test tests/test_{window,pane}.py tests/test_config.py::test_export_json
 
@@ -200,7 +200,7 @@ variants, including Debian, Ubuntu, FreeBSD, OS X.
 
 To run all tests upon editing any `.py` file:
 
-```{code-block} bash
+```console
 
 $ make watch_test
 
@@ -209,7 +209,7 @@ $ make watch_test
 You can also re-run a specific test file or any other [py.test usage
 argument][py.test usage argument]:
 
-```{code-block} bash
+```console
 
 $ make watch_test test=tests/test_config.py
 
@@ -221,7 +221,7 @@ $ make watch_test test='-x tests/test_config.py tests/test_util.py'
 
 Rebuild the documentation when an `.rst` file is edited:
 
-```{code-block} bash
+```console
 
 $ cd doc
 $ make watch
@@ -242,7 +242,7 @@ $ make SPHINXBUILD='poetry run sphinx-build' watch
 
 After you {ref}`install_dev_env`, when inside the tmuxp checkout:
 
-```{code-block} bash
+```console
 
 $ tmuxp load .
 

docs/examples.md

@@ -501,7 +501,7 @@ You can load your software project in tmux by placing a `.tmuxp.yaml` or
 tmuxp supports loading configs via absolute filename with `tmuxp load`
 and via `$ tmuxp load .` if config is in directory.
 
-```{code-block} bash
+```console
 
 $ tmuxp load ~/workspaces/myproject.yaml
 

docs/plugin_system.md

@@ -39,7 +39,7 @@ suggested to use it when developing plugins; however, `pip` will work
 just as well. Only one of the configuration files is needed for the packaging
 tool that the package developer desides to use.
 
-```{code-block} bash
+```console
 
 python_module
 ├── tmuxp_plugin_my_plugin_module

docs/quickstart.md

@@ -6,15 +6,15 @@
 
 Assure you have at least tmux **>= 1.8** and python **>= 2.6**.
 
-```{code-block} bash
+```console
 
 $ pip install --user tmuxp
 
 ```
 
 You can upgrade to the latest release with:
 
-```{code-block} bash
+```console
 
 $ pip install --user tmuxp -U
 
@@ -24,7 +24,7 @@ Then install {ref}`completion`.
 
 If you are a Homebrew user you can install it with:
 
-```{code-block} bash
+```console
 
 $ brew install tmuxp
 
@@ -56,7 +56,7 @@ Create a file, `~/.tmuxp/example.yaml`:
 
 ```
 
-```{code-block} bash
+```console
 
 $ tmuxp load example.yaml
 
@@ -66,7 +66,7 @@ This creates your tmuxp session.
 
 Load multiple tmux sessions at once:
 
-```{code-block} bash
+```console
 
 $ tmuxp load example.yaml anothersession.yaml
 
@@ -79,15 +79,15 @@ the current active session.
 You can also have a custom tmuxp config directory by setting the
 `TMUX_CONFIGDIR` in your environment variables.
 
-```{code-block} bash
+```console
 
 $ TMUXP_CONFIGDIR=$HOME/.tmuxpmoo tmuxp load cpython
 
 ```
 
 Or in your `~/.bashrc` / `~/.zshrc` you can set:
 
-```{code-block} bash
+```console
 
 export TMUXP_CONFIGDIR=$HOME/.yourconfigdir/tmuxp