docs(build): updated docs build image and templates

docs/source/_templates/sidebar/brand.html

@@ -0,0 +1,34 b''
+{#-
+
+Hi there!
+
+You might be interested in https://pradyunsg.me/furo/customisation/sidebar/
+
+Although if you're reading this, chances are that you're either familiar
+enough with Sphinx that you know what you're doing, or landed here from that
+documentation page.
+
+Hope your day's going well. :)
+
+-#}
+<a class="sidebar-brand{% if logo %} centered{% endif %}" href="{{ pathto(master_doc) }}">
+  {% block brand_content %}
+  {%- if logo_url %}
+  <div class="sidebar-logo-container">
+    <img class="sidebar-logo" src="{{ logo_url }}" alt="Logo"/>
+  </div>
+  {%- endif %}
+  {%- if theme_light_logo and theme_dark_logo %}
+  <div class="sidebar-logo-container">
+    <img class="sidebar-logo only-light" src="{{ pathto('_static/' + theme_light_logo, 1) }}" alt="Light Logo"/>
+    <img class="sidebar-logo only-dark" src="{{ pathto('_static/' + theme_dark_logo, 1) }}" alt="Dark Logo"/>
+  </div>
+  {%- endif %}
+  {% if not theme_sidebar_hide_name %}
+  <span class="sidebar-brand-text">
+      RhodeCode <br/>
+      rcstack {{ release }} docs
+  </span>
+  {%- endif %}
+  {% endblock brand_content %}
+</a>
  No newline at end of file

docs/.howto

@@ -1,6 +1,7 b''
-## BUILD Image for building docs
+## BUILD Image for building docs and push to rhodecode registry
 # cd docs
 # docker build --tag rhodecode/sphinx-doc-build .
+# docker push rhodecode/sphinx-doc-build
 
 # Build Docs
 # run from the project root dir; not docs dir

docs/requirements_docs.txt

@@ -1,11 +1,11 b''
 sphinx==7.2.6
 
-furo==2023.9.10
+furo==2024.1.29
 sphinx-press-theme==0.8.0
 sphinx-rtd-theme==1.3.0
 
-pygments==2.16.1
+pygments==2.17.2
 
 docutils<0.19
-markupsafe==2.1.3
-jinja2==3.1.2
+markupsafe==2.1.4
+jinja2==3.1.3

docs/source/_templates/page.html

@@ -13,6 +13,12 b''
   <div class="visually-hidden">Hide table of contents sidebar</div>
 </label>
 
+<a class="skip-to-content muted-link" href="#furo-main-content">
+  {%- trans -%}
+  Skip to content
+  {%- endtrans -%}
+</a>
+
 {% if theme_announcement -%}
 <div class="announcement">
   <aside class="announcement-content">
@@ -87,7 +93,7 b''
             <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
           </label>
         </div>
-        <article role="main">
+        <article role="main" id="furo-main-content">
           {% block content %}{{ body }}{% endblock %}
         </article>
       </div>
@@ -141,6 +147,9 b''
             {% trans %}<a href="https://www.sphinx-doc.org/">Sphinx</a> and {% endtrans -%}
             <a class="muted-link" href="https://pradyunsg.me">@pradyunsg</a>'s
             {% endif -%}
+
+
+
             {%- if last_updated -%}
             <div class="last-updated">
               {% trans last_updated=last_updated|e -%}
@@ -149,7 +158,7 b''
             </div>
 
             <div style="border-top: 0">
-              Got documentation defects and suggestions? <a href="https://community.rhodecode.com">Submit docs issues</a>
+              Got documentation defects and suggestions? <a href="https://community.rhodecode.com/new-topic?title=documentation%20issue&body=Please%20describe%20the%20issue&category=support&tags=docs-issue">Submit docs issues</a>
             </div>
 
             {%- endif %}
@@ -172,6 +181,9 b''
                 </svg>
               </a>
               {%- endif -%}
+              {#- Show GitHub repository home -#}
+              {%- if READTHEDOCS and display_github and github_user != "None" and github_repo != "None" -%}
+              {%- endif -%}
               {%- endif %}
             </div>
             {%- endif %}
@@ -200,5 +212,4 b''
     </aside>
   </div>
 </div>
-
 {%- endblock %}