Merge pull request #7771 from ThomasWaldmann/docs-work

docs related work

.github/workflows/ci.yml

@@ -55,6 +55,9 @@ jobs:
             - os: ubuntu-20.04
               python-version: '3.9'
               toxenv: mypy
+            - os: ubuntu-20.04
+              python-version: '3.11'
+              toxenv: docs
             - os: ubuntu-20.04
               python-version: '3.9'
               toxenv: py39-fuse2

README.rst

@@ -13,8 +13,6 @@ TODO: the screencasts need a remake using borg2, see there:
 
 https://github.com/borgbackup/borg/issues/6303
 
-.. |screencast_basic|
-.. More screencasts: `installation`_, `advanced usage`_
 
 What is BorgBackup?
 -------------------

tox.ini

@@ -2,13 +2,14 @@
 # fakeroot -u tox --recreate
 
 [tox]
-envlist = py{39,310,311}-{none,fuse2,fuse3}
+envlist = py{39,310,311}-{none,fuse2,fuse3},docs
 minversion = 3.2
 requires =
 	pkgconfig
 	cython
 	wheel
 	setuptools_scm
+
 [testenv]
 package = editable-legacy  # without this it does not find setup_docs when running under fakeroot
 setenv =
@@ -42,3 +43,11 @@ deps =
     mypy
     pkgconfig
 commands = mypy
+
+[testenv:docs]
+changedir = docs
+deps =
+    sphinx
+    guzzle_sphinx_theme
+commands =
+    sphinx-build -n -v -W --keep-going -b html -d {envtmpdir}/doctrees . {envtmpdir}/html