DokumentasiPahami modelnya

Tampilan

Sebelum memilih format file, penting untuk membedakan antara cara Nexy menangani sumber daya dan cara merendernya.

Istilah Definisi
Halaman Sumber daya aplikasi yang dapat dialamatkan URL. Ini ditentukan oleh file di bawah src/routes/.
Lihat Proses menghasilkan badan respons untuk sebuah halaman. Tampilan mengubah logika dan data menjadi HTML atau JSON.
Komponen Blok penyusun UI yang dapat digunakan kembali untuk menyusun tampilan. Komponen dapat berupa pembantu asli Nexy atau khusus kerangka kerja (React, Vue, dll.).
Pengendali rute Fungsi Python yang menangani permintaan HTTP untuk metode tertentu (misalnya, GET, POST).
Titik akhir Kombinasi unik dari URL dan metode HTTP yang dijawab oleh pengendali rute.

Tidak yakin? Tulis file .nexy. Tidak memerlukan kerangka klien, dan Anda dapat menambahkan komponen React, Vue, Svelte, Solid atau Preact di dalamnya nanti, sebagai sebuah pulau.

File mana untuk halaman mana
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, …)

Format

Format Mengajukan Penyajian server Kerangka klien Catatan
.nexy file .nexy Logika Jinja2 + Python, dialirkan opsional Format halaman Nexy asli
.md Markdown dan MDX Markdown pada waktu permintaan opsional melalui tata letak Murni Markdown, GFM, dibungkus tata letak
.mdx Markdown dan MDX kerangka RSK React atau Preact Markdown dengan komponen
.tsx React, Solid atau Preact mode klien: kerangka kerja, dirender dalam Node React, Solid atau Preact Rute komponen
.vue Vue mode klien: kerangka kerja, dirender dalam Node Vue Rute SFC
.svelte Svelte mode klien: kerangka kerja, dirender dalam Node Svelte Rute SFC

Pembantu bawaan Image, Link, Audio, Video dan Import: Komponen.

Mencampur format

Anda dapat menggabungkan berbagai teknologi dalam proyek yang sama:

  • Pulau: Anda dapat mengimpor komponen React atau Vue di dalam halaman .nexy. Server merender shell, dan framework menghidrasi komponen pada klien.
  • Logika Bersama: Penangan rute di file .py dapat menyediakan data ke halaman dalam format apa pun melalui status aplikasi bersama atau panggilan API.

Aktifkan kerangka kerja

Atur useFF di nexyconfig.py dan jalankan nexy new untuk menambahkan dependensi:

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

Dengan kerangka kerja yang diaktifkan, Vite menangani bundel kliennya. Dalam mode klien, ekstensinya menjadi rute; dalam mode server, file yang sama adalah komponen yang Anda impor sebagai pulau - file kerangka kerja di bawah src/routes/ ditolak di sana. Lihat mode server dan mode klien.

Tata Letak

A layout.* dalam direktori membungkus halaman di bawahnya. Lihat tata letak.

Langkah selanjutnya

Sunting di GitHub

Enter membuka hasil, Esc menutup.