mirror of
https://github.com/skoelle/moonweb-site.git
synced 2026-09-18 09:20:24 +00:00
stefankoelle
466df3bd04
- Migrate timecapsule (old www.moonweb.org) into monorepo as Eleventy 2.x site - Change all site URLs from subdomains to subdirectories under www.moonweb.org - Replace Cloudflare Pages deployment with IONOS SFTP - Update site-switcher, footer, and all internal links - Add merge script for combining all sites into single deployment - Update CI/CD workflow for IONOS SFTP deployment - Update stefankoelle.de references to use new URLs - Update AGENTS.md and README.md documentation
289 lines
11 KiB
Markdown
Executable File
289 lines
11 KiB
Markdown
Executable File
# moonweb-site
|
|
|
|
Monorepo for the **moonweb.org** homelab — six static sites built with [Eleventy](https://www.11ty.dev/), deployed to [IONOS SFTP](https://www.ionos.de/).
|
|
|
|
```
|
|
www.moonweb.org/ -> Central index & gateway
|
|
www.moonweb.org/infra/ -> Infrastructure overview (Proxmox, Synology, Docker)
|
|
www.moonweb.org/smarthome/ -> Smart home projects & dashboards
|
|
www.moonweb.org/code/ -> Curated GitHub project catalog
|
|
www.moonweb.org/retro/ -> Physical retro hardware collection
|
|
www.moonweb.org/timecapsule/ -> 2000s internet time capsule (retro design)
|
|
stefankoelle.de -> CV, career, personal site (LED Matrix docs)
|
|
```
|
|
|
|
> **Other sites** (not in this monorepo): [28k8.moonweb.org](https://28k8.moonweb.org) (90s BBS archive), [buildbroken.moonweb.org](https://buildbroken.moonweb.org) (.NET Open Space blog).
|
|
|
|
---
|
|
|
|
## Architecture
|
|
|
|
```
|
|
+-------------------------------------------------------------------+
|
|
| GitHub Actions CI |
|
|
| +-----------+ +------------+ +-------------+ +---------+ +------+ |
|
|
| | build:hub | |build:infra | | build:smart | | build:... | | build:timecapsule | |
|
|
| +-----+-----+ +-----+------+ +------+------+ +----+----+ +----+----+ +--------+ |
|
|
| | | | | | | |
|
|
| v v v v v v |
|
|
| dist/hub/ dist/infra/ dist/smarthome/ dist/.../ dist/timecapsule/ |
|
|
+--------+---------------------------------------------------+--------------------+
|
|
| |
|
|
v v
|
|
+------------------+ +------------------+
|
|
| IONOS SFTP | | IONOS SFTP |
|
|
| (www.moonweb.org)| | (stefankoelle.de)|
|
|
+--------+---------+ +--------+---------+
|
|
v v
|
|
www.moonweb.org/* stefankoelle.de
|
|
```
|
|
|
|
---
|
|
|
|
## Tech Stack
|
|
|
|
| Layer | Technology | Why |
|
|
|-------|-----------|-----|
|
|
| **SSG** | [Eleventy 3.1.6](https://www.11ty.dev/) | Markdown/YAML-first, minimal JS, `_data` folders map directly to aggregator output |
|
|
| **SSG (timecapsule)** | [Eleventy 2.0.1](https://www.11ty.dev/) | Legacy 2001 design, CommonJS config |
|
|
| **Templates** | [Nunjucks](https://mozilla.github.io/nunjucks/) | Shared `base.njk` layout with site-switcher header, `card-grid.njk` for index pages |
|
|
| **Styling** | Custom CSS (variables-based) | `base.css` for shared layout, `theme-*.css` per domain accent color |
|
|
| **Fonts** | [Lobster](https://fonts.google.com/specimen/Lobster) (Google Fonts) | Distinctive heading font across all sites |
|
|
| **CI/CD** | [GitHub Actions](https://github.com/features/actions) | Matrix build for all sites, artifact upload, merge step, parallel deploy |
|
|
| **Deploy** | IONOS SFTP | Static hosting via SFTP upload |
|
|
| **DNS** | Cloudflare | DNS management + redirects from old subdomains |
|
|
| **GitHub Catalog** | Python aggregator | Reads `.moonweb.yml` from each repo, outputs `repos.json` |
|
|
| **Runtime** | Fully static | No server-side code, no containers, no database |
|
|
|
|
---
|
|
|
|
## Local Development
|
|
|
|
```bash
|
|
npm install # install Eleventy + deps
|
|
cd timecapsule && npm install # timecapsule has own deps (Eleventy 2.x)
|
|
|
|
npm run dev:hub # http://localhost:8081
|
|
npm run dev:infra # http://localhost:8082
|
|
npm run dev:smarthome # http://localhost:8083
|
|
npm run dev:code # http://localhost:8084
|
|
npm run dev:retro # http://localhost:8085
|
|
npm run dev:stefankoelle # http://localhost:8086
|
|
npm run dev:timecapsule # http://localhost:8087
|
|
|
|
npm run dev # all 7 in parallel
|
|
```
|
|
|
|
Each site has its own minimal Eleventy config (`<site>/eleventy.config.js`). Live reload is built in.
|
|
|
|
### Build
|
|
|
|
```bash
|
|
npm run prebuild # pre-build tasks (CV PDF)
|
|
npm run build # builds all sites
|
|
npm run build:moonweb # builds moonweb sites only (excludes stefankoelle)
|
|
npm run build:hub # build single site
|
|
npm run merge:moonweb # merge all moonweb sites into dist/ for deployment
|
|
```
|
|
|
|
---
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
moonweb-site/
|
|
├── hub/ # Central index & gateway
|
|
├── infra/ # Infra overview + 8 detail pages
|
|
│ ├── backup-strategy/
|
|
│ ├── monitoring/
|
|
│ ├── dev-environment/
|
|
│ └── ...
|
|
├── smarthome/ # Smart home overview + 9 detail pages
|
|
│ ├── homematic-mqtt/
|
|
│ ├── tasmota-energy/
|
|
│ └── ...
|
|
├── code/ # GitHub catalog
|
|
│ └── _data/repos.json # populated by the aggregator
|
|
├── retro/ # Retro hardware + 13 detail pages
|
|
├── timecapsule/ # 2000s retro design (Eleventy 2.x)
|
|
│ ├── eleventy.config.js
|
|
│ ├── package.json
|
|
│ └── src/
|
|
├── stefankoelle/ # CV, career, personal site
|
|
│ ├── eleventy.config.js
|
|
│ ├── index.njk # Onepager (CV, Projects, Languages)
|
|
│ ├── cv-print.njk # CV-only for PDF generation
|
|
│ ├── ledmatrix/ # LED Matrix WebServer documentation
|
|
│ └── assets/ # CSS, JS, images, favicons
|
|
├── shared/ # Shared components
|
|
│ ├── _includes/
|
|
│ │ ├── base.njk # base layout (header, site-switcher, footer)
|
|
│ │ └── card-grid.njk # card-grid template with emoji support
|
|
│ ├── base.css # shared CSS (layout, cards, typography)
|
|
│ └── theme-*.css # accent colors per domain
|
|
├── scripts/
|
|
│ ├── github-aggregator/ # Python: reads .moonweb.yml -> repos.json
|
|
│ └── merge-moonweb.sh # Merge script for deployment
|
|
├── .github/workflows/
|
|
│ ├── build-deploy-moonweb.yml # CI/CD: build + deploy to IONOS SFTP
|
|
│ └── deploy-stefankoelle.yml # CI/CD: stefankoelle.de to IONOS SFTP
|
|
├── DESIGN.md # Initial concept
|
|
├── SPEC.md # Full specification
|
|
├── PLAN.md # Implementation plan
|
|
├── TODO.md # Open items & workflow
|
|
└── package.json # npm scripts for dev/build
|
|
```
|
|
|
|
---
|
|
|
|
## CI/CD Pipeline
|
|
|
|
### IONOS SFTP (www.moonweb.org)
|
|
|
|
Defined in `.github/workflows/build-deploy-moonweb.yml`:
|
|
|
|
```
|
|
push to main
|
|
|
|
|
+-- Build (matrix: hub, infra, smarthome, code, retro)
|
|
| +-- checkout -> setup-node (22) -> npm ci
|
|
| +-- npm run build:<site>
|
|
| +-- validate dist/<site>/ exists & non-empty
|
|
| +-- upload artifact (7-day retention)
|
|
|
|
|
+-- Build timecapsule
|
|
| +-- cd timecapsule && npm ci
|
|
| +-- npm run build:timecapsule
|
|
| +-- upload artifact
|
|
|
|
|
+-- Merge
|
|
| +-- download all artifacts
|
|
| +-- merge into dist/ (hub=root, others=subdirs)
|
|
| +-- upload merged artifact
|
|
|
|
|
+-- Deploy
|
|
+-- download merged artifact
|
|
+-- SFTP upload to IONOS /websites/moonweb/
|
|
```
|
|
|
|
**Required secrets:**
|
|
- `IONOS_SFTP_HOST`
|
|
- `IONOS_SFTP_USER`
|
|
- `IONOS_SFTP_PASSWORD`
|
|
|
|
### IONOS SFTP (stefankoelle.de)
|
|
|
|
Defined in `.github/workflows/deploy-stefankoelle.yml`:
|
|
|
|
```
|
|
push to main (paths: stefankoelle/**)
|
|
|
|
|
+-- Build stefankoelle
|
|
| +-- npm run build:stefankoelle
|
|
|
|
|
+-- Deploy via SFTP
|
|
+-- SFTP upload to IONOS /websites/stefankoelle/
|
|
```
|
|
|
|
**Required secrets:**
|
|
- `IONOS_SFTP_HOST`
|
|
- `IONOS_SFTP_USER`
|
|
- `IONOS_SFTP_PASSWORD`
|
|
|
|
---
|
|
|
|
## URL Structure
|
|
|
|
All moonweb.org sites are accessible under `www.moonweb.org` as subdirectories:
|
|
|
|
| URL | Content |
|
|
|-----|---------|
|
|
| `www.moonweb.org/` | Hub (root) |
|
|
| `www.moonweb.org/infra/` | Infrastructure |
|
|
| `www.moonweb.org/smarthome/` | Smart Home |
|
|
| `www.moonweb.org/code/` | Code catalog |
|
|
| `www.moonweb.org/retro/` | Retro hardware |
|
|
| `www.moonweb.org/timecapsule/` | 2000s time capsule |
|
|
| `www.moonweb.org/impressum/` | Legal notice |
|
|
|
|
Cloudflare redirects forward old subdomains:
|
|
- `hub.moonweb.org/*` -> `www.moonweb.org/*`
|
|
- `infra.moonweb.org/*` -> `www.moonweb.org/infra/*`
|
|
- `smarthome.moonweb.org/*` -> `www.moonweb.org/smarthome/*`
|
|
- `code.moonweb.org/*` -> `www.moonweb.org/code/*`
|
|
- `retro.moonweb.org/*` -> `www.moonweb.org/retro/*`
|
|
|
|
---
|
|
|
|
## GitHub Aggregator (www.moonweb.org/code/)
|
|
|
|
`scripts/github-aggregator/aggregate.py` automatically builds the project catalog:
|
|
|
|
1. Fetches all **public repos** from `skoelle` via GitHub API
|
|
2. Reads `.moonweb.yml` from each repo root
|
|
3. Filters for `category: code` entries
|
|
4. Sorts by subcategory + title
|
|
5. Writes combined result to `code/_data/repos.json`
|
|
|
|
### `.moonweb.yml` schema
|
|
|
|
```yaml
|
|
title: "MVG Departures"
|
|
category: code # code | smarthome | infra
|
|
subcategory: "Web Apps" # drives grouping on www.moonweb.org/code/
|
|
status: active
|
|
stack: [Python, FastAPI]
|
|
hosted_on: "Docker Host Debian (PVE)"
|
|
summary: "Compact MVG/S-Bahn departure monitor with configurable stations."
|
|
repo_url: "https://github.com/skoelle/mvg-departures"
|
|
```
|
|
|
|
### Manual run
|
|
|
|
```bash
|
|
export GITHUB_TOKEN=ghp_xxx
|
|
python scripts/github-aggregator/aggregate.py
|
|
```
|
|
|
|
---
|
|
|
|
## Content Rules
|
|
|
|
| Site | Detail pages? | Rule |
|
|
|------|--------------|------|
|
|
| smarthome | Yes | When enough content exists - no placeholder cards |
|
|
| infra | Rarely | Deliberately shallow - sensitive data (IPs, keys, passwords) stripped |
|
|
| code | Never | Overview cards + GitHub links only - no README duplication |
|
|
| retro | Minimal | Honest minimal overview, no over-investment |
|
|
| timecapsule | Static | 1:1 migration of original 2001 design, no changes |
|
|
|
|
**Infra redaction rule:** Architecture-level only (Proxmox, Synology, Docker, VLAN concept). No concrete IPs, WireGuard keys, passwords, internal hostnames.
|
|
|
|
---
|
|
|
|
## Language
|
|
|
|
All moonweb sites are written **entirely in English**. The timecapsule uses the original 2001 English content.
|
|
|
|
---
|
|
|
|
## Documentation
|
|
|
|
| File | Purpose |
|
|
|------|---------|
|
|
| `DESIGN.md` | Initial concept and design decisions |
|
|
| `SPEC.md` | Complete specification - what gets built |
|
|
| `PLAN.md` | Phased implementation plan |
|
|
| `TODO.md` | Open items, workflow, and current status |
|
|
| `README.md` | This file - project overview for GitHub |
|
|
|
|
---
|
|
|
|
## License
|
|
|
|
[](https://creativecommons.org/licenses/by-nc-sa/4.0/)
|
|
|
|
This work is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-nc-sa/4.0/).
|
|
|
|
See [LICENSE](LICENSE) for the full text.
|