[PR] feat: migrate documentation site to OINK 1.0 [hugegraph-doc]

["imbajin (via GitHub)" <gi...@apache.org>]

imbajin opened a new pull request, #466:
URL: https://github.com/apache/hugegraph-doc/pull/466

   ## Before → after
   
   | Before | After |
   | --- | --- |
   | Docsy shell tied to Hugo 0.95 and Node/PostCSS | OINK `v1.0.0` pinned with Hugo Extended `0.165.0` and Go `1.27` |
   | One mutable site build | One central shell rendering `latest`, `1.7`, and `1.5` from exact resolved commits |
   | Version history was not published as an isolated contract | Latest stays at `/`; archived Docs/Download live below `/versions/1.7/` and `/versions/1.5/` |
   | Local production-shape build only | Independent production and ASF-staging builds, strict artifact validation, then collision-safe aggregation |
   
   ```mermaid
   flowchart LR
     A[prepare manifest] --> B[resolve exact SHAs]
     B --> C[3 versions × 2 origins]
     C --> D[strict build + artifact validator]
     D --> E[required deploy aggregate]
     E --> F[production artifact]
     E --> G[ASF staging artifact]
     F --> H[asf-site only after reviewed master push]
   ```
   
   ## What changed
   
   - replace the Docsy shell with the pinned OINK module and migrate bilingual landing, navigation, footer, search, print, machine-readable outputs, 404, and legacy details content;
   - add a fail-closed version manifest and central renderer for `latest`, `1.7`, and `1.5`, including exact-SHA provenance and version-aware GitHub actions;
   - scope search, canonical, hreflang, LLMS, NAVJSON, assets, and links to the correct origin, language, and version;
   - preserve latest-only Home/Blog/Community/About/client-go surfaces while historical snapshots contain Docs/Download only;
   - keep the required `deploy` status, pin every Action to a commit SHA, publish reviewed production output only from `master`, and retain `asf-site` history.
   
   ## Resolved sources
   
   | Version | Source |
   | --- | --- |
   | latest | `e2428ca451ed71818a0f5119a676aa1216ba8ad7` |
   | 1.7 | `a036f550bf412ea2950271390888d63bbffef6ba` |
   | 1.5 | `34bbc87147f60db49888b2ce718cc051973c943e` |
   
   Historical release branches intentionally remain maintainable. Each workflow run resolves them once and carries the immutable result through build and aggregation.
   
   ## Live visual and runtime evidence
   
   - Before: [current production](https://hugegraph.apache.org/)
   - After: [OINK ASF preview](https://hugegraph-oink.staged.apache.org/)
   - Bilingual: [Chinese](https://hugegraph-oink.staged.apache.org/cn/)
   - Versions: [1.7](https://hugegraph-oink.staged.apache.org/versions/1.7/docs/) · [1.5](https://hugegraph-oink.staged.apache.org/versions/1.5/docs/)
   
   The first live publish exposed Apache's reserved root `/icons/` alias. The site logo was moved to `/img/logo.svg`; the final ASF preview now serves root and versioned logos with `200 image/svg+xml`.
   
   ## Verification
   
   - six clean strict Hugo builds: 3 versions × production/staging origins, zero warnings;
   - two clean aggregates, each with 2,229 version files plus ASF/build metadata;
   - URL contract: 24 latest routes and 17 routes per historical version;
   - 12 unit/integration tests covering manifest drift, SHA mismatch, unsafe URLs, staging-origin rewriting, scoped URLs, and safe output cleanup;
   - source link validation, Ruff, Actionlint, JSON validation, and diff checks pass;
   - exact canonical/hreflang, NAVJSON/LLMS/search isolation, search MD5, licenses, assistant boundary, archive notices, 404 shell, and aggregate collisions are validated;
   - ASF DNS/TLS/headers/CSP, representative routes/assets, `HStore` and Chinese `配置` search, language/version switching, 404, light/dark themes, and 390×844 layout were tested in a real browser; no warning/error console logs were captured.
   
   Three independent read-only review lanes (correctness, design/deployment, and security) completed the final delta with no actionable findings.
   
   ## Rollback and exclusions
   
   - `asf-site` was not modified during migration or staging; its preserved head is `4c9cb819bf5277982a5b2dacfe9b788924e3e940`.
   - Existing `asf-staging` was not overwritten; the isolated preview is generated from `asf-staging-oink`.
   - Source rollback is a normal revert of this PR; generated preview history retains both the initial artifact and the hosted-path fix.
   - Route-aware same-page version switching, EOL-wide `noindex`, broad IA rewriting, and a Redoc PoC remain outside this first migration.
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@hugegraph.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@hugegraph.apache.org
For additional commands, e-mail: issues-help@hugegraph.apache.org

Re: [PR] BREAKING CHANGE: migrate site from docsy to OINK 1.0 [hugegraph-doc]

["imbajin (via GitHub)" <gi...@apache.org>]

imbajin merged PR #466:
URL: https://github.com/apache/hugegraph-doc/pull/466


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@hugegraph.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@hugegraph.apache.org
For additional commands, e-mail: issues-help@hugegraph.apache.org