mediawiki-extensions-Visual.../bin/generateDocs.sh

#!/usr/bin/env bash
cd $(cd $(dirname $0)/..; pwd)

# Disable parallel processing which seems to be causing problems under Ruby 1.8
jsduck --config .docs/config.json --processes 0
ec=$?

test ! -L docs/lib && ln -s ../lib docs/lib || echo 'Symlink already exists'

cd - > /dev/null

# Exit with exit code of jsduck command
exit $ec
Add bin/ directory with updateStaticLoaders and generateDocs Adding a symlink in .docs/generate.sh because of Jenkins and possibly other uses. Change-Id: Ieb56852d0d0b978fbc1cbb873204d9e457cf969c 2013-10-22 21:51:51 +00:00			`#!/usr/bin/env bash`
			`cd $(cd $(dirname $0)/..; pwd)`

			`# Disable parallel processing which seems to be causing problems under Ruby 1.8`
docs: Remove JSDuck 4 support And migrate deprecated "-no_doc" option. Change-Id: I2e1e89408328c614a89f6c4e408df90d1e346d76 2014-04-29 18:20:49 +00:00			`jsduck --config .docs/config.json --processes 0`
Add bin/ directory with updateStaticLoaders and generateDocs Adding a symlink in .docs/generate.sh because of Jenkins and possibly other uses. Change-Id: Ieb56852d0d0b978fbc1cbb873204d9e457cf969c 2013-10-22 21:51:51 +00:00			`ec=$?`

jsduck: Fix script loading issues with eg-iframe in production It works locally because it can just nagivate to ../lib/ve. In production however we need docs/ to be standalone so that we can publish it without needing a subdirectory at: https://docs.wikimedia.org/VisualEditor/master/. For local usage this will be a symlink that still points to the sibling directory (but using a symlink instead of a ../ path). In production we can then instruct jenkins to replace that symlink with an actual copy of lib/. As long as the generated path references in the HTML remain the same. Follows-up 88c488887214, which broke the publication of the docs in Jenkins as it changed references from modules/ to ../modules/ for the eg-iframe. This works locally, but broke in Jenkins as it was relying on the copying of modules/ to docs/modules/ being enough to make it work). Change-Id: I10eaa5424d172932b29774a0f03d511d555fd121 2014-01-16 20:31:15 +00:00			`test ! -L docs/lib && ln -s ../lib docs/lib \|\| echo 'Symlink already exists'`

Add bin/ directory with updateStaticLoaders and generateDocs Adding a symlink in .docs/generate.sh because of Jenkins and possibly other uses. Change-Id: Ieb56852d0d0b978fbc1cbb873204d9e457cf969c 2013-10-22 21:51:51 +00:00			`cd - > /dev/null`

			`# Exit with exit code of jsduck command`
			`exit $ec`