Setup a static website

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
#!/bin/bash
#
# this hook runs giblish on a document tree according to the 
# users settings.
# Typically used to publish html documents when a push to a matching
# branch is detected.

# the git refs that should trigger a doc generation at update
TRIGGERING_REFS_REGEX=$'main'

# the relative path to a subfolder in the repo where the docs are
REPO_DOC_SUBFOLDER="docs"

# the staging repo root (where the working tree exists)
STAGING_REPO="/usr/local/git_staging/rillbert_se_staging"

# The web-server top dir for the published documents
DST_DIR="/var/www/rillbert_se/html/public/docs"

# path to a top dir of the styling css and other resources
RESOURCE_DIR="scripts/resources"

# the name of the css file to use for styling, without the 'css' extension
LAYOUT_STYLE="giblish"

# "true" runs an 'rm -rf' of the destination dir before generating new htmls
CLEAR_DST="true"

echo "post-receive hook running..."

# read the input that git sends to this hook
read oldrev newrev ref

# remove the 'refs/heads/' prefix from the git ref
ref="${ref/refs\/heads\//}"

# filter out refs that are irrelevant for doc generation
if [[ ! "${ref}" =~ "${TRIGGERING_REFS_REGEX}" ]]; then
  echo "Ref '${ref}' received. Doing nothing: only refs matching the regex: /${TRIGGERING_REFS_REGEX}/ will trigger a doc generation."
  exit 0
fi

echo "Document generation triggered by an update to ${ref}."
echo ""

# use a subshell with the correct working dir for the actual doc generation
(
  cd "${STAGING_REPO}"

  # need to unset the GIT_DIR env set by the invoking hook for giblish to work correctly
  unset GIT_DIR

  if [[ "${CLEAR_DST}" -eq "true" ]]; then
    echo "Remove everything under ${DST_DIR}/"
    rm -rf ${DST_DIR}/*
  fi

  # Generate html docs
  echo "running giblish..."
  giblish -a xrefstyle=basic \
          --copy-asset-folders "_assets$" \
          -g "${TRIGGERING_REFS_REGEX}" \
          -r "${RESOURCE_DIR}" \
          -s "${LAYOUT_STYLE}" \
          "${REPO_DOC_SUBFOLDER}" "${DST_DIR}"
)