Add Vercel for Continuous Documentation (#4872)

Changes in this PR:

- Add a script `ci/vercel-docs.sh` to build docs for Vercel
- Add Vercel configuration file `package.json`
- Update `CMakeLists.txt` to exclude `pacakge.json` and `vercel.json` in
  release tarballs

Author: seisman

CMakeLists.txt

@@ -112,8 +112,9 @@ if (GIT_FOUND AND HAVE_GIT_VERSION)
 		COMMAND ${CMAKE_COMMAND} -E remove_directory ${GMT_RELEASE_PREFIX}/admin
 		COMMAND ${CMAKE_COMMAND} -E remove_directory ${GMT_RELEASE_PREFIX}/ci
 		COMMAND ${CMAKE_COMMAND} -E remove_directory ${GMT_RELEASE_PREFIX}/test
-		COMMAND ${CMAKE_COMMAND} -E remove ${GMT_RELEASE_PREFIX}/.azure-pipelines.yml
 		COMMAND ${CMAKE_COMMAND} -E remove ${GMT_RELEASE_PREFIX}/.gitignore
+		COMMAND ${CMAKE_COMMAND} -E remove ${GMT_RELEASE_PREFIX}/package.json
+		COMMAND ${CMAKE_COMMAND} -E remove ${GMT_RELEASE_PREFIX}/vercel.json
 	)
 	add_depend_to_target (gmt_release git_export_release)
 	find_program (GNUTAR NAMES gnutar gtar tar)

ci/vercel-docs.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+#
+# Build the GMT documentation for Vercel.
+#
+
+set -x -e
+
+# Install GMT dependencies
+# Vercel uses Amazon Linux 2
+yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
+yum install cmake3 ninja-build libcurl-devel netcdf-devel
+pip install sphinx
+
+# Install latest gs
+curl -SLO https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs9533/ghostscript-9.53.3-linux-x86_64.tgz
+tar -xvf ghostscript-9.53.3-linux-x86_64.tgz ghostscript-9.53.3-linux-x86_64/gs-9533-linux-x86_64
+mv ghostscript-9.53.3-linux-x86_64/gs-9533-linux-x86_64 /usr/bin/gs
+gs --version
+
+# Following variables can be modified via environment variables
+GMT_INSTALL_DIR=${HOME}/gmt-install-dir
+
+# Configure GMT
+cat > cmake/ConfigUser.cmake << EOF
+set (CMAKE_INSTALL_PREFIX "${GMT_INSTALL_DIR}")
+set (CMAKE_C_FLAGS "-Wall -Wdeclaration-after-statement \${CMAKE_C_FLAGS}")
+set (CMAKE_C_FLAGS "-Wextra \${CMAKE_C_FLAGS}")
+EOF
+
+# Build and install GMT
+mkdir build
+cd build
+cmake3 .. -G Ninja
+cmake3 --build .
+cmake3 --build . --target docs_depends
+#cmake3 --build . --target optimize_images
+cmake3 --build . --target docs_html
+# cmake3 --build . --target docs_man
+# cmake3 --build . --target install
+cd ..
+
+mv build/doc/rst/html/ public/
+
+set -x -e

package.json

@@ -0,0 +1,6 @@
+{
+  "scripts": {
+    "build:docs": "curl https://raw.githubusercontent.com/GenericMappingTools/gmt/vercel-deployment/ci/vercel-docs.sh | bash",
+    "build": "npm run build:docs"
+  }
+}