DokuKonventionen und Konzepte
Glossar
Die in diesen Dokumenten verwendeten Wörter, jeweils eine Zeile, in alphabetischer Reihenfolge. Ein Begriff, der mehr als eine Zeile benötigt, hat eine Seite: Folgen Sie dem Link. Informationen dazu, wie die Begriffe zusammenpassen, finden Sie unter Kernkonzepte.
Bedingungen
| Begriff | In einer Zeile |
|---|---|
| Aktion | eine Python-Funktion mit der Markierung @Action, die als POST diente und vom Client aus aufrufbar war (Aktionen) |
| ASGI | die Schnittstelle Uvicorn spricht, implementiert durch FastAPI und Starlette |
| Client-Modus | useCSR = True: Framework-Dateien sind die Routen und der Browser navigiert (Modi) |
| Komponente | ein wiederverwendbarer UI-Baustein, der zum Erstellen einer Ansicht verwendet wird (Ansichten) |
| CSR | Clientseitiges Rendering: Der Browser rendert Seiten nach dem ersten Dokument (CSR) |
| Abhängigkeit | Eine Funktion FastAPI wird vor einem Handler, pro Route oder pro Ordner ausgeführt (Abhängigkeiten) |
| Dokumentenhülle | die <html>, <head> und <body> um eine Seite herum, Eigentum des nächstgelegenen Layouts oder von Nexy (Layouts) |
| Endpunkt | die einzigartige Kombination einer URL und einer HTTP-Methode (Ansichten) |
| FBR | Dateibasiertes Routing: Eine Datei unter src/routes/ ist eine Route (Routing) |
| Frontmatter | der Python-Block zwischen den beiden ----Zeilen einer .nexy- oder .md-Datei (.nexy-Dateien) |
| Wache | eine Abhängigkeit, die eine Anfrage ablehnt, indem sie HTTPException (Guards) auslöst |
| Handler | eine Python-Funktion, die eine HTTP-Anfrage für eine bestimmte Methode verarbeitet (Ansichten) |
| HMR | Hot-Modul-Austausch: Der Entwicklungsserver tauscht die geänderten Module aus, ohne einen vollständigen Neuladen (Frontend) |
| Flüssigkeitszufuhr | Der Browser fügt ein Framework an HTML an, das der Server bereits gesendet hat (Inseln) |
| Insel | eine Client-Komponente, die in einer vom Server gerenderten Seite eingebunden ist (Inseln) |
| ISR | inkrementelle statische Regeneration: eine zwischengespeicherte Seite pro Pfad, im Hintergrund aktualisiert (ISR) |
| Layout | eine layout.*-Datei, die die Seiten unterhalb ihres Ordners umschließt (Layouts) |
| Modularer Router | Routen deklariert mit @Module und @Controller unter src/apps/ (modular) |
| Seite | eine über eine URL adressierbare Ressource, die durch eine Datei unter src/routes/ definiert wird (Ansichten) |
| Vorabholen | Laden der Seite hinter einem Link, bevor der Leser darauf klickt (Verlinkung) |
| Requisiten | die Werte, die ein übergeordnetes Element an eine Komponente übergibt (.nexy-Dateien) |
| Erneut validieren | die Anzahl der Sekunden, nach denen eine ISR-Seite im Hintergrund neu erstellt wird (ISR) |
| Route | ein URL-Muster, erzeugt durch den Pfad einer Routendatei (Routing) |
| Routengruppe | ein Ordner in Klammern, der Routen gruppiert, ohne ein Segment hinzuzufügen (dynamische Routen) |
| Routenhandler | die GET, POST, … Funktion einer .py Routendatei (Handler) |
| Servermodus | useCSR = False, die Standardeinstellung: Der Server rendert .nexy- und .md-Seiten (Modi) |
| Geschicklichkeit | ein Ordner mit einem SKILL.md, der einem Codierungsagenten einen Teil von Nexy beibringt (Codierungsagenten) |
| SSG | statische Site-Generierung; kein Nexy-Modus: Der im Voraus erstellte HTML-Code wird immer vom Server zurückgelesen (Rendering) |
| SSR | serverseitiges Rendering: Der Server rendert jede Seite für seine Anfrage, und dies ist die Standardeinstellung (SSR) |
| Ansicht | der Prozess der Erstellung des Antworttextes für eine Seite (Ansichten) |
Dateien und Ordner
| Name | In einer Zeile |
|---|---|
__nexy__/ |
generierte Ausgabe: kompilierte Seiten, der Client-Eintrag und der Aktions-Client; nie bearbeitet, nie festgeschrieben |
nexyconfig.py |
die Projektkonfiguration, eine Klasse von use* Feldern (Konfiguration) |
public/ |
Dateien, die im Stammverzeichnis bereitgestellt werden, wie zum Beispiel public/logo.svg → /logo.svg (Dateikonventionen) |
src/apps/ |
Controller und Module des modularen Routers (modular) |
src/components/ |
Von Seiten importierte Komponenten; leitet niemals weiter (Dateikonventionen) |
src/routes/ |
die Routen der Anwendung (Dateikonventionen) |
Nächste Schritte
- Kernkonzepte: das Modell, zu dem diese Wörter gehören
- Dokumentationsindex: die Seite für die jeweilige Aufgabe
- Dateikonventionen: die reservierten Namen hinter diesen Definitionen
- Für KI-Agenten: dieselben Invarianten, geschrieben für einen Agenten