DokumentasiKonvensi dan konsep
Glosarium
Kata-kata yang digunakan dokumen ini, masing-masing satu baris, disusun berdasarkan abjad. Istilah yang membutuhkan lebih dari satu baris memiliki halaman: ikuti tautannya. Untuk mengetahui kesesuaian gagasan-gagasan tersebut, bacalah Konsep inti.
Ketentuan
| Istilah | Dalam satu baris |
|---|---|
| Tindakan | fungsi Python yang ditandai @Action, berfungsi sebagai POST dan dapat dipanggil dari klien (tindakan) |
| ASGI | antarmuka Uvicorn berbicara, diimplementasikan oleh FastAPI dan Starlette |
| Mode klien | useCSR = True: file kerangka kerja adalah rute dan navigasi browser (mode) |
| Komponen | blok penyusun UI yang dapat digunakan kembali yang digunakan untuk membuat tampilan (tampilan) |
| CSR | rendering sisi klien: browser merender halaman setelah dokumen pertama (CSR) |
| Ketergantungan | suatu fungsi FastAPI dijalankan sebelum suatu pengendali, per rute atau per folder (dependensi) |
| Dokumen shell | <html>, <head> dan <body> di sekitar halaman, dimiliki oleh tata letak terdekat atau oleh Nexy (tata letak) |
| Titik akhir | kombinasi unik dari URL dan metode HTTP (tampilan) |
| FBR | perutean berbasis file: file di bawah src/routes/ adalah rute (perutean) |
| Frontmatter | blok Python di antara dua baris --- dari file .nexy atau .md (berkas .nexy) |
| Jaga | ketergantungan yang menolak permintaan dengan menaikkan HTTPException (guard) |
| Handler | fungsi Python yang menangani permintaan HTTP untuk metode tertentu (tampilan) |
| Penggantian modul panas HMR | : server pengembang menukar modul yang diubah, tanpa memuat ulang penuh (frontend) |
| Hidrasi | browser melampirkan kerangka kerja ke HTML yang sudah dikirim server (pulau) |
| Island | komponen klien yang dipasang di dalam halaman yang dirender server (pulau) |
| ISR | regenerasi statis tambahan: satu halaman cache per jalur, disegarkan di latar belakang (ISR) |
| Layout | file layout.* yang membungkus halaman di bawah foldernya (tata letak) |
| Router modular | rute dideklarasikan dengan @Module dan @Controller di bawah src/apps/ (modular) |
| Halaman | sumber daya yang dapat dialamatkan URL yang ditentukan oleh file di bawah src/routes/ (tampilan) |
| Ambil terlebih dahulu | memuat halaman di belakang tautan sebelum pembaca mengkliknya (tautan) |
| Props | nilai yang diberikan induk ke komponen (berkas .nexy) |
| Validasi ulang | jumlah detik setelah halaman ISR dibuat ulang di latar belakang (ISR) |
| Rutekan | pola URL, dihasilkan oleh jalur file rute (perutean) |
| Grup rute | folder dalam tanda kurung yang mengelompokkan rute tanpa menambahkan segmen (rute dinamis) |
| Pengendali rute | fungsi GET, POST, … dari file rute .py (handler) |
| Mode server | useCSR = False, default: server merender halaman .nexy dan .md (mode) |
| Skill | folder dengan SKILL.md yang mengajarkan agen pengkodean satu bagian dari Nexy (agen pengkodean) |
| SSG | pembuatan situs statis; bukan mode Nexy: HTML yang dibuat sebelumnya selalu dibaca kembali oleh server (perenderan) |
| SSR | rendering sisi server: server merender setiap halaman untuk permintaannya, dan ini adalah default (SSR) |
| Lihat | proses pembuatan isi respons untuk suatu halaman (tampilan) |
File dan folder
| Nama | Dalam satu baris |
|---|---|
__nexy__/ |
keluaran yang dihasilkan: halaman yang dikompilasi, entri klien dan klien tindakan; tidak pernah mengedit, tidak pernah melakukan |
nexyconfig.py |
konfigurasi proyek, kelas use* bidang (konfigurasi) |
public/ |
file yang disajikan di root, seperti public/logo.svg → /logo.svg (konvensi file) |
src/apps/ |
pengontrol dan modul router modular (modular) |
src/components/ |
komponen yang diimpor berdasarkan halaman; tidak pernah merutekan (konvensi file) |
src/routes/ |
rute aplikasi (konvensi file) |
Langkah selanjutnya
- Konsep inti: model milik kata-kata ini
- Indeks dokumentasi: halaman untuk tugas yang ada
- Konvensi file: nama khusus di balik definisi ini
- Untuk agen AI: invarian yang sama, ditulis untuk agen