mAi
a221367c46
Architektur: - shared/theme.js — Logik (data-theme attr auf <html>, localStorage, prefers-color-scheme fallback, data-theme-lock opt-out) - shared/toggles.js — fixed top-right Pill mit Sun/Moon SVG + DE/EN Button (auto-injected, hängt sich an i18n.js's [data-i18n-toggle] Pattern) - shared/css/theme.css — neutrale Light-Defaults (cream bg, AA-konforme grays) - templates/base.html — Anti-FOUC inline IIFE im <head>, theme.css linked vor inline <style>, scripts in body - tools/contrast-audit.py — neue --light/--dark/--both Modi, parsed [data-theme="light"] + shared fallback Pilot auf 4 Sites: - ichbinotto.de (Octopus rot/teal) - paragraphenraiter.de (Gold) - kilitaer.de (Olive) - deinesei.de (Indigo) Audit-Ergebnis: - Dark mode: 0/59 Verstöße (regression-frei) - Light mode: 14/59 Sites brauchen per-site overrides für sub-AA Akzent-Vars (Shift-2 follow-up) Out of Scope (Shift-2): - Rollout auf restliche 55 Sites - Per-Site Light-Palette-Verfeinerung wo neutral-Default nicht trägt - Per-Site Opt-Out (data-theme-lock) für aesthetisch dark-only Satire-Sites Design-Doc: docs/plans/theme-toggle.md
onepager
Mono-repo for 40+ vanity domain onepager sites. Single nginx container with template system and server_name-based routing.
Structure
sites/ # One folder per domain
example.de/
site.yaml # Domain config, template choice, variables
index.html # Content (generated or hand-crafted)
assets/ # Optional images, fonts
templates/ # Shared HTML templates
shared/css/ # Shared CSS (variables, responsive, animations)
nginx/ # Generated nginx.conf + generator script
build/ # Generated output (gitignored)
Usage
Add a new site
# Templated site
./add-site.sh example.de --template person-dark --name "Max Mustermann"
# Custom HTML site
./add-site.sh example.de --template custom
Build
./build.sh # build + anti-AI text lint
./build.sh --skip-lint # build only (emergencies)
Requires yq for YAML parsing and python3 for the lint step. Outputs to build/.
Anti-AI text lint
Every build runs tools/anti-ai-lint.py against build/<domain>/index.html,
flagging text fingerprints typical of LLM-generated content (vocab and structure
patterns from tools/anti-ai-blacklist.yaml). Severity warn prints a message;
fail aborts the build.
Whitelist a hit:
- HTML comment in the affected page:
<!-- anti-ai-allow: revolutionär, em-dash-3-bullet --> - Per-site override in
site.yaml:anti_ai_allow: - revolutionär - em-dash-3-bullet
The blacklist source is docs/geo-seo-guideline.md §3.6. Test the linter with
tools/test-anti-ai-lint.sh.
Deploy
Push to main — Dokploy auto-deploys. All domains must be configured in Dokploy.
Templates
| Template | Description |
|---|---|
person-dark |
Professional profile, dark theme |
person-light |
Professional profile, light/cream theme |
product-dark |
Product/service landing page, dark |
editorial |
Long-form manifesto/editorial style |
fun |
Playful/personal pages |
minimal |
Bare-bones single section |
custom |
Hand-crafted HTML, no rendering |
site.yaml
domain: example.de
aliases: [www.example.de]
template: person-dark
title: "Page Title"
description: "Meta description"
lang: de
vars:
name: "Name"
role: "Role"
initials: "AB"
tagline: "Tagline here"
accent: "#c9a84c"
accent_light: "rgba(201, 168, 76, 0.1)"
font_primary: "Inter"
font_secondary: "Newsreader"
tags: ["Tag 1", "Tag 2"]
sections:
- type: features
title: "Section Title"
items:
- title: "Item"
desc: "Description"
- type: profile
bio: "Bio text"
cta:
text: "Contact"
href: "mailto:info@example.de"
schema:
type: Person
name: "Erika Mustermann"
url: "https://example.de/"
jobTitle: "Patentanwältin"
sameAs:
- https://www.linkedin.com/in/erika-mustermann/
- https://github.com/erika-mustermann
Schema.org / JSON-LD (GEO/SEO)
Templated sites can declare a schema: block in site.yaml. render.sh emits it as <script type="application/ld+json">…</script> inside <head> (slot {{schema_jsonld}} in templates/base.html). See docs/geo-seo-guideline.md §3.3 for rationale.
Conventions
schema.type→@type(the YAML key istype, the rendered key is@type).@context: https://schema.orgis added automatically.- Nested objects use the JSON-LD form directly: write
"@type": Organization(quoted because of the@). - Array fields like
sameAs:are passed through as JSON arrays. - If
schema:is absent, no<script>tag is emitted (empty slot). - If
schema.typeis omitted, the template default applies:person-dark,person-light→Personproduct-dark→Producteditorial→Articlefun,minimal→ no default (settype:explicitly).
Supported types include Person, Organization, Article, Product, FAQPage, LocalBusiness. Schema.org accepts any type — these are just the ones we use most.
Custom sites
template: custom skips rendering, so the slot is not applied. Hand-craft the JSON-LD directly inside index.html — typically right before </head>.
Testing
./tests/schema-test.sh
Renders fixture files in tests/fixtures/ and validates that JSON-LD is well-formed, has the correct @context/@type, and that sites without schema: produce no script tag.
For Schema.org-validator checks (recommended for any new live site that uses the slot), paste the rendered <script type="application/ld+json"> block into https://validator.schema.org/.
Related
- Issue #341: Onepager Mono-Repo
- Issue #335: Container consolidation