Merge pull request #745 from pradameinhof/25-05-08-ReadTheDocs-Fixes

Fix issues on ReadThe Docs documentation

Author: StephenHinck

docs/_static/css/custom.css

@@ -0,0 +1,11 @@
+/* Custom style for 'deprecated' admonitions */
+div.admonition.deprecated {
+    border-left: 4px solid #e03e2d;    /* Strong red border */
+    background-color: #ffeaea;         /* Light red background */
+}
+
+/* Title bar styling */
+div.admonition.deprecated .admonition-title {
+    background-color: #e03e2d;
+    color: white;
+}

docs/_templates/layout.html

@@ -2,7 +2,7 @@
 
 {% block extrahead %}
   {{ super() }}
-  {% if meta.canonical %}
+  {% if meta is defined and meta.canonical %}
     <link rel="canonical" href="{{ meta.canonical }}" />
   {% endif %}
 {% endblock %}

docs/conf.py

@@ -33,6 +33,7 @@
 import sphinx_rtd_theme
 extensions = [
     "sphinx_rtd_theme",
+    "sphinx.ext.todo",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -56,6 +57,8 @@
     "canonical_url": "https://bloodhound.specterops.io/"
 }
 
+# Static files path
+html_static_path = ['_static']
 
 # Load custom CSS so that deprecated notice boxes are displayed in red 
 def setup(app):
@@ -65,6 +68,5 @@ def setup(app):
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
 
 master_doc = 'index'

docs/index.rst

@@ -1,9 +1,13 @@
-.. note::
-   This documentation applies to Legacy BloodHound and is no longer maintained.
+.. admonition:: Deprecated Documentation
+   :class: deprecated
 
-   See up-to-date documentation for BloodHound CE here: `BloodHound Support`_
+   **This documentation refers to deprecated BloodHound Legacy (version 4.3, released in 2023).** 
+
+   Please use the `current BloodHound CE Documentation <https://bloodhound.specterops.io/>`_.
+
+.. meta::
+   :canonical: https://bloodhound.specterops.io/
 
-.. _BloodHound Support: https://support.bloodhoundenterprise.io/hc/en-us
 
 BloodHound: Six Degrees of Domain Admin
 =======================================