Follow up #2286 Release v24.0 | Artifacts and bug fixing

Author: raman-m

docs/_static/overrides.css

@@ -4,3 +4,15 @@ blockquote {
 aside.footnote-list {
     font-size: 0.9em;
 }
+.img-valign-middle
+{
+    vertical-align: middle;
+}
+.img-valign-bottom
+{
+    vertical-align: bottom;
+}
+.img-valign-textbottom
+{
+    vertical-align: text-bottom;
+}

docs/building/building.rst

@@ -1,3 +1,7 @@
+.. role:: htm(raw)
+  :format: html
+.. role:: pdf(raw)
+  :format: latex pdflatex
 .. _Ocelot: https://github.com/ThreeMammals/Ocelot
 .. _Cake: https://cakebuild.net
 .. _Bash: https://www.gnu.org/software/bash
@@ -114,22 +118,26 @@ You may need to adjust the platform flag depending on your system.
 With CI/CD
 ----------
 .. _workflows: https://github.com/ThreeMammals/Ocelot/tree/main/.github/workflows 
-.. _PR: https://github.com/ThreeMammals/Ocelot/blob/main/.github/workflows/pr.yml
-.. _Develop: https://github.com/ThreeMammals/Ocelot/blob/main/.github/workflows/develop.yml
-.. _Release: https://github.com/ThreeMammals/Ocelot/blob/main/.github/workflows/release.yml
+.. _PR: https://github.com/ThreeMammals/Ocelot/actions/workflows/pr.yml
+.. _Develop: https://github.com/ThreeMammals/Ocelot/actions/workflows/develop.yml
+.. _Release: https://github.com/ThreeMammals/Ocelot/actions/workflows/release.yml
 .. _Coveralls: https://coveralls.io
 .. |ReleaseButton| image:: https://github.com/ThreeMammals/Ocelot/actions/workflows/release.yml/badge.svg
-   :target: https://github.com/ThreeMammals/Ocelot/actions/workflows/release.yml
-   :alt: Release Status
+  :target: https://github.com/ThreeMammals/Ocelot/actions/workflows/release.yml
+  :alt: Release Status
+  :class: img-valign-textbottom
 .. |DevelopButton| image:: https://github.com/ThreeMammals/Ocelot/actions/workflows/develop.yml/badge.svg
-   :target: https://github.com/ThreeMammals/Ocelot/actions/workflows/develop.yml
-   :alt: Development Status
+  :target: https://github.com/ThreeMammals/Ocelot/actions/workflows/develop.yml
+  :alt: Development Status
+  :class: img-valign-textbottom
 .. |DevelopCoveralls| image:: https://coveralls.io/repos/github/ThreeMammals/Ocelot/badge.svg?branch=develop
-   :target: https://coveralls.io/github/ThreeMammals/Ocelot?branch=develop
-   :alt: Coveralls Status
+  :target: https://coveralls.io/github/ThreeMammals/Ocelot?branch=develop
+  :alt: Coveralls Status
+  :class: img-valign-textbottom
 .. |ReleaseCoveralls| image:: https://coveralls.io/repos/github/ThreeMammals/Ocelot/badge.svg?branch=main
-   :target: https://coveralls.io/github/ThreeMammals/Ocelot?branch=main
-   :alt: Coveralls Status
+  :target: https://coveralls.io/github/ThreeMammals/Ocelot?branch=main
+  :alt: Coveralls Status
+  :class: img-valign-textbottom
 .. _break2: http://break.do
 
   | Folder: ./.github/`workflows`_
@@ -142,7 +150,9 @@ Starting from version `24.0`_, all pull requests, development commits, and relea
 There are three `workflows`_: one for pull requests (`PR`_), one for the ``develop`` branch (`Develop`_), and one for the ``main`` branch (`Release`_).
 
   **Note**: Each workflow has a dedicated status badge in the `Ocelot README`_:
-  the `Release`_ |ReleaseButton| button and the `Develop`_ |DevelopButton| button, with the `PR`_ status being published directly in a pull request under the "Checks" tab.
+  the |ReleaseButton|:pdf:`\href{https://github.com/ThreeMammals/Ocelot/actions/workflows/release.yml}{Release}` button and
+  the |DevelopButton|:pdf:`\href{https://github.com/ThreeMammals/Ocelot/actions/workflows/develop.yml}{Develop}` button,
+  with the `PR`_ status being published directly in a pull request under the "Checks" tab.
 
 The `PR`_ workflow will track code coverage using `Coveralls`_.
 After opening a pull request or submitting a new commit to a pull request, `Coveralls`_ will publish a short message with the current code coverage once the top commit is built.
@@ -164,11 +174,13 @@ Documentation
 .. _README: https://github.com/ThreeMammals/Ocelot/blob/main/docs/readme.md
 .. _Ocelot README: https://github.com/ThreeMammals/Ocelot/blob/main/README.md
 .. |ReleaseDocs| image:: https://readthedocs.org/projects/ocelot/badge/?version=latest&style=flat-square
-   :target: https://app.readthedocs.org/projects/ocelot/builds/?version__slug=latest
-   :alt: ReadTheDocs Status
+  :target: https://app.readthedocs.org/projects/ocelot/builds/?version__slug=latest
+  :alt: ReadTheDocs Status
+  :class: img-valign-middle
 .. |DevelopDocs| image:: https://readthedocs.org/projects/ocelot/badge/?version=develop&style=flat-square
-   :target: https://app.readthedocs.org/projects/ocelot/builds/?version__slug=develop
-   :alt: ReadTheDocs Status
+  :target: https://app.readthedocs.org/projects/ocelot/builds/?version__slug=develop
+  :alt: ReadTheDocs Status
+  :class: img-valign-middle
 .. _break3: http://break.do
 
   | Folder: ./`docs`_

docs/features/kubernetes.rst

@@ -1,11 +1,16 @@
+.. role:: htm(raw)
+  :format: html
+.. role:: pdf(raw)
+  :format: latex pdflatex
 .. |K8sLogo| image:: https://raw.githubusercontent.com/kubernetes/kubernetes/master/logo/logo.png
   :alt: K8s Logo
   :height: 50
+  :class: img-valign-bottom
   :target: https://kubernetes.io
-
-.. |kubernetes| image:: https://kubernetes.io/images/nav_logo2.svg
+.. |logo-kubernetes| image:: ../images/k8s-logo-kubernetes.png
   :alt: kubernetes logo
-  :height: 17
+  :height: 30
+  :class: img-valign-middle
   :target: https://kubernetes.io
 
 .. _KubeClient: https://www.nuget.org/packages/KubeClient
@@ -29,7 +34,7 @@ For a comprehensive understanding, it is essential refer to the `KubeClient`_ do
 Install
 -------
 
-The first thing you need to do is install the `package`_ that provides |kubernetes| support in Ocelot:
+The first thing you need to do is install the `package`_ that provides |logo-kubernetes| support in Ocelot:
 
 .. code-block:: powershell
 

docs/features/qualityofservice.rst

@@ -1,11 +1,19 @@
+.. role:: htm(raw)
+  :format: html
+.. role:: pdf(raw)
+  :format: latex pdflatex
 .. _Program: https://github.com/ThreeMammals/Ocelot/blob/main/samples/Basic/Program.cs
 .. _Polly: https://www.thepollyproject.org
 .. _documentation: https://www.pollydocs.org
+.. |QoS_label| image:: https://img.shields.io/badge/-QoS-D3ADAF.svg
+  :target: https://github.com/ThreeMammals/Ocelot/labels/QoS
+  :alt: label QoS
+  :class: img-valign-textbottom
 
 Quality of Service
 ==================
 
-  Label: |QoS_label|
+  Repository Label: |QoS_label|:pdf:`\href{https://github.com/ThreeMammals/Ocelot/labels/QoS}{QoS}`
 
 Ocelot currently supports a single *Quality of Service* (QoS) capability.
 It allows you to configure, on a per-route basis, the application of a circuit breaker when making requests to downstream services.
@@ -162,5 +170,3 @@ Finally, to define your own set of exceptions for mapping, you can apply the fol
 .. _2073: https://github.com/ThreeMammals/Ocelot/pull/2073
 .. _23.2: https://github.com/ThreeMammals/Ocelot/releases/tag/23.2.0
 .. _24.0: https://github.com/ThreeMammals/Ocelot/releases/tag/24.0.0
-.. |QoS_label| image:: https://img.shields.io/badge/-QoS-D3ADAF.svg
-   :target: https://github.com/ThreeMammals/Ocelot/labels/QoS

docs/images/k8s-logo-kubernetes.png

@@ -1,3 +1,8 @@
+.. role:: htm(raw)
+  :format: html
+.. role:: pdf(raw)
+  :format: latex pdflatex
+
 Hosting Gotchas
 ===============
 
@@ -11,8 +16,8 @@ Please review deployment and web hosting common user scenarios below depending o
 IIS
 ---
 
-    | Repository Label: |image-IIS| `IIS <https://github.com/ThreeMammals/Ocelot/labels/IIS>`_
-    | Microsoft Learn: `Host ASP.NET Core on Windows with IIS <https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/>`_
+  | Repository Label: |image-IIS|:pdf:`\href{https://github.com/ThreeMammals/Ocelot/labels/IIS}{IIS}`
+  | Microsoft Learn: `Host ASP.NET Core on Windows with IIS <https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/>`_
 
 We **do not** recommend to deploy Ocelot app to IIS environments, but if you do, keep in mind the gotchas below.
 
@@ -28,11 +33,12 @@ The community constanly reports `issues related to IIS <https://github.com/Three
 If you have some troubles in IIS environment to host Ocelot app, first of all, read open/closed issues, and after that, search for `IIS-related objects`_ in the repository.
 Probably you will find a ready solution by Ocelot community members. 
 
-    Finally, we have special label |image-IIS| for all `IIS-related objects`_.
+    Finally, there is the special |image-IIS|:pdf:`\href{https://github.com/ThreeMammals/Ocelot/labels/IIS}{IIS}` label for all `IIS-related objects`_.
     Feel free to put this label onto `issues <https://github.com/ThreeMammals/Ocelot/labels/IIS>`_, `pull requests <https://github.com/ThreeMammals/Ocelot/pulls?q=is%3Apr+label%3AIIS+>`_, `discussions <https://github.com/ThreeMammals/Ocelot/discussions?discussions_q=label%3AIIS>`_, etc.
 
 .. |image-IIS| image:: ../images/label-IIS-c5def5.svg
   :alt: label IIS
+  :class: img-valign-bottom
   :target: https://github.com/ThreeMammals/Ocelot/labels/IIS
 .. _IIS-related objects: https://github.com/search?q=repo%3AThreeMammals%2FOcelot%20IIS&type=code
 
@@ -41,8 +47,8 @@ Probably you will find a ready solution by Ocelot community members.
 Kestrel
 -------
 
-    | Repository Label: |image-Kestrel| `Kestrel <https://github.com/ThreeMammals/Ocelot/labels/Kestrel>`_
-    | Microsoft Learn: `Kestrel web server in ASP.NET Core <https://learn.microsoft.com/en-us/aspnet/core/fundamentals/servers/kestrel>`_
+  | Repository Label: |image-Kestrel|:pdf:`\href{https://github.com/ThreeMammals/Ocelot/labels/Kestrel}{Kestrel}`
+  | Microsoft Learn: `Kestrel web server in ASP.NET Core <https://learn.microsoft.com/en-us/aspnet/core/fundamentals/servers/kestrel>`_
 
 We **do** recommend to deploy Ocelot app to self-hosting environments, aka Kestrel vs Docker.
 We try to optimize Ocelot web app for Kestrel & Docker hosting scenarios, but keep in mind the following gotchas.
@@ -77,11 +83,12 @@ As a quick fix, use this configuration recipe:
 
 .. _break: http://break.do
 
-    Finally, we have special label |image-Kestrel| for all `Kestrel-related objects <https://github.com/search?q=repo%3AThreeMammals%2FOcelot%20Kestrel&type=code>`_.
+    Finally, there is the special |image-Kestrel|:pdf:`\href{https://github.com/ThreeMammals/Ocelot/labels/Kestrel}{Kestrel}` label for all `Kestrel-related objects <https://github.com/search?q=repo%3AThreeMammals%2FOcelot%20Kestrel&type=code>`_.
     Feel free to put this label onto `issues <https://github.com/ThreeMammals/Ocelot/labels/Kestrel>`__, `pull requests <https://github.com/ThreeMammals/Ocelot/pulls?q=is%3Apr+label%3AKestrel+>`__, `discussions <https://github.com/ThreeMammals/Ocelot/discussions?discussions_q=label%3AKestrel>`__, etc.
 
 .. |image-Kestrel| image:: ../images/label-Kestrel-c5def5.svg
   :alt: label Kestrel
+  :class: img-valign-bottom
   :target: https://github.com/ThreeMammals/Ocelot/labels/Kestrel
 
 """"