Add Forgejo Action to publish FenLiu docs to grebedoc.dev #67

New issue

Closed

opened 2026-07-04 04:38:14 +00:00 by coding-agent-marvin8 · 1 comment

coding-agent-marvin8 commented

2026-07-04 04:38:14 +00:00

(Migrated from codeberg.org)

Problem

The FenLiu documentation is currently only published to Codeberg Pages via the Woodpecker CI pipeline (.woodpecker/fenliu-docs.yml). There is no CI path to publish it to the new canonical docs domain at https://fenliu.marvin.zone, which is hosted by grebedoc.dev.

Proposed fix

Add .forgejo/workflows/fenliu-docs.yml that triggers on fenliu-* tags.
The workflow builds the docs with uv run mkdocs build (plain, unversioned — grebedoc serves the latest).
The built site/ directory is packed into a .tar.gz archive and uploaded to https://fenliu.marvin.zone/ via the grebedoc HTTP archive API (PUT with Content-Type: application/x-tar+gzip and Authorization: Pages $TOKEN).
Update mkdocs.yml site_url from the Codeberg Pages URL to https://fenliu.marvin.zone/.
The existing Woodpecker versioned-docs pipeline is left in place as a secondary deployment.

DNS setup (user action)

Marvin8 will add the DNS records required by grebedoc's Method B challenge authentication and the GREBEDOC_FENLIU_TOKEN secret in Codeberg.

## Problem The FenLiu documentation is currently only published to Codeberg Pages via the Woodpecker CI pipeline (`.woodpecker/fenliu-docs.yml`). There is no CI path to publish it to the new canonical docs domain at `https://fenliu.marvin.zone`, which is hosted by grebedoc.dev. ## Proposed fix - Add `.forgejo/workflows/fenliu-docs.yml` that triggers on `fenliu-*` tags. - The workflow builds the docs with `uv run mkdocs build` (plain, unversioned — grebedoc serves the latest). - The built `site/` directory is packed into a `.tar.gz` archive and uploaded to `https://fenliu.marvin.zone/` via the grebedoc HTTP archive API (`PUT` with `Content-Type: application/x-tar+gzip` and `Authorization: Pages $TOKEN`). - Update `mkdocs.yml` `site_url` from the Codeberg Pages URL to `https://fenliu.marvin.zone/`. - The existing Woodpecker versioned-docs pipeline is left in place as a secondary deployment. ## DNS setup (user action) Marvin8 will add the DNS records required by grebedoc's Method B challenge authentication and the `GREBEDOC_FENLIU_TOKEN` secret in Codeberg.

coding-agent-marvin8 commented

2026-07-04 04:38:33 +00:00

(Migrated from codeberg.org)

Plan

Checking the wuming project as a template for the grebedoc deployment step, then will finalize the workflow.

Key files:

.forgejo/workflows/fenliu-docs.yml (new)
packages/fenliu/mkdocs.yml (update site_url)

Commits planned:

:construction_worker: add Forgejo Action to publish fenliu docs to grebedoc
:memo: update mkdocs site_url to fenliu.marvin.zone

## Plan Checking the `wuming` project as a template for the grebedoc deployment step, then will finalize the workflow. **Key files:** - `.forgejo/workflows/fenliu-docs.yml` (new) - `packages/fenliu/mkdocs.yml` (update `site_url`) **Commits planned:** 1. `:construction_worker:` add Forgejo Action to publish fenliu docs to grebedoc 2. `:memo:` update mkdocs site_url to fenliu.marvin.zone

No labels

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

marvin8/dujiangyan#67

No description provided.

Rows
Columns