maintenance/mwjsduck-gen

   1 #!/usr/bin/env bash
   2
   3 JSDUCK_MWVERSION=master
   4 if [[ "$1" == "--version" && "$2" != "" ]]
   5 then
   6         JSDUCK_MWVERSION="$2"
   7 elif [[ "$*" != "" ]]
   8 then
   9         FILENAME=$(basename $0)
  10         echo "Usage: $FILENAME [--version <mediawiki version>]"
  11         echo
  12         exit 1
  13 fi
  14
  15 MWCORE_DIR=$(cd $(dirname $0)/..; pwd)
  16
  17 # Support jsduck 4.x and 5.x
  18 JSDUCK_VERSION="$(jsduck --version | sed -e 's/[.].*//')"
  19 if [  "$JSDUCK_VERSION" = "JSDuck 4" ]; then
  20         JSDUCK_VERSION_OPT="--meta-tags $MWCORE_DIR/maintenance/jsduck/MetaTags.rb --warnings=-no_doc"
  21 else
  22         JSDUCK_VERSION_OPT="--tags $MWCORE_DIR/maintenance/jsduck/CustomTags.rb --warnings=-nodoc(class,public)"
  23 fi
  24
  25 jsduck \
  26 --config=$MWCORE_DIR/maintenance/jsduck/config.json \
  27 $JSDUCK_VERSION_OPT \
  28 --footer="Documentation for branch ($JSDUCK_MWVERSION) on {DATE} by {JSDUCK} {VERSION}." \
  29 --processes 0 --warnings-exit-nonzero \
  30 && echo 'JSDuck execution finished.' \
  31 && ln -s ../../resources $MWCORE_DIR/docs/js/modules