jarvis-at-skic
9ad62a2ed6
Build and publish Eldorado documentation / build (pull_request) Successful in 29s
40 lines
1.8 KiB
Markdown
40 lines
1.8 KiB
Markdown
---
|
||
title: Site configuration reference
|
||
description: Look up source locations, tool versions, styling choices, and publication settings.
|
||
slug: /reference
|
||
---
|
||
|
||
## Repository layout
|
||
|
||
| Path | Responsibility |
|
||
| --- | --- |
|
||
| `docs/` | Documentation Markdown |
|
||
| `src/pages/index.tsx` | Homepage |
|
||
| `src/css/custom.css` | Eldorado-inspired theme |
|
||
| `static/img/docs-mark.svg` | Original documentation icon |
|
||
| `docusaurus.config.ts` | Routes, metadata, navigation, and search |
|
||
| `sidebars.ts` | Documentation navigation |
|
||
| `scripts/verify.mjs` | Source and built-output contract checks |
|
||
| `.gitea/workflows/pages.yml` | Validation and Pages publication |
|
||
|
||
## Runtime and publication
|
||
|
||
| Setting | Value |
|
||
| --- | --- |
|
||
| Framework | Docusaurus 3.10.2 |
|
||
| Node.js | 22 or later; CI uses 22 |
|
||
| Package manager | pnpm 10.15.1 |
|
||
| Base path | `/eldorado-v1/documentation/` |
|
||
| Repository | `eldorado-v1/documentation` (private) |
|
||
| Publication branch | `main` |
|
||
| Pages mount | `/gondor-v1-gitea-pages` |
|
||
| Search | Local build-generated index; no external search service |
|
||
|
||
## Visual reference
|
||
|
||
The theme adapts [Eldorado’s website](https://www.eldorado.gg/): near-black navigation, charcoal surfaces, gold `#ffc950` accents, light `#f6f6f6` backgrounds, and Lato type. Gold buttons use dark text; light-mode text links use a darker gold for contrast. Fonts are bundled locally.
|
||
|
||
The documentation uses original page artwork and a document icon, not marketplace imagery, commercial copy, or the official logo. Square panels follow the workspace’s existing design preference. This is a documentation workspace, not the public Eldorado marketplace.
|
||
|
||
The publication workflow follows the persistent-mount pattern in [corp-v1/portal](https://gitea.lego-cloud.eu/corp-v1/portal/src/branch/main/.gitea/workflows/pages.yml).
|