Update site docs

Author: bbatsov

docs/cider/basics/middleware_setup.html

@@ -478,126 +478,169 @@ <h3 id="using-leiningen"><a class="anchor" href="#using-leiningen"></a>Using Lei
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="highlightjs highlight"><code class="language-clojure hljs" data-lang="clojure">{:repl {:plugins [[cider/cider-nrepl "0.36.1"]]}}
-
-WARNING: Be careful not to place this in the `:user` profile, as this way CIDER's
-middleware will always get loaded, causing `lein` to start slower.  You really
-need it just for `lein repl` and this is what the `:repl` profile is for.
-
-=== Using Boot
-
-NOTE: Make sure you're using Boot 2.8.3 or newer, as 2.8.3 is the first
-release to ship with nREPL 0.6.
-
-Boot users can configure the tool to include the middleware automatically in
-all of their projects using a `~/.boot/profile.boot` file like so:
-
-[source,clojure]</code></pre>
+<pre class="highlightjs highlight"><code class="language-clojure hljs" data-lang="clojure">{:repl {:plugins [[cider/cider-nrepl "0.36.1"]]}}</code></pre>
 </div>
 </div>
-<div class="paragraph">
-<p>(require 'boot.repl)</p>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+Be careful not to place this in the <code>:user</code> profile, as this way CIDER&#8217;s
+middleware will always get loaded, causing <code>lein</code> to start slower.  You really
+need it just for <code>lein repl</code> and this is what the <code>:repl</code> profile is for.
+</td>
+</tr>
+</table>
 </div>
-<div class="paragraph">
-<p>(swap! boot.repl/<strong>default-dependencies</strong>
-       concat '[[cider/cider-nrepl "0.36.1"]])</p>
+</div>
+<div class="sect2">
+<h3 id="using-boot"><a class="anchor" href="#using-boot"></a>Using Boot</h3>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+Make sure you&#8217;re using Boot 2.8.3 or newer, as 2.8.3 is the first
+release to ship with nREPL 0.6.
+</td>
+</tr>
+</table>
 </div>
 <div class="paragraph">
-<p>(swap! boot.repl/<strong>default-middleware</strong>
-       conj 'cider.nrepl/cider-middleware)</p>
+<p>Boot users can configure the tool to include the middleware automatically in
+all of their projects using a <code>~/.boot/profile.boot</code> file like so:</p>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre>For more information visit https://github.com/boot-clj/boot/wiki/Cider-REPL[boot-clj wiki].
+<pre class="highlightjs highlight"><code class="language-clojure hljs" data-lang="clojure">(require 'boot.repl)
 
-=== Using tools.deps
+(swap! boot.repl/*default-dependencies*
+       concat '[[cider/cider-nrepl "0.36.1"]])
 
-You can add the following aliases to your deps.edn in order to launch
-a standalone Clojure(Script) nREPL server with CIDER middleware from
-the commandline with something like `clj -A:cider-clj`. Then from emacs
-run `cider-connect` or `cider-connect-cljs`.
-
-[source,clojure]</pre>
-</div>
+(swap! boot.repl/*default-middleware*
+       conj 'cider.nrepl/cider-middleware)</code></pre>
 </div>
-<div class="literalblock">
-<div class="content">
-<pre>:cider-clj {:extra-deps {cider/cider-nrepl {:mvn/version "0.36.1"}}
-            :main-opts ["-m" "nrepl.cmdline" "--middleware" "[cider.nrepl/cider-middleware]"]}</pre>
 </div>
+<div class="paragraph">
+<p>For more information visit <a href="https://github.com/boot-clj/boot/wiki/Cider-REPL">boot-clj wiki</a>.</p>
 </div>
-<div class="literalblock">
-<div class="content">
-<pre>:cider-cljs {:extra-deps {org.clojure/clojurescript {:mvn/version "1.10.339"}
-                          cider/cider-nrepl {:mvn/version "0.36.1"}
-                          cider/piggieback {:mvn/version "0.5.3"}}
-             :main-opts ["-m" "nrepl.cmdline" "--middleware"
-                         "[cider.nrepl/cider-middleware,cider.piggieback/wrap-cljs-repl]"]}</pre>
 </div>
+<div class="sect2">
+<h3 id="using-tools-deps"><a class="anchor" href="#using-tools-deps"></a>Using tools.deps</h3>
+<div class="paragraph">
+<p>You can add the following aliases to your deps.edn in order to launch
+a standalone Clojure(Script) nREPL server with CIDER middleware from
+the commandline with something like <code>clj -A:cider-clj</code>. Then from emacs
+run <code>cider-connect</code> or <code>cider-connect-cljs</code>.</p>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre>=== Using Gradle
-
-NOTE: Make sure you're using https://github.com/clojurephant/clojurephant[Clojurephant] 0.4.0 or newer.
+<pre class="highlightjs highlight"><code class="language-clojure hljs" data-lang="clojure">  :cider-clj {:extra-deps {cider/cider-nrepl {:mvn/version "0.36.1"}}
+              :main-opts ["-m" "nrepl.cmdline" "--middleware" "[cider.nrepl/cider-middleware]"]}
 
-.build.gradle
-[source, groovy]</pre>
+  :cider-cljs {:extra-deps {org.clojure/clojurescript {:mvn/version "1.10.339"}
+                            cider/cider-nrepl {:mvn/version "0.36.1"}
+                            cider/piggieback {:mvn/version "0.5.3"}}
+               :main-opts ["-m" "nrepl.cmdline" "--middleware"
+                           "[cider.nrepl/cider-middleware,cider.piggieback/wrap-cljs-repl]"]}</code></pre>
 </div>
 </div>
-<div class="paragraph">
-<p>dependencies {
-  devImplementation 'nrepl:nrepl:0.9.0'
-  devImplementation 'cider:cider-nrepl:0.28.5'
-}</p>
 </div>
-<div class="paragraph">
-<p>tasks.named('clojureRepl') {
-  middleware = ['cider.nrepl/cider-middleware']
-}</p>
+<div class="sect2">
+<h3 id="using-gradle"><a class="anchor" href="#using-gradle"></a>Using Gradle</h3>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+Make sure you&#8217;re using <a href="https://github.com/clojurephant/clojurephant">Clojurephant</a> 0.4.0 or newer.
+</td>
+</tr>
+</table>
 </div>
 <div class="listingblock">
+<div class="title">build.gradle</div>
 <div class="content">
-<pre>You can then launch the nREPL server from the command line via: `./gradlew clojureRepl`.
-
-For more information, see the https://clojurephant.dev[Clojurephant docs].
-
-=== Using Maven
-
-NOTE: This section is currently a stub. Contributions welcome!
-
-== Using Embedded nREPL Server
-
-If you're embedding nREPL in your application, you'll have to start the
-server with CIDER's own nREPL handler.
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencies {
+  devImplementation 'nrepl:nrepl:0.9.0'
+  devImplementation 'cider:cider-nrepl:0.28.5'
+}
 
-[source,clojure]</pre>
+tasks.named('clojureRepl') {
+  middleware = ['cider.nrepl/cider-middleware']
+}</code></pre>
 </div>
 </div>
 <div class="paragraph">
-<p>(ns my-app
-  (:require [nrepl.server :as nrepl-server]
-            [cider.nrepl :refer (cider-nrepl-handler)]))</p>
+<p>You can then launch the nREPL server from the command line via: <code>./gradlew clojureRepl</code>.</p>
 </div>
 <div class="paragraph">
-<p>(defn -main
-  []
-  (nrepl-server/start-server :port 7888 :handler cider-nrepl-handler))</p>
+<p>For more information, see the <a href="https://clojurephant.dev">Clojurephant docs</a>.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="using-maven"><a class="anchor" href="#using-maven"></a>Using Maven</h3>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+This section is currently a stub. Contributions welcome!
+</td>
+</tr>
+</table>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="using-embedded-nrepl-server"><a class="anchor" href="#using-embedded-nrepl-server"></a>Using Embedded nREPL Server</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>If you&#8217;re embedding nREPL in your application, you&#8217;ll have to start the
+server with CIDER&#8217;s own nREPL handler.</p>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre>It goes without saying that your project should depend on `cider-nrepl`.
+<pre class="highlightjs highlight"><code class="language-clojure hljs" data-lang="clojure">(ns my-app
+  (:require [nrepl.server :as nrepl-server]
+            [cider.nrepl :refer (cider-nrepl-handler)]))
 
-NOTE: Prior to CIDER 0.18, CIDER and cider-nrepl were always released together
+(defn -main
+  []
+  (nrepl-server/start-server :port 7888 :handler cider-nrepl-handler))</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>It goes without saying that your project should depend on <code>cider-nrepl</code>.</p>
+</div>
+<div class="admonitionblock note">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-note" title="Note"></i>
+</td>
+<td class="content">
+Prior to CIDER 0.18, CIDER and cider-nrepl were always released together
 and their versions had to match for things to work (e.g. CIDER 0.15 required
 cider-nrepl 0.15). But as the prominence of cider-nrepl grew and many other
 tools started using it, the two projects evolved separately and are no longer in
 tight lock-step. Usually, any recent version of cider-nrepl should be (mostly)
 compatible with a recent version of CIDER. You can check the required version of
 cider-nrepl for your version of CIDER by looking at
-`cider-required-middleware-version`.</pre>
-</div>
-</div>
+<code>cider-required-middleware-version</code>.
+</td>
+</tr>
+</table>
 </div>
 </div>
 </div>