blob: fdeb26d31b7db48567346244c40367dc7758367e (
plain)
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
#!/bin/bash
# shellcheck disable=SC2086
OUTFILENAME="APP_Controller_doc"
SCRIPT=$(basename "${BASH_SOURCE[@]}")
VERSION=$(grep '"version":' "$(dirname "${BASH_SOURCE[@]}")/book.json" | cut -d'"' -f 4)
[ "$VERSION" != "" ] && OUTFILENAME="${OUTFILENAME}_v${VERSION}"
function usage() {
cat <<EOF >&2
Usage: $SCRIPT [options] [pdf|serve|doxygen]
Options:
--debug
enable debug when generating pdf or html documentation
-d|--dry
dry run
-h|--help
get this help
Example:
$SCRIPT pdf
EOF
exit 1
}
function info() {
echo "$@" >&2
}
#default values
DEBUG_FLAG=""
DRY=""
DO_ACTION=""
OUT_DIR=./build
ARGS=""
[ $# = 0 ] && usage
while [ $# -gt 0 ]; do
case "$1" in
--debug) DEBUG_FLAG="--log=debug --debug";;
-d|--dry) DRY="echo";;
-h|--help) usage;;
pdf | serve | doxygen) DO_ACTION=$1;;
--) shift; ARGS="$ARGS $*"; break;;
*) ARGS="$ARGS $1";;
esac
shift
done
cd "$(dirname "$0")" || exit 1
ROOTDIR=$(pwd -P)
# Create out dir if needed
[ -d $OUT_DIR ] || mkdir -p $OUT_DIR
if [ "$DO_ACTION" = "pdf" ] || [ "$DO_ACTION" = "serve" ]; then
GITBOOK=$(which gitbook)
[ "$?" = "1" ] && { echo "You must install gitbook first, using: sudo npm install -g gitbook-cli"; exit 1; }
which ebook-convert > /dev/null 2>&1
[ "$?" = "1" ] && { echo "You must install calibre first, using: 'sudo apt install calibre' or refer to https://calibre-ebook.com/download"; exit 1; }
[ ! -d "$ROOTDIR/node_modules" ] && $GITBOOK install
if [ "$DO_ACTION" = "pdf" ]; then
# Update cover when book.json has been changed
[[ $ROOTDIR/book.json -nt $ROOTDIR/docs/cover.jpg ]] && { echo "Update cover files"; $ROOTDIR/docs/resources/make_cover.sh || exit 1; }
OUTFILE=$OUT_DIR/$OUTFILENAME.pdf
if $DRY $GITBOOK pdf $ROOTDIR $OUTFILE $DEBUG_FLAG $ARGS; then
echo "PDF has been successfully generated in $OUTFILE"
fi
else
$DRY $GITBOOK serve $DEBUG_FLAG $ARGS
fi
elif [ "$DO_ACTION" = "doxygen" ]; then
$DRY cd $OUT_DIR && cmake .. && make doxygen $ROOTDIR/Doxyfile
else
echo "Unknown action !"
usage
fi
|
