summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJoshua Watt <JPEWhacker@gmail.com>2020-11-10 15:29:17 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2020-11-12 13:04:10 +0000
commit89a4534f8166761855bd4dfb1d3d01f2cf306a4a (patch)
treed69ff04f9ed62605c43fdf8079f291e1c107088b
parenta8ec1f72ba29926a34ce07a847ce1e7c17c2ef5f (diff)
downloadpoky-89a4534f8166761855bd4dfb1d3d01f2cf306a4a.tar.gz
documentation: Add Pipenv support
Adds a Pipfile so that Pipenv can be used to automatically install all the dependencies required to build the documentation (From yocto-docs rev: 31658ad30827d38dcd4ea83bcfb828441c7c3eca) Signed-off-by: Joshua Watt <JPEWhacker@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
-rw-r--r--documentation/.gitignore1
-rw-r--r--documentation/Pipfile14
-rw-r--r--documentation/README7
3 files changed, 22 insertions, 0 deletions
diff --git a/documentation/.gitignore b/documentation/.gitignore
index 69fa449dd9..21bb72530a 100644
--- a/documentation/.gitignore
+++ b/documentation/.gitignore
@@ -1 +1,2 @@
1_build/ 1_build/
2Pipfile.lock
diff --git a/documentation/Pipfile b/documentation/Pipfile
new file mode 100644
index 0000000000..7ee1d22905
--- /dev/null
+++ b/documentation/Pipfile
@@ -0,0 +1,14 @@
1[[source]]
2name = "pypi"
3url = "https://pypi.org/simple"
4verify_ssl = true
5
6[dev-packages]
7
8[packages]
9sphinx = "*"
10sphinx-rtd-theme = "*"
11pyyaml = "*"
12
13[requires]
14python_version = "3"
diff --git a/documentation/README b/documentation/README
index 534ae66f86..28d5c4be8e 100644
--- a/documentation/README
+++ b/documentation/README
@@ -127,6 +127,13 @@ The resulting HTML index page will be _build/html/index.html, and you
127can browse your own copy of the locally generated documentation with 127can browse your own copy of the locally generated documentation with
128your browser. 128your browser.
129 129
130Alternatively, you can use Pipenv to automatically install all required
131dependencies in a virtual environment:
132
133 $ cd documentation
134 $ pipenv install
135 $ pipenv run make html
136
130Sphinx theme and CSS customization 137Sphinx theme and CSS customization
131================================== 138==================================
132 139