copyright="$(date +%Y), OPNFV."
copyrightlong="$(date +%Y), OPNFV. Licenced under CC BY 4.0."
+if [ "$(uname)" == "Darwin" ]; then
+ # Override system $SED/$FIND with gnu $SED and gnu $FIND
+ # If not found, install with
+ # $ brew install gnu-sed findutils
+ echo "macOS detected."
+ SED="gsed"
+ FIND="gfind"
+else
+ SED="sed"
+ FIND="find"
+fi
+
function check_rst_doc() {
_src="$1"
# check right now, but these have to be fixed before OPNFV B release.
_out=$(doc8 --max-line-length 240 --ignore D000 "$_src") || {
_msg='Warning: rst validation (doc8) has failed, please fix the following error(s).'
- _errs=$(echo "$_out" | sed -n -e "/^$_src/s/^/ /p")
+ _errs=$(echo "$_out" | $SED -n -e "/^$_src/s/^/ /p")
echo
echo -e "$_msg\n$_errs"
echo
function add_html_notes() {
_src="$1"
- find "$_src" -name '*.rst' | while read file
+ $FIND "$_src" -name '*.rst' | while read file
do
if grep -q -e ' _sha1_' "$file" ; then
# TODO: remove this, once old templates were removed from all repos.
echo "Warn: '_sha1_' was found in [$file], use the latest document template."
echo " See http://artifacts.opnfv.org/opnfvdocs/docs/how-to-use-docs ."
echo
- sed -i "s/ _sha1_/ $git_sha1/g" "$file"
+ $SED -i "s/ _sha1_/ $git_sha1/g" "$file"
fi
- sed -i -e "\$a\\\n..\n$html_notes" "$file"
+ $SED -i -e "\$a\\\n..\n$html_notes" "$file"
done
}
echo "sphinx config to be used:"
echo
- sed -e "s/^/ /" "$_conf"
+ $SED -e "s/^/ /" "$_conf"
echo
}
return
done
- echo "Error: cannot find name for top directory [$DOCS_DIR]"
+ echo "Error: cannot $FIND name for top directory [$DOCS_DIR]"
exit 1
}
source "$DOCS_DIR/pre-hook.sh"
fi
-find $DOCS_DIR -name $INDEX_RST -printf '%h\n' | while read dir
+$FIND $DOCS_DIR -name $INDEX_RST -printf '%h\n' | while read dir
do
name=$(generate_name $dir)
if is_top_dir "$dir" ; then
# docs directory.
(
cd $output
- find . -type d -print | xargs -I d mkdir -p ../d
- find . -type f -print | xargs -I f mv -b f ../f
+ $FIND . -type d -print | xargs -I d mkdir -p ../d
+ $FIND . -type f -print | xargs -I f mv -b f ../f
)
rm -rf "$output"
fi