DocsEntenda o modelo

Visualizações

Antes de escolher um formato de arquivo, é importante distinguir entre como o Nexy lida com os recursos e como ele os renderiza.

Prazo	Definição
Página	Um recurso endereçável por URL do aplicativo. É definido por um arquivo em `src/routes/`.
Ver	O processo de produção do corpo da resposta para uma página. Uma visualização transforma lógica e dados em HTML ou JSON.
Componente	Um bloco de construção de UI reutilizável usado para compor uma visualização. Os componentes podem ser auxiliares nativos do Nexy ou específicos da estrutura (React, Vue, etc.).
Manipulador de rota	Uma função Python que trata uma solicitação HTTP para um método específico (por exemplo, `GET`, `POST`).
Ponto final	A combinação exclusiva de uma URL e um método HTTP que um manipulador de rota responde.

Não tenho certeza? Escreva um arquivo .nexy. Ele não precisa de estrutura de cliente e você pode adicionar um componente React, Vue, Svelte, Solid ou Preact dentro dele posteriormente, como uma ilha.

Qual arquivo para qual página

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, …)

Formatos

Formato	Arquivo	Renderização do servidor	Estrutura do cliente	Notas
`.nexy`	Arquivos .nexy	lógica Jinja2 + Python, transmitida	opcional	Formato de página Nexy nativo
`.md`	Markdown e MDX	Markdown no momento da solicitação	opcional via layout	Puro Markdown, GFM, embrulhado em layout
`.mdx`	Markdown e MDX	quadro SSR	React ou Preact	Markdown com componentes
`.tsx`	React, Solid ou Preact	modo cliente: a estrutura, renderizada em Node	React, Solid ou Preact	Rotas de componentes
`.vue`	Vue	modo cliente: a estrutura, renderizada em Node	Vue	Rotas SFC
`.svelte`	Svelte	modo cliente: a estrutura, renderizada em Node	Svelte	Rotas SFC

Ajudantes Image, Link, Audio, Video e Import integrados: Componentes.

Misturando formatos

Você pode misturar diferentes tecnologias dentro do mesmo projeto:

Ilhas: Você pode importar um componente React ou Vue dentro de uma página .nexy. O servidor renderiza o shell e a estrutura hidrata o componente no cliente.
Lógica compartilhada: Manipuladores de rota em arquivos .py podem fornecer dados para páginas em qualquer formato por meio do estado compartilhado do aplicativo ou chamadas de API.

Habilitar uma estrutura

Defina useFF em nexyconfig.py e execute nexy new para adicionar dependências:

nexyconfig.py

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

Com um framework habilitado, Vite lida com seus pacotes de clientes. No modo cliente suas extensões tornam-se rotas; no modo servidor, os mesmos arquivos são componentes que você importa como ilhas - um arquivo de estrutura em src/routes/ é rejeitado lá. Consulte modo servidor e modo cliente.

Layouts

Um layout.* em um diretório agrupa as páginas abaixo dele. Consulte layouts.

Próximas etapas

Arquivos .nexy: Python + Jinja2 + adereços
Markdown e MDX: páginas de conteúdo
Componentes: auxiliares HTML integrados

Editar no GitHub