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.
.nexy(Python frontmatter + Jinja2).md(GitHub-flavoured Markdown).mdx(React or Preact).tsx .vue .svelte(framework files).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
.pydapat 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:
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
- File .nexy: Python + Jinja2 + alat peraga
- Markdown dan MDX: halaman konten
- Komponen: pembantu HTML bawaan