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.