From 7f61502374b4e2f54e1861ba3eaa1dc7f53b4416 Mon Sep 17 00:00:00 2001 From: Ryota MIBU Date: Mon, 7 Dec 2015 20:51:42 +0900 Subject: docs: add process to request new sphinx extension(s) http://lists.opnfv.org/pipermail/opnfv-tech-discuss/2015-December/006901.html Change-Id: I3a2691bd1d69b5c8c250aaec34e4b76e28e7df73 Signed-off-by: Ryota MIBU Co-Authored-By: Ildiko Vancsa --- docs/etc/conf.py | 8 +++++++- docs/etc/requirements.txt | 1 + 2 files changed, 8 insertions(+), 1 deletion(-) create mode 100644 docs/etc/requirements.txt (limited to 'docs/etc') diff --git a/docs/etc/conf.py b/docs/etc/conf.py index 06ae7be01..d10868de5 100644 --- a/docs/etc/conf.py +++ b/docs/etc/conf.py @@ -6,7 +6,13 @@ directory (e.g. docs/how-to-use-docs/conf.py). If there is no 'conf.py' in the document directory, this file will be copied to that directory before the document builder jobs ('opnfv-docs-verify' and 'opnfv-docs-merge'). -See https://wiki.opnfv.org/documentation/tools . +You may need python package installation for new sphinx extension. +Install python package with 'pip' in your machine and add the extension to +the 'extensions' list below to test the documentation build locally. +If you feel that your extensions would be useful for other projects too, +we encourage you to propose a change in the releng repository. + +For further guidance see the https://wiki.opnfv.org/documentation/tools page. ''' extensions = ['sphinxcontrib.httpdomain'] diff --git a/docs/etc/requirements.txt b/docs/etc/requirements.txt new file mode 100644 index 000000000..4df3b687d --- /dev/null +++ b/docs/etc/requirements.txt @@ -0,0 +1 @@ +sphinxcontrib-httpdomain -- cgit 1.2.3-korg