blob: cd877cd88f1ccfb5220d88358f1c6981fcb198d2 (
plain) (
blame)
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
|
#!/usr/bin/env bash
set -eou pipefail
source "$(dirname "${BASH_SOURCE[0]}")/lib/log.sh"
readonly SITE="bolt.eugenetriguba.com"
readonly BUILD_DIR="site"
usage() {
echo "Usage: $0"
echo ""
echo "Build and deploy versioned documentation to SourceHut Pages"
echo ""
echo "Environment variables:"
echo " VERSION - The version to deploy (default: 'latest' for main branch)"
echo ""
echo "Examples:"
echo " $0 # Deploy as 'latest'"
echo " VERSION=v1.0.0 $0 # Deploy as 'v1.0.0'"
}
main() {
if [[ "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
usage
exit 0
fi
log_header "Deploying Documentation"
local version="${VERSION:-latest}"
log_info "Deploying version: $version"
fetch_existing_site
build_version "$version"
update_versions_manifest
package_site
deploy_to_pages "$version"
}
fetch_existing_site() {
log_step "Fetching existing site"
mkdir -p "$BUILD_DIR"
if hut pages download "$SITE" 2>/dev/null | tar -xzf - -C "$BUILD_DIR" 2>/dev/null; then
log_success "Existing site fetched"
else
log_info "No existing site found, starting fresh"
fi
}
build_version() {
local version="$1"
log_step "Building documentation for version: $version"
mkdocs build -d "$BUILD_DIR/$version"
# If latest, also copy to root for default view
if [[ "$version" == "latest" ]]; then
log_step "Copying latest to root"
rsync -a --delete "$BUILD_DIR/latest/" "$BUILD_DIR/" \
--exclude="versions.json" \
--exclude="v*" \
--exclude="latest"
fi
log_success "Documentation built for $version"
}
update_versions_manifest() {
log_step "Updating versions manifest"
# Build array of versions using jq
local versions_json="[]"
# Add 'latest' if it exists
if [[ -d "$BUILD_DIR/latest" ]]; then
versions_json=$(echo "$versions_json" | jq '. += [{"version": "latest", "title": "Latest (Development)"}]')
fi
# Add all tagged versions (sorted in reverse)
if compgen -G "$BUILD_DIR/v*" > /dev/null; then
for dir in $(find "$BUILD_DIR" -maxdepth 1 -type d -name "v*" | sort -Vr); do
local ver=$(basename "$dir")
versions_json=$(echo "$versions_json" | jq --arg v "$ver" '. += [{"version": $v, "title": $v}]')
done
fi
# Create final JSON structure
jq -n --argjson versions "$versions_json" '{"versions": $versions}' > "$BUILD_DIR/versions.json"
local version_count=$(echo "$versions_json" | jq 'length')
log_success "Versions manifest updated with $version_count version(s)"
}
package_site() {
log_step "Creating tarball"
tar -C "$BUILD_DIR" -czf site.tar.gz .
log_success "Site packaged as site.tar.gz"
}
deploy_to_pages() {
local version="$1"
log_step "Deploying to SourceHut Pages: $SITE"
hut pages publish -d "$SITE" site.tar.gz
log_success "Documentation deployed to https://$SITE"
log_info "Version URL: https://$SITE/$version/"
}
main "$@"
|