Amebis/wxWidgets
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Allow setting WX_HTML_OUTPUT_DIR to override default location

Browse Source 
This allows to avoid making custom changes when generating the docs on
docs.wxwidgets.org and can be more generally useful too.
This commit is contained in:
Vadim Zeitlin
2022-03-28 15:43:32 +02:00
parent cd4d9011b7
commit efa1c59141
1 changed files with 12 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
docs/doxygen/regen.sh
View File

@@ -51,14 +51,18 @@ if [[ -z $WX_SKIP_DOXYGEN_VERSION_CHECK ]]; then
fi fi
fi fi
if [[ -z $WX_HTML_OUTPUT_DIR ]]; then
WX_HTML_OUTPUT_DIR=out/html
fi
# prepare folders for the cp commands below # prepare folders for the cp commands below
mkdir -p out/html # we need to copy files in this folder below mkdir -p $WX_HTML_OUTPUT_DIR # we need to copy files in this folder below
mkdir -p out/html/generic mkdir -p $WX_HTML_OUTPUT_DIR/generic
# These are not automatically copied by Doxygen because they're not # These are not automatically copied by Doxygen because they're not
# used in doxygen documentation, only in our html footer and by our # used in doxygen documentation, only in our html footer and by our
# custom aliases # custom aliases
cp images/generic/*png out/html/generic cp images/generic/*png $WX_HTML_OUTPUT_DIR/generic
# Defaults for settings controlled by this script # Defaults for settings controlled by this script
export GENERATE_DOCSET="NO" export GENERATE_DOCSET="NO"
@@ -118,12 +122,12 @@ $DOXYGEN Doxyfile
if [[ "$1" = "php" ]]; then if [[ "$1" = "php" ]]; then
# Work around a bug in Doxygen < 1.8.19 PHP search function. # Work around a bug in Doxygen < 1.8.19 PHP search function.
cp custom_search_functions.php out/html/search_functions.php cp custom_search_functions.php $WX_HTML_OUTPUT_DIR/search_functions.php
fi fi
if [[ "$1" = "qch" ]]; then if [[ "$1" = "qch" ]]; then
# we need to add missing files to the .qhp # we need to add missing files to the .qhp
cd out/html cd $WX_HTML_OUTPUT_DIR
qhelpfile="index.qhp" qhelpfile="index.qhp"
# remove all <file> and <files> tags # remove all <file> and <files> tags
@@ -146,7 +150,7 @@ if [[ "$1" = "qch" ]]; then
# remove useless files to make the qch slim # remove useless files to make the qch slim
rm temp *map *md5 rm temp *map *md5
# add a <file> tag for _any_ file in out/html folder except the .qhp itself # add a <file> tag for _any_ file in this directory except the .qhp itself
for f in * */*png; do for f in * */*png; do
if [[ $f != $qhelpfile ]]; then if [[ $f != $qhelpfile ]]; then
echo " <file>$f</file>" >>$qhelpfile echo " <file>$f</file>" >>$qhelpfile
@@ -166,7 +170,7 @@ if [[ "$1" = "qch" ]]; then
# last, run qhelpgenerator: # last, run qhelpgenerator:
cd ../.. cd ../..
qhelpgenerator out/html/index.qhp -o out/wx.qch qhelpgenerator $WX_HTML_OUTPUT_DIR/index.qhp -o out/wx.qch
fi fi
if [[ "$1" = "docset" ]]; then if [[ "$1" = "docset" ]]; then
@@ -182,7 +186,7 @@ if [[ "$1" = "docset" ]]; then
XCODE_INSTALL=`xcode-select -print-path` XCODE_INSTALL=`xcode-select -print-path`
fi fi
cd out/html cd $WX_HTML_OUTPUT_DIR
DESTINATIONDIR=`pwd`/../docset DESTINATIONDIR=`pwd`/../docset
mkdir -p $DESTINATIONDIR mkdir -p $DESTINATIONDIR