文档了解模型
意见
在选择文件格式之前,区分 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 添加依赖项:
from nexy.core.models import NexyConfigModelfrom nexy.frontend import react class NexyConfig(NexyConfigModel): useFF = react()启用框架后,Vite 处理其客户端捆绑包。在客户端模式下,其扩展成为路由;在服务器模式下,相同的文件是您作为孤岛导入的组件 - src/routes/ 下的框架文件被拒绝。请参阅服务器模式和客户端模式。
布局
目录中的 layout.* 包裹其下方的页面。请参阅布局。
后续步骤
- .nexy 文件:Python + Jinja2 + 道具
- Markdown 和 MDX:内容页面
- 组件:内置 HTML 帮助器