Doc improvements before the release (#1553)

Author: maximlt

doc/_static/custom.css

@@ -20,3 +20,9 @@
     border: 0px;
     vertical-align: top;
 }
+
+.getting-started-button {
+    border-radius: 6px !important;
+    padding: 0.7em 3em !important;
+    font-size: 1.2em;
+}

doc/_static/patch_templates/sourcelink.html

@@ -0,0 +1,9 @@
+{# Added because of https://github.com/pydata/pydata-sphinx-theme/issues/2088 #}
+{# Displays a link to the .rst source of the current page. #}
+{% if show_source and has_source and sourcename %}
+  <div class="tocsection sourcelink">
+    <a href="{{ pathto('_sources/' + sourcename, true)|e }}">
+      <i class="fa-solid fa-file-lines"></i> {{ _("Show Source") }}
+    </a>
+  </div>
+{% endif %}

doc/about.md

@@ -6,6 +6,7 @@
 
 import os
 import param
+import pydata_sphinx_theme
 
 param.parameterized.docstring_signature = False
 param.parameterized.docstring_describe_params = False
@@ -26,6 +27,10 @@
 
 html_static_path += ['_static']  # noqa
 
+if pydata_sphinx_theme.__version__ == '0.16.1':
+    # See https://github.com/pydata/pydata-sphinx-theme/issues/2088
+    templates_path.append('_static/patch_templates')  # noqa
+
 html_css_files += ['custom.css']  # noqa
 
 html_js_files = [
@@ -34,6 +39,7 @@
 
 html_theme_options.update(  # noqa
     {
+        'use_edit_page_button': True,
         'github_url': 'https://github.com/holoviz/hvplot',
         'icon_links': [
             {
@@ -57,6 +63,9 @@
     }
 )
 
+# Without this .txt is appended to the files
+html_sourcelink_suffix = ''
+
 html_theme = 'pydata_sphinx_theme'
 html_logo = '_static/logo_horizontal.svg'
 html_favicon = '_static/favicon.ico'
@@ -127,15 +136,23 @@
     'user_guide/pandas_api': 'ref/api_compatibility/pandas/pandas_api',
 }
 
+html_extra_path = ['topics.html']
+
 html_context.update(  # noqa
     {
         'last_release': f'v{release}',
-        'github_user': 'holoviz',
-        'github_repo': 'panel',
         'default_mode': 'light',
+        # Useful for the edit button
+        'github_user': 'holoviz',
+        'github_repo': 'hvplot',
+        'github_version': 'main',
+        'doc_path': 'doc',
     }
 )
 
+# linkcheck
+linkcheck_ignore = [r'https://github.com/holoviz/hvplot/pull/\d+']
+
 # mystnb
 nb_execution_excludepatterns = [
     'user_guide/Streaming.ipynb',