forked from boostorg/website-v2-docs
-
Notifications
You must be signed in to change notification settings - Fork 0
/
libdoc.sh
executable file
·127 lines (115 loc) · 3.71 KB
/
libdoc.sh
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
#!/bin/sh
#
# Copyright (c) 2024 The C++ Alliance, Inc. (https://cppalliance.org)
#
# Distributed under the Boost Software License, Version 1.0. (See accompanying
# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
#
# Official repository: https://github.com/boostorg/website-v2-docs
#
# This script is used to build the Antora-based
# documentation for Boost libraries and for the
# versioned site documentation such as the
# User's Guide.
#
if [ $# -eq 0 ]; then
echo "Usage: $0 { branch | version | 'release' | 'all' }..."
echo
echo " branch : 'develop' | 'master' | 'release'"
echo " version: [0-9]+ '.' [0-9]+ '.' [0-9]+"
echo " 'release': builds master to build/doc/html"
echo " 'all': rebuilds develop, master, and every version"
echo
echo "Examples:"
echo
echo " $0 develop master # build develop and master"
echo " $0 1.83.0 # build tagged version boost-1.83.0"
exit 2
fi
# Check if node and npx are available
node_version=$(node --version 2>/dev/null)
if [ -z "$node_version" ]; then
echo "Node.js is not installed"
exit 1
fi
major_version=$(echo $node_version | egrep -o "v([0-9]+)\." | cut -c 2- | rev | cut -c 2- | rev)
if [ "$major_version" -lt "16" ]; then
echo "Node.js version $node_version is not supported. Please upgrade to version 16 or higher."
node_path=$(which node)
echo "node_path=${node_path}"
fi
antora_version=$(antora --version 2>/dev/null)
if [ -n "$antora_version" ]; then
ANTORA_CMD='antora'
else
npx_version=$(npx --version 2>/dev/null)
if [ -z "$npx_version" ]; then
echo "Neither antora nor npx are installed"
exit 1
else
ANTORA_CMD='npx antora'
fi
fi
cwd=$(pwd)
script_dir=$(dirname "$(readlink -f "$0")")
if ! [ -e "$script_dir/antora-ui/build/ui-bundle.zip" ]; then
cd "$script_dir/antora-ui" || exit
./build.sh
cd "$cwd" || exit
fi
if command -v git >/dev/null && git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
commit_id=$(git rev-parse HEAD)
commit_id=$(expr substr "$commit_id" 1 7)
else
commit_id=""
fi
if [ ! -d "node_modules" ] || [ "$(find package.json -prune -printf '%T@\n' | cut -d . -f 1)" -gt "$(find node_modules -prune -printf '%T@\n' | cut -d . -f 1)" ]; then
npm ci
fi
# Run antora command
while test $# -gt 0; do
if [ "$1" = "develop" ] || [ "$1" = "master" ]; then
$ANTORA_CMD --fetch \
--attribute page-boost-branch=$1 \
--attribute page-boost-ui-branch=$1 \
--attribute page-commit-id="$commit_id" \
libs.playbook.yml
elif [ "$1" = "release" ]; then
$ANTORA_CMD --fetch \
--attribute page-boost-branch=master \
--attribute page-boost-ui-branch=master \
--attribute page-commit-id="$commit_id" \
--attribute page-boost-is-release=true \
libs.playbook.yml
elif echo "$1" | grep -Eq '^[0-9]+\.[0-9]+\.[0-9]+$'; then
f="./history/libs.$1.playbook.yml"
if [ -f "$f" ]; then
echo "Building playbook $f"
$ANTORA_CMD --fetch \
--attribute page-boost-branch=$1 \
--attribute page-boost-ui-branch=master \
--attribute page-commit-id="$commit_id" \
"$f"
else
echo "Playbook \"$f\" does not exist"
fi
elif [ "$1" = "all" ]; then
for f in ./history/*.yml; do
echo "Building playbook $f"
$ANTORA_CMD --fetch \
--attribute page-boost-branch=$branch \
--attribute page-boost-ui-branch=$branch \
"$f"
done
for branch in master develop; do
echo "Building playbook libs.playbook.yml for $branch branch"
$ANTORA_CMD --fetch \
--attribute page-boost-branch=$branch \
--attribute page-boost-ui-branch=$branch \
libs.playbook.yml
done
else
echo "invalid argument: '$1'"
fi
shift
done