Merge pull request #103 from epics-containers/fix-docs

Fix edit button in docs

Author: gilesknap

docs/conf.py

@@ -5,17 +5,29 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 
 import sys
+from importlib import metadata
+from pathlib import Path
+from subprocess import check_output
 
 import requests
 
 # -- General configuration ------------------------------------------------
 
-# TODO do we want to set this from code?
-version = "1.0"
-
 # General information about the project.
 project = "epics-containers"
 
+# The full version, including alpha/beta/rc tags.
+release = metadata.version(project)
+
+# The short X.Y version.
+if "+" in release:
+    # Not on a tag, use branch name
+    root = Path(__file__).absolute().parent.parent
+    git_branch = check_output("git branch --show-current".split(), cwd=root)
+    version = git_branch.decode().strip()
+else:
+    version = release
+
 extensions = [
     # Use this for generating API docs
     "sphinx.ext.autodoc",
@@ -108,7 +120,7 @@
 html_theme = "pydata_sphinx_theme"
 github_repo = "epics-containers.github.io"
 github_user = "epics-containers"
-switcher_json = f"https://{github_user}.github.io/{github_repo}/switcher.json"
+switcher_json = f"https://{github_user}.github.io/switcher.json"
 switcher_exists = requests.get(switcher_json).ok
 if not switcher_exists:
     print(
@@ -153,7 +165,7 @@
 # A dictionary of values to pass into the template engine’s context for all pages
 html_context = {
     "github_user": github_user,
-    "github_repo": project,
+    "github_repo": github_repo,
     "github_version": version,
     "doc_path": "docs",
 }

pyproject.toml

@@ -1,17 +1,13 @@
 [build-system]
-requires = ["setuptools>=64", "setuptools_scm[toml]>=6.2", "wheel"]
+requires = ["setuptools>=64", "setuptools_scm[toml]>=6.2"]
 build-backend = "setuptools.build_meta"
 
+# This is a minimal toml file to allow us to do pip install
 [project]
 name = "epics_containers"
 dynamic = ["version"]
-readme = "README.md"
-
-# This is a minimal toml file to allow us to do pip install
-dependencies = ["copier"]
 
-[tool.setuptools]
-include-package-data = false
+[tool.setuptools_scm]
 
 [project.optional-dependencies]
 dev = [