mirror of
https://gitea.com/gitea/docs.git
synced 2026-11-05 17:45:46 +00:00
bircni
55c3a392a1
update_cli_docs.sh runs gt's own generator and lays the pages out for the site: one directory per command group, front matter, titles, sidebar order, fenced help text and rewritten links. --released succeeds while no series is documented. A weekly workflow proposes updates like the runner's. Signed-off-by: bircni <[email protected]>
112 lines
3.4 KiB
Makefile
112 lines
3.4 KiB
Makefile
GITEA_AWESOME_REMOTE := https://gitea.com/gitea/awesome-gitea.git
|
|
GITEA_AWESOME_BRANCH := main
|
|
|
|
.PHONY: all
|
|
all: build
|
|
|
|
.PHONY: create_dir
|
|
create_dir:
|
|
mkdir -p .tmp
|
|
|
|
.PHONY: clone_awesome
|
|
clone_awesome: create_dir
|
|
git clone --branch=$(GITEA_AWESOME_BRANCH) $(GITEA_AWESOME_REMOTE) .tmp/upstream-awesome || true
|
|
|
|
# the contributing guide moved to the gitea repository, the readme of
|
|
# awesome-gitea still links to it with a relative path
|
|
AWESOME_CONTRIBUTING_URL := https://github.com/go-gitea/gitea/blob/main/CONTRIBUTING.md
|
|
FIX_AWESOME_LINKS := sed 's|](contributing.md)|]($(AWESOME_CONTRIBUTING_URL))|'
|
|
|
|
.PHONY: prepare-awesome-latest
|
|
prepare-awesome-latest: clone_awesome
|
|
$(FIX_AWESOME_LINKS) .tmp/upstream-awesome/README.md > docs/awesome.md
|
|
|
|
.PHONY: prepare-awesome\#%
|
|
prepare-awesome\#%:
|
|
$(FIX_AWESOME_LINKS) .tmp/upstream-awesome/README.md > versioned_docs/version-1.$*/awesome.md
|
|
|
|
# versions numbered without the 1. prefix, like 28
|
|
.PHONY: prepare-awesome-v%
|
|
prepare-awesome-v%:
|
|
$(FIX_AWESOME_LINKS) .tmp/upstream-awesome/README.md > versioned_docs/version-$*/awesome.md
|
|
|
|
.PHONY: install
|
|
install:
|
|
pnpm install
|
|
|
|
.PHONY: prepare-docs
|
|
prepare-docs: install prepare-awesome-latest prepare-awesome\#22 prepare-awesome\#23 prepare-awesome\#24 prepare-awesome\#25 prepare-awesome\#26 prepare-awesome\#27 prepare-awesome-v28
|
|
|
|
.PHONY: build
|
|
build:
|
|
pnpm run build
|
|
|
|
# type checks the astro site and its components
|
|
.PHONY: check
|
|
check:
|
|
pnpm run check
|
|
|
|
.PHONY: serve
|
|
serve: prepare-docs
|
|
pnpm run dev
|
|
|
|
# only the english docs of the version served at the root, plus the runner:
|
|
# starts in a few seconds instead of loading the whole matrix
|
|
.PHONY: serve-fast
|
|
serve-fast:
|
|
pnpm run dev:en-latest
|
|
|
|
# search is built by pagefind at build time, so it is only available on the
|
|
# built site; this serves it locally
|
|
.PHONY: serve-built
|
|
serve-built: build
|
|
pnpm run preview
|
|
|
|
.PHONY: clean
|
|
clean:
|
|
rm -rf .tmp
|
|
rm -rf sites/docs/dist
|
|
rm -rf sites/docs/.cache
|
|
rm -rf sites/docs/node_modules/.astro
|
|
|
|
# static/swagger-*.json and static/openapi3-*.json are committed files, use
|
|
# update-api-docs to refresh them
|
|
.PHONY: update-api-docs
|
|
update-api-docs:
|
|
./update_api_docs.sh
|
|
|
|
# only refresh the documents of the gitea main branch (used by the cron job)
|
|
.PHONY: update-api-docs-latest
|
|
update-api-docs-latest:
|
|
./update_api_docs.sh --latest-only
|
|
|
|
# regenerate the generated runner reference pages of the develop docs from the
|
|
# main branch of gitea/runner (used by the update runner reference cron job)
|
|
.PHONY: update-runner-docs
|
|
update-runner-docs:
|
|
./update_runner_docs.sh main runner-docs/reference
|
|
|
|
# same, for every documented release series: the tags are looked up through the
|
|
# Gitea API, so a runner release needs no change here
|
|
.PHONY: update-runner-docs-released
|
|
update-runner-docs-released:
|
|
./update_runner_docs.sh --released
|
|
|
|
# regenerate the generated gt reference pages of the develop docs from the main
|
|
# branch of gitea/cli (used by the update cli reference cron job)
|
|
.PHONY: update-cli-docs
|
|
update-cli-docs:
|
|
./update_cli_docs.sh main cli-docs/reference
|
|
|
|
# same, for every documented release series; succeeds without any
|
|
.PHONY: update-cli-docs-released
|
|
update-cli-docs-released:
|
|
./update_cli_docs.sh --released
|
|
|
|
# freezes the current docs, runner or cli tree as a new version, see
|
|
# scripts/cut-version.mjs
|
|
.PHONY: cut-version
|
|
cut-version:
|
|
@test -n "$(PRODUCT)" -a -n "$(VERSION)" || { echo 'usage: make cut-version PRODUCT=docs VERSION=1.28'; exit 1; }
|
|
node scripts/cut-version.mjs $(PRODUCT) $(VERSION)
|