format: use shell for code blocks, add missing clojure language to code blocks

Author: practicalli-johnny

CHANGELOG.md

@@ -19,6 +19,7 @@
 - dev: checkout v4 & python v5 actions in publish-book workflow
 - dev: sparse checkout scheduled version workflow
 - dev: upload-artefact v4 & remove explicit token from megalinter
+- format: use shell for code blocks, add missing clojure language to code blocks
 
 ## Added
 - button link to Clojure CLI releases changelog to view available versions

README.md

@@ -81,34 +81,34 @@ Publish book workflow installs Material for MkDocs version 9
 
 Install mkdocs version 9 using the Python pip package manager
 
-```bash
+```shell
 pip install mkdocs-material=="9.*"
 ```
 
 Install the plugins used by the Practicalli site using Pip (these are also installed in the GitHub Action workflow)
 
-```bash
+```shell
 pip3 install mkdocs-material mkdocs-callouts mkdocs-glightbox mkdocs-git-revision-date-localized-plugin mkdocs-redirects pillow cairosvg
 ```
 
 > pillow and cairosvg python packages are required for [Social Cards](https://squidfunk.github.io/mkdocs-material/setup/setting-up-social-cards/)
 
 Fork the GitHub repository and clone that fork to your computer,
 
-```bash
+```shell
 git clone https://github.com/<your-github-account>/<repository>.git
 ```
 
 Run a local server from the root of the cloned project
 
-```bash
+```shell
 make docs
 ```
 
 The website will open at <http://localhost:8000>
 
 If making smaller changes, then only rebuild the content that changes, speeding up the local development process
-```bash
+```shell
 make docs-changed
 ```
 

docs/alternative-tools/clojure-cli/basic-repl.md

@@ -14,7 +14,7 @@ Use `clj` when you want to run a repl (or preferably use [rebel readline](rebel-
 
 `clj` command in a terminal window starts a Clojure REPL and shows the version of Clojure used.  The command does not need to be in a directory containing a Clojure project.
 
-```bash
+```shell
 clj
 ```
 

docs/alternative-tools/clojure-cli/evaluate-an-expression.md

@@ -12,7 +12,7 @@ This expression calls the `+` function with the arguments `1 2 3 4 5`.  As this
 Using the `-e` option an expression can be passed to the Clojure CLI tools and a value returned
 
 
-```bash
+```shell
 clojure -e (+ 1 2 3 4 5)
 ```
 

docs/alternative-tools/clojure-cli/set-namespace-on-repl-startup.md

@@ -11,14 +11,14 @@ Switching to a specific namespace in the REPL allows calling functions by name,
 
 To require and switch to a namespace on startup, use the `clojure` or `clj` commands with the --eval option to run the specific commands.  The --repl option will ensure the repl starts.
 
-```bash
+```shell
 clj --eval "(require 'practicalli.random-clojure-core-function)" --eval "(in-ns 'practicalli.random-clojure-core-function)" --repl
 ```
 
 
 `-r` or `(clojure.main/repl)` are the same as using the `--repl` option
 
-```bash
+```shell
 clj -e "(ns foo.bar) (alter-var-root #'*ns* (constantly 'foo.bar))" -r
 clj -e "(ns foo.bar) (alter-var-root #'*ns* (constantly 'foo.bar)) (clojure.main/repl)"
 ```

docs/alternative-tools/data-inspector/reveal.md

@@ -17,7 +17,7 @@ Use Reveal with a terminal REPL or a Clojure editor that uses nrepl such as Emac
 
     Open a terminal and run the command:
 
-    ```bash
+    ```shell
     clojure -M:inspect/reveal
     ```
     > Use the `clj` command if the `rlwrap` binary is available
@@ -105,7 +105,7 @@ Reveal can be used as a `tap>` target with the Rebel REPL, launching the Reveal
 
 Start Rebel REPL with Reveal library as a dependency
 
-```bash
+```shell
 clojure -M:repl-reveal:repl/rebel
 ```
 

docs/alternative-tools/leiningen/index.md

@@ -17,7 +17,7 @@ Install the Leiningen tool using the specific instructions for your Operating Sy
 === "Linux"
     [Download the lein script](https://raw.githubusercontent.com/technomancy/leiningen/stable/bin/lein) to your local `bin` directory.  Then make the `lein` script executable and run `lein` to download the full version.
 
-    ```bash
+    ```shell
     mkdir ~/bin
     curl https://raw.githubusercontent.com/technomancy/leiningen/stable/bin/lein > ~/bin/lein
     chmod u+x ~/bin/lein
@@ -29,7 +29,7 @@ Install the Leiningen tool using the specific instructions for your Operating Sy
 === "Homebrew"
     If you have [Homebrew](https://brew.sh/) installed, run the following command in a terminal window.
 
-    ```bash
+    ```shell
     brew install leiningen
     ```
 
@@ -51,7 +51,7 @@ Install the Leiningen tool using the specific instructions for your Operating Sy
 
     If you have [Chocolatey](https://chocolatey.org/) installed, add the [Leiningen package](https://chocolatey.org/packages/Lein) by running the following command in a terminal window.
 
-    ```bash
+    ```shell
     choco install lein
     ```
 
@@ -71,7 +71,7 @@ Install the Leiningen tool using the specific instructions for your Operating Sy
 
 Check Leiningen is working by running `lein` command in a terminal
 
-```bash
+```shell
 lein help
 ```
 
@@ -104,13 +104,13 @@ Leiningen automatically includes the `test` directory when running, so no additi
 
 Run all the tests saved to file:
 
-```bash
+```shell
 lein test
 ```
 
 Run just the unit tests in a specific namepsace.
 
-```bash
+```shell
 lein test :only domain.namespace-test
 ```
 

docs/clojure-cli/defining-aliases.md

@@ -124,7 +124,7 @@ clojure -X:project/run
 
 Over-ride the default arguments by passing them on the command line
 
-```bash
+```shell
 clojure -X:project/run '[:http/server :port]' 8888 :log/mulog :console :profile :dev
 ```
 

docs/clojure-cli/execution-options.md

@@ -46,7 +46,7 @@ The double quotes in an EDN string must be wrapped by single quotes, along with
 
 Run a project with the main namespace `practicalli.sudoku-solver`, without any additional aliases on the command line
 
-```bash
+```shell
 clojure -M -m practicalli.sudoku-solver
 ```
 
@@ -63,7 +63,7 @@ Adding a `:project/run` alias to the project `deps.edn` file provides a simpler
 
 Now the project code can be run using the simple command line form
 
-```bash
+```shell
 clojure -M:project/run
 ```
 
@@ -97,7 +97,7 @@ If no -main function is found or the namespace is not specified, then a REPL ses
 
 Use the `:repl/rebel` alias with the `-M` execution option
 
-```bash
+```shell
 clojure -M:repl/rebel
 ```
 
@@ -109,7 +109,7 @@ Multiple aliases can be specified to include additional paths and libraries. Ali
 
 Start a REPL process with this alias
 
-```bash
+```shell
 clojure -M:env/dev:lib/hotload:repl/rebel
 ```
 
@@ -120,7 +120,7 @@ The Rebel REPL UI will start, include the dev directory on the class path and th
 
 Alises can be used together by chaining their names on the command line
 
-```bash
+```shell
 clojure -M:env/dev:lib/hotload:repl/rebel
 ```
 
@@ -139,13 +139,13 @@ Any function on the class path can be called and is passed a hash-map as an argu
 
 Call the `status` function from the namespace `practicalli.service`, which is on the classpath in the practicalli.service project
 
-```bash
+```shell
 clojure -X practicalli.service/status
 ```
 
 Pass arguments to a `start` function in the `practicalli.service` namespace
 
-```bash
+```shell
 clojure -X practicalli.service/start :port 8080 :join? false
 ```
 
@@ -170,7 +170,7 @@ The `-T` execution option also uses the `clojure.exec` approach, although the `:
 
 Calling Tools on the command line has the general form:
 
-```bash
+```shell
 clojure -Ttool-name function-name :key "value" ,,,
 ```
 
@@ -183,27 +183,27 @@ key/value pairs can be passed as arguments to that function (as with the -X exec
 
 In this example, the antq tool is installed using the name `antq`
 
-```bash
+```shell
 clojure -Ttools install com.github.liquidz/antq '{:git/tag "1.3.1"}' :as antq
 ```
 
 Installing a tool adds an EDN configuration file using the name of the tool in `$XDG_HOME/.clojure/tools/` or `$HOME/.clojure/tools/` directory.
 
 Once a tool is installed, run by using the name of the tool.
 
-```bash
+```shell
 clojure -Tantq outdated
 ```
 
 Options to the tool are passed as key/value pairs (as the tool is called by clojure.exec)
 
-```bash
+```shell
 clojure -Tantq outdated :upgrade true
 ```
 
 `-Ttools remove` will remove the configuration of the tool of the given name
 
-```bash
+```shell
 clojure -Ttools remove :tool antq
 ```
 
@@ -265,13 +265,13 @@ If `:git` or `:local/root` dependencies are defined, the respective code will be
 
 Prepare flag by itself download dependencies defined in the `:deps` section of the `deps.edn` file of the current project.
 
-```bash
+```shell
 clojure -P
 ```
 
 Including one or more aliases will preparing all the dependencies from every alias specified
 
-```bash
+```shell
 clojure -P -M:env/dev:lib/hotload:repl/cider
 ```
 
@@ -290,7 +290,7 @@ As prepare is essentially a dry run, then the `clojure` command does not call `:
 
 The `:env/dev` alias adds "dev" directory to the class path, [typically used to add a `user.clj` that will automatically load code from the `user` namespace defined in that file](https://practical.li/clojure/clojure-cli/projects/configure-repl-startup.html).
 
-```bash
+```shell
 clojure -A:env/dev
 ```
 
@@ -310,7 +310,7 @@ Aliases can be chained together and their configuration will be merged
 
 Start a REPL process with this alias
 
-```bash
+```shell
 clojure -A:env/dev:lib/hotload
 ```
 

docs/clojure-cli/practicalli-config.md

@@ -89,7 +89,7 @@ All tools are provided via libraries and are only installed on first use.  Unuse
 
 Run project with or without an alias:
 
-```bash
+```shell
 clojure -M:alias -m domain.app-name
 clojure -M -m domain.app-name
 ```