From c500a84b35338ac0f429133a0b07ced8d457976f Mon Sep 17 00:00:00 2001 From: Eugene Triguba Date: Fri, 10 Oct 2025 23:11:16 -0400 Subject: Refactor docs to use mkdocs and sourcehut pages --- scripts/deploy-docs.sh | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100755 scripts/deploy-docs.sh (limited to 'scripts') diff --git a/scripts/deploy-docs.sh b/scripts/deploy-docs.sh new file mode 100755 index 0000000..c56bc5b --- /dev/null +++ b/scripts/deploy-docs.sh @@ -0,0 +1,47 @@ +#!/usr/bin/env bash +set -eou pipefail + +source "$(dirname "${BASH_SOURCE[0]}")/lib/log.sh" + +readonly SITE="eugenetriguba.srht.site/bolt" + +usage() { + echo "Usage: $0" + echo "" + echo "Build and deploy documentation to SourceHut Pages" + echo "" + echo "Examples:" + echo " $0 # Build and deploy docs to $SITE" +} + +build_docs() { + log_step "Building documentation with MkDocs" + mkdocs build + log_success "Documentation built successfully" +} + +package_site() { + log_step "Creating tarball" + tar -C site -czf site.tar.gz . + log_success "Site packaged as site.tar.gz" +} + +deploy_to_pages() { + log_step "Deploying to SourceHut Pages: $SITE" + hut pages publish -d "$SITE" site.tar.gz + log_success "Documentation deployed to https://$SITE" +} + +main() { + if [[ "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then + usage + exit 0 + fi + + log_header "Deploying Documentation" + build_docs + package_site + deploy_to_pages +} + +main "$@" -- cgit v1.2.3