DE

DokuVerstehen Sie das Modell

Ansichten

Bevor Sie ein Dateiformat auswählen, ist es wichtig zu unterscheiden, wie Nexy mit Ressourcen umgeht und wie es sie rendert.

Begriff Definition
Seite Eine per URL adressierbare Ressource der Anwendung. Es wird durch eine Datei unter src/routes/ definiert.
Anzeigen Der Prozess der Erstellung des Antworttexts für eine Seite. Eine Ansicht wandelt Logik und Daten in HTML oder JSON um.
Komponente Ein wiederverwendbarer UI-Baustein, der zum Erstellen einer Ansicht verwendet wird. Komponenten können native Nexy-Helfer oder Framework-spezifisch sein (React, Vue usw.).
Routenhandler Eine Python-Funktion, die eine HTTP-Anfrage für eine bestimmte Methode verarbeitet (z. B. GET, POST).
Endpunkt Die einzigartige Kombination aus einer URL und einer HTTP-Methode, auf die ein Route-Handler antwortet.

Nicht sicher? Schreiben Sie eine .nexy-Datei. Es ist kein Client-Framework erforderlich, und Sie können später eine React-, Vue-, Svelte-, Solid- oder Preact-Komponente als Insel hinzufügen.

Welche Datei für welche Seite
server logic + HTML.nexy(Python frontmatter + Jinja2)
prose that changes rarely.md(GitHub-flavoured Markdown)
prose + components.mdx(React or Preact)
app-like page, client router.tsx .vue .svelte(framework files)
API handler.py(GET, POST, …)

Formate

Formatieren Datei Server-Rendering Client-Framework Notizen
.nexy .nexy-Dateien Jinja2 + Python Logik, gestreamt optional Natives Nexy-Seitenformat
.md Markdown und MDX Markdown zum Zeitpunkt der Anfrage optional über Layout Rein Markdown, GFM, im Layout verpackt
.mdx Markdown und MDX Rahmen SSR React oder Preact Markdown mit Komponenten
.tsx React, Solid oder Preact Client-Modus: das Framework, gerendert in Node React, Solid oder Preact Komponentenrouten
.vue Vue Client-Modus: das Framework, gerendert in Node Vue SFC-Routen
.svelte Svelte Client-Modus: das Framework, gerendert in Node Svelte SFC-Routen

Eingebaute Image, Link, Audio, Video und Import Helfer: Komponenten.

Formate mischen

Sie können verschiedene Technologien innerhalb desselben Projekts kombinieren:

  • Inseln: Sie können eine React- oder Vue-Komponente in eine .nexy-Seite importieren. Der Server rendert die Shell und das Framework hydriert die Komponente auf dem Client.
  • Gemeinsame Logik: Routenhandler in .py-Dateien können Daten für Seiten in jedem Format über den gemeinsamen Anwendungsstatus oder API-Aufrufe bereitstellen.

Aktivieren Sie ein Framework

Setzen Sie useFF in nexyconfig.py und führen Sie nexy new aus, um Abhängigkeiten hinzuzufügen:

nexyconfig.py
from nexy.core.models import NexyConfigModelfrom nexy.frontend import react  class NexyConfig(NexyConfigModel):    useFF = react()

Wenn ein Framework aktiviert ist, verwaltet Vite seine Client-Bundles. Im Client-Modus werden seine Erweiterungen zu Routen; Im Servermodus sind die gleichen Dateien Komponenten, die Sie als Inseln importieren – eine Framework-Datei unter src/routes/ wird dort abgelehnt. Siehe Servermodus und Clientmodus.

Layouts

Ein layout.* in einem Verzeichnis umschließt Seiten darunter. Siehe Layouts.

Nächste Schritte

Auf GitHub bearbeiten

Enter öffnet das Ergebnis, Esc schließt.