文档了解模型

意见

在选择文件格式之前,区分 Nexy 如何处理资源以及如何呈现资源非常重要。

期限 定义
页码 应用程序的 URL 可寻址资源。它由 src/routes/ 下的文件定义。
查看 生成页面响应正文的过程。视图将逻辑和数据转换为 HTML 或 JSON。
组件 用于组成视图的可重用 UI 构建块。组件可以是本机 Nexy 帮助程序或特定于框架的组件(React、Vue 等)。
路线处理程序 处理特定方法的 HTTP 请求的 Python 函数(例如,GET、POST)。
端点 路由处理程序应答的 URL 和 HTTP 方法的唯一组合。

没有把握?编写一个 .nexy 文件。 它不需要客户端框架,你可以稍后在其中添加 React、Vue、Svelte、Solid 或 Preact 组件,作为一个岛。

哪个文件对应哪个页面
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, …)

格式

格式 文件 服务器渲染 客户端框架 注释
.nexy .nexy 文件 Jinja2 + Python 逻辑,流式传输 可选的 本机 Nexy 页面格式
.md Markdown 和 MDX Markdown 在请求时 可选的过孔布局 纯 Markdown、GFM、布局包装
.mdx Markdown 和 MDX 框架SSR React 或 Preact Markdown 与组件
.tsx React、Solid 或 Preact 客户端模式:框架,在 Node 中渲染 React、Solid 或 Preact 组件路线
.vue Vue 客户端模式:框架,在 Node 中渲染 Vue 证监会航线
.svelte Svelte 客户端模式:框架,在 Node 中渲染 Svelte 证监会航线

内置 Image、Link、Audio、Video 和 Import 帮助器:组件。

混合格式

您可以在同一项目中混合使用不同的技术:

  • 群岛:您可以在 .nexy 页面内导入 React 或 Vue 组件。服务器渲染外壳,框架在客户端上填充组件。
  • 共享逻辑:.py 文件中的路由处理程序可以通过共享应用程序状态或API调用向任何格式的页面提供数据。

启用框架

在 nexyconfig.py 中设置 useFF 并运行 nexy new 添加依赖项:

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

启用框架后,Vite 处理其客户端捆绑包。在客户端模式下,其扩展成为路由;在服务器模式下,相同的文件是您作为孤岛导入的组件 - src/routes/ 下的框架文件被拒绝。请参阅服务器模式和客户端模式。

布局

目录中的 layout.* 包裹其下方的页面。请参阅布局。

后续步骤

在 GitHub 上编辑

Enter 打开结果,Esc 关闭。