/
make-sphinx-docs
executable file
·40 lines (38 loc) · 1.83 KB
/
make-sphinx-docs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
#!/bin/bash
#
# Helper script for updating the Sphinx documentation. It requires a full install of the
# dependencies so we do that in a mock chroot.
#
# Copyright (C) 2015 Red Hat, Inc.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as published
# by the Free Software Foundation; either version 2.1 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
# Author: Brian C. Lane <bcl@redhat.com>
#
MOCKCFG=fedora-rawhide-x86_64
if [ -z "$DISPLAY" ]; then
echo "Run script on a desktop system with a GUI"
exit 1
fi
# Pass it anything to skip re-initialzing the chroot
[ -z "$1" ] && mock -r $MOCKCFG --init
mock -r $MOCKCFG -i python-blivet -i python-sphinx -i python-sphinx_rtd_theme -i pygobject3 -i python-mock
mock -r $MOCKCFG --copyin $PWD /builddir/blivet/
# Note that DISPLAY is needed to make GTK happy, so this needs to be run from a system with a GUI
mock -r $MOCKCFG --chroot "cd /builddir/blivet/doc/; DISPLAY=$DISPLAY make html"
mock -r $MOCKCFG --copyout /builddir/blivet/doc/_build/html $PWD/doc/_build/html
# blivet currently uses RTD for docs, skip the instructions for now.
#echo "Now make sure the ./doc/html.new/ looks ok and copy it over the top of ./doc/html/ and commit."
#echo "Then copy ./doc/html/ outside the repo and check out the gh-pages branch. Copy them back to /"
#echo "and commit to update the https://rhinstaller.github.io/blivet/ page."