Wie diese Website gebaut ist

Diese ganze Seite ist mit Nera gebaut. Nichts hier ist ein Sonderfall — es ist derselbe Generator und dieselben öffentlichen Plugins, die du installieren würdest. Hier ist das vollständige Rezept.

Wie jede Seite aufgesetzt

Es begann mit der nera-CLI, die eine Website erstellt, die von der @nera-static/core-Engine abhängt:

npx @nera-static/nera new nera-website

Sieben Plugins, jedes mit einer Aufgabe

Plugin Aufgabe Konfiguration
plugin-navigation Kopf- + Fußzeilenmenüs mit Aktiv-Zuständen config/navigation.yaml
plugin-tags Tutorial-Tags + /tutorials/tags/*-Seiten je Sprache config/tags.yaml
plugin-search Clientseitiger Suchindex + Box je Sprache config/search.yaml
plugin-page-pagination Zurück/Weiter in Docs und Tutorials config/page-pagination.yaml
plugin-canonical-links Canonical-<link>-Tags für SEO config/canonical-links.yaml
plugin-link-attributes Externe Links öffnen in einem neuen Tab config/link-attributes.yaml
tutorials-list (lokal) Baut app.tutorials für den Index —

Jedes hat in diesem Bereich sein eigenes Tutorial, falls du die Details möchtest.

Reihenfolge zählt — die Suche läuft zuletzt

Die Suche baut ihren Index aus dem Endzustand jeder Seite, also muss sie nach allem anderen laufen. config/plugin-order.yaml legt das fest:

plugin-order:
    - end:
          - plugin-search

Alles andere läuft dazwischen alphabetisch. Dies ist die eine Stelle, an der die Plugin-Reihenfolge auf dieser Seite tragend ist.

Templates, die uns gehören

Plugins, die Views mitliefern, wurden mit Befehlen wie npx nera-navigation nach views/vendor/ veröffentlicht. Diese Kopien gehören uns zum Bearbeiten und Gestalten — nichts Wichtiges ist in node_modules versteckt.

Inhalt ist einfach Markdown

Jede Seite, die du liest, ist eine Markdown-Datei unter pages/ mit einem layout in ihrem Frontmatter. Die Docs sind pages/docs/*.md; dieses Tutorial ist pages/tutorials/how-this-site-is-built.md. Ordner werden zu URLs; es existiert keine Routing-Konfiguration.

Bauen

npm run build   # pages/ -> public/

Das ist der gesamte Stack: Markdown rein, statisches HTML raus, Plugins für den Rest. Wenn du die anderen Tutorials in diesem Bereich gelesen hast, hast du jetzt jedes Teil davon einzeln gesehen — dies ist einfach alles zusammen.