Docsentender el modelo
Vistas
Antes de elegir un formato de archivo, es importante distinguir entre cómo Nexy maneja los recursos y cómo los representa.
| Término | Definición |
|---|---|
| Página | Un recurso de la aplicación direccionable por URL. Está definido por un archivo en src/routes/. |
| Ver | El proceso de producir el cuerpo de respuesta de una página. Una vista transforma la lógica y los datos en HTML o JSON. |
| Componente | Un bloque de construcción de interfaz de usuario reutilizable que se utiliza para componer una vista. Los componentes pueden ser ayudantes nativos de Nexy o específicos del marco (React, Vue, etc.). |
| Controlador de ruta | Una función Python que maneja una solicitud HTTP para un método específico (por ejemplo, GET, POST). |
| Punto final | La combinación única de una URL y un método HTTP a la que responde un controlador de ruta. |
¿No estás seguro? Escriba un archivo .nexy. No necesita marco de cliente, y puede agregar un componente React, Vue, Svelte, Solid o Preact dentro de él más tarde, como una isla.
.nexy(Python frontmatter + Jinja2).md(GitHub-flavoured Markdown).mdx(React or Preact).tsx .vue .svelte(framework files).py(GET, POST, …)Formatos
| Formato | Archivo | renderizado del servidor | Marco de cliente | Notas |
|---|---|---|---|---|
.nexy |
Archivos .nexy | Jinja2 + Python lógica, transmitida | opcional | Formato de página nativo de Nexy |
.md |
Markdown y MDX | Markdown en el momento de la solicitud | opcional a través del diseño | Puro Markdown, GFM, envuelto en diseño |
.mdx |
Markdown y MDX | marco RSS | React o Preact | Markdown con componentes |
.tsx |
React, Solid o Preact | modo cliente: el marco, renderizado en Node | React, Solid o Preact | Rutas de componentes |
.vue |
Vue | modo cliente: el marco, renderizado en Node | Vue | Rutas SFC |
.svelte |
Svelte | modo cliente: el marco, renderizado en Node | Svelte | Rutas SFC |
Ayudantes Image, Link, Audio, Video y Import integrados: Componentes.
Formatos de mezcla
Puedes mezclar diferentes tecnologías dentro de un mismo proyecto:
- Islas: Puede importar un componente React o Vue dentro de una página
.nexy. El servidor representa el shell y el marco hidrata el componente en el cliente. - Lógica compartida: los controladores de ruta en archivos
.pypueden proporcionar datos a páginas en cualquier formato a través del estado de la aplicación compartida o llamadas API.
Habilitar un marco
Establezca useFF en nexyconfig.py y ejecute nexy new para agregar dependencias:
from nexy.core.models import NexyConfigModelfrom nexy.frontend import react class NexyConfig(NexyConfigModel): useFF = react()Con un marco habilitado, Vite maneja sus paquetes de clientes. En modo cliente sus extensiones se convierten en rutas; en el modo servidor, los mismos archivos son componentes que usted importa como islas; allí se rechaza un archivo de marco en src/routes/. Consulte modo servidor y modo cliente.
Diseños
Un layout.* en un directorio envuelve las páginas debajo de él. Ver diseños.
Próximos pasos
- Archivos .nexy: Python + Jinja2 + accesorios
- Markdown y MDX: páginas de contenido
- Componentes: ayudantes HTML integrados