Add sphinxcontrib-versioning
- 'make versioned' target to build w/versions, and supporting 'make
prep' target.
- Rework how checking out refs in repos are done in the makefile
- Change versioning method from VERSION file to conf.py
- use fork of sphinxconfig-versioning to deal with repos/ structure
- move OTHER_REPO_DOCS in Makefile so doc8 target requires that docs are
checked out in repos/ .
Change-Id: I6f5d6eee324bbbe31b71e1af596f0d8feb8f8785
diff --git a/conf.py b/conf.py
index 8f6ce2d..53961f6 100644
--- a/conf.py
+++ b/conf.py
@@ -16,12 +16,6 @@
# import sys
# sys.path.insert(0, os.path.abspath('.'))
-import os
-
-def get_version():
- with open("VERSION") as f:
- return f.read().strip()
-
# -- Project information -----------------------------------------------------
project = u'VOLTHA Docs'
@@ -29,10 +23,10 @@
author = u'VOLTHA Contributors'
# The short X.Y version
-version = get_version()
+version = "2.2.0-dev"
# The full version, including alpha/beta/rc tags
-release = get_version()
+release = version
# -- General configuration ---------------------------------------------------
@@ -80,6 +74,12 @@
# Text files with lists of words that shouldn't fail the spellchecker:
spelling_word_list_filename=['dict.txt', ]
+# SCVersioning prep target commands, run in each target directory
+scv_prep_commands = [
+ 'ln -sf _root_/repos _target_/repos',
+ 'make prep',
+]
+
# Add any paths that contain templates here, relative to this directory.
templates_path = ['_templates']