openstack
/
openstack-doc-tools
Code Issues Proposed changes

PDF support using --pdf option 

Change-Id: I4a609fbd5d7b04c1f9c8c1b25d68072dab097ff1
Implements: blueprint build-pdf-from-rst-guides
This commit is contained in:
Ian Y. Choi 2016-11-30 00:54:34 +09:00
parent 055b43e4f2
commit 2356c4d4e6
1 changed files with 19 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
bin/doc-tools-build-rst
View File

@ -21,6 +21,7 @@ if [ -z "$DIRECTORY" ] ; then
echo "--target TARGET: Copy files to publish-docs/$TARGET" echo "--target TARGET: Copy files to publish-docs/$TARGET"
echo "--build BUILD: Name of build directory" echo "--build BUILD: Name of build directory"
echo "--linkcheck: Check validity of links instead of building" echo "--linkcheck: Check validity of links instead of building"
echo "--pdf: PDF file generation"
exit 1 exit 1
fi fi
@ -29,6 +30,7 @@ TAG=""
TAG_OPT="" TAG_OPT=""
BUILD="" BUILD=""
LINKCHECK="" LINKCHECK=""
PDF=""
while [[ $# > 0 ]] ; do while [[ $# > 0 ]] ; do
option="$1" option="$1"
@ -49,6 +51,9 @@ while [[ $# > 0 ]] ; do
TARGET="$2" TARGET="$2"
shift shift
;; ;;
--pdf)
PDF=1
;;
esac esac
shift shift
done done
@ -57,11 +62,14 @@ done
if [ -z "$BUILD" ] ; then if [ -z "$BUILD" ] ; then
if [ -z "$TAG" ] ; then if [ -z "$TAG" ] ; then
BUILD_DIR="$DIRECTORY/build/html" BUILD_DIR="$DIRECTORY/build/html"
BUILD_DIR_PDF="$DIRECTORY/build/pdf"
else else
BUILD_DIR="$DIRECTORY/build-${TAG}/html" BUILD_DIR="$DIRECTORY/build-${TAG}/html"
BUILD_DIR_PDF="$DIRECTORY/build-${TAG}/pdf"
fi fi
else else
BUILD_DIR="$DIRECTORY/$BUILD/html" BUILD_DIR="$DIRECTORY/$BUILD/html"
BUILD_DIR_PDF="$DIRECTORY/$BUILD/pdf"
fi fi
DOCTREES="${BUILD_DIR}.doctrees" DOCTREES="${BUILD_DIR}.doctrees"
@ -85,7 +93,17 @@ else
$TAG_OPT $DIRECTORY/source $BUILD_DIR $TAG_OPT $DIRECTORY/source $BUILD_DIR
set +x set +x
# Copy RST # PDF generation
if [ "$PDF" = "1" ] ; then
set -x
sphinx-build -E -W -d $DOCTREES -b latex \
$TAG_OPT $DIRECTORY/source $BUILD_DIR_PDF
make -C $BUILD_DIR_PDF
cp $BUILD_DIR_PDF/*.pdf $BUILD_DIR/
set +x
fi
# Copy RST (and PDF)
if [ "$TARGET" != "" ] ; then if [ "$TARGET" != "" ] ; then
mkdir -p publish-docs/$TARGET mkdir -p publish-docs/$TARGET
rsync -a $BUILD_DIR/ publish-docs/$TARGET/ rsync -a $BUILD_DIR/ publish-docs/$TARGET/