开发指南

本栏介绍 Baklib 模板开发中的 Liquid 变量 API、动态表单配置,以及 Community 社区模板 的特例说明。

通用模板开发路径

适用于 CMS、Wiki 及大多数站点模板:
  1. 自定义变量和方法sitepagecurrent_user 等对象与 API
  2. 动态表单settings_schema.json 中的表单类型与页面变量
  3. Liquid 模板语言教程 — Liquid 标记、过滤器与 Baklib 扩展
完成 启动指南 中的动手教程后,按以上顺序阅读即可开始正式开发。

Community 社区模板(特例)

Community 模板在通用 API 基础上,增加了前端用户认证前台发帖/评论页面级创建权限等能力,与 CMS/Wiki 模板差异较大:
维度 通用模板 Community 模板
用户体系 多为后台管理用户 独立注册登录、前台 current_user
内容创建 后台页面管理 前台 {% form_tag %} 创建/编辑帖子
页面权限 后台权限为主 user_creatable / user_editable / user_deletable / user_permitted_attributes
互动 视插件而定 comment 对象、评论与回复
💡
开发 Community 模板时:先浏览 自定义变量和方法 中与 CMS 共用的 sitepage 等对象,再读 [特例]社区模板 专章中的差异 API 与表单示例。

本栏目录