Browse Source

Follow the new PTI for document build

For compliance with the Project Testing Interface as described in:
https://governance.openstack.org/tc/reference/project-testing-interface.html

For more detials information, please refer to:
http://lists.openstack.org/pipermail/openstack-dev/2017-December/125710.html

Change-Id: I66c2cd22230d849cf8669bb768264c49d0e453b6
ZhongShengping 1 year ago
parent
commit
95d6063c02
3 changed files with 13 additions and 9 deletions
  1. 10
    0
      doc/requirements.txt
  2. 0
    7
      test-requirements.txt
  3. 3
    2
      tox.ini

+ 10
- 0
doc/requirements.txt View File

@@ -0,0 +1,10 @@
1
+# The order of packages is significant, because pip processes them in the order
2
+# of appearance. Changing the order has an impact on the overall integration
3
+# process, which may cause wedges in the gate later.
4
+
5
+# this is required for the docs build jobs
6
+sphinx!=1.6.6,>=1.6.2 # BSD
7
+openstackdocstheme>=1.18.1 # Apache-2.0
8
+reno>=2.5.0 # Apache-2.0
9
+sphinxmark>=0.1.14 # Apache-2.0
10
+doc8>=0.6.0 # Apache-2.0

+ 0
- 7
test-requirements.txt View File

@@ -7,10 +7,3 @@ pyasn1!=0.2.3,>=0.1.8 # BSD
7 7
 pyOpenSSL>=16.2.0 # Apache-2.0
8 8
 requests>=2.14.2 # Apache-2.0
9 9
 ndg-httpsclient>=0.4.2;python_version<'3.0' # BSD
10
-
11
-# this is required for the docs build jobs
12
-sphinx!=1.6.6,>=1.6.2 # BSD
13
-openstackdocstheme>=1.18.1 # Apache-2.0
14
-doc8>=0.6.0 # Apache-2.0
15
-reno>=2.5.0 # Apache-2.0
16
-sphinxmark>=0.1.14 # Apache-2.0

+ 3
- 2
tox.ini View File

@@ -31,10 +31,11 @@ setenv =
31 31
 
32 32
 
33 33
 [testenv:docs]
34
+deps = -r{toxinidir}/doc/requirements.txt
34 35
 commands=
35 36
     bash -c "rm -rf doc/build"
36 37
     doc8 doc
37
-    python setup.py build_sphinx
38
+    sphinx-build -b html doc/source doc/build/html
38 39
 
39 40
 
40 41
 [doc8]
@@ -43,6 +44,7 @@ extensions = .rst
43 44
 
44 45
 
45 46
 [testenv:releasenotes]
47
+deps = -r{toxinidir}/doc/requirements.txt
46 48
 commands =
47 49
     sphinx-build -a -E -W -d releasenotes/build/doctrees -b html releasenotes/source releasenotes/build/html
48 50
 
@@ -112,4 +114,3 @@ commands =
112 114
     {[testenv:bashate]commands}
113 115
     {[testenv:ansible-lint]commands}
114 116
     {[testenv:ansible-syntax]commands}
115
-    {[testenv:docs]commands}

Loading…
Cancel
Save