summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPatrick Ohly <patrick.ohly@intel.com>2022-06-28 09:02:13 +0200
committerPatrick Ohly <patrick.ohly@intel.com>2022-06-28 09:02:13 +0200
commit7ad084609e1eb6e08b948ecb57c62797b39e580c (patch)
tree21f72c79a1b0902a70d88f94b0c29931b707261d
parent6d9822aa82e4dd2a9f3c0ae1604735bb257ad6da (diff)
dependency update
The newer releases changed the rendering of the top-left "home" link. We don't want the release number to be included there and thus have to override it. Eventually the logo needs to go there.
-rw-r--r--conf.py14
-rw-r--r--requirements.txt10
2 files changed, 17 insertions, 7 deletions
diff --git a/conf.py b/conf.py
index 0607f424..3cb2b92a 100644
--- a/conf.py
+++ b/conf.py
@@ -22,7 +22,7 @@ copyright = '2022, Patrick Ohly'
author = 'Patrick Ohly'
# The full version, including alpha/beta/rc tags
-release = 'https://syncevolution.org'
+release = ''
# -- General configuration ---------------------------------------------------
@@ -58,12 +58,15 @@ post_auto_excerpt = 1 # first paragraph of each blog is shown in archive pages
# matter. A blog post must have at least one section header.
myst_title_to_header = True
+# https://myst-parser.readthedocs.io/en/latest/syntax/optional.html#syntax-header-anchors
+myst_heading_anchors = 3
+
myst_enable_extensions = [
"deflist",
"linkify",
]
-# TODO: convert atom.xml (ABlog) to rss.xml (Drupal)
+# TODO: convert atom.xml (ABlog) to rss.xml (Drupal) aka feed
# https://atom.geekhood.net/
# Add any paths that contain templates here, relative to this directory.
@@ -80,9 +83,13 @@ exclude_patterns = ['README.md', 'export', '_build', 'Thumbs.db', '.DS_Store']
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
#
+# https://pydata-sphinx-theme.readthedocs.io/
html_theme = 'pydata_sphinx_theme'
html_theme_options = {
+ "logo": {
+ "text": "SyncEvolution",
+ },
"search_bar_text": "Search this site...",
"navbar_end": ["search-field.html", "navbar-icon-links"],
}
@@ -93,3 +100,6 @@ html_theme_options = {
html_static_path = ['_static']
html_favicon = "_static/favicon.ico"
+
+# TODO
+# html_logo = "_static/logo.png"
diff --git a/requirements.txt b/requirements.txt
index 9ec5b027..a4e83de0 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,14 +1,14 @@
# Python packages required for building HTML with Sphinx.
-sphinx
+sphinx==5.0.2
# https://myst-parser.readthedocs.io/en/latest/sphinx/intro.html
-myst-parser
+myst-parser==0.18.0
# https://ablog.readthedocs.io/en/latest/
-ablog
+ablog==0.10.25
# For https://myst-parser.readthedocs.io/en/latest/syntax/optional.html#linkify
-linkify-it-py
+linkify-it-py==2.0.0
# Optional theme.
-pydata-sphinx-theme
+pydata-sphinx-theme==0.9.0