Z-Blog应用开发概念与通用规范

摘要

本文档概述了Z-Blog内容管理系统中插件与主题两大应用类型的核心概念、功能定位、文件组织规范及开发流程。插件以实现特定功能为目的，主题用于定制前台界面。两者均遵循统一的目录结构、自述文件（XML）规范和安装管理方式。文档还明确了应用目录命名规则、开发模式的开启方法及注意事项，为开发者提供了清晰的指引。

核心要点

• 插件以功能实现为核心，主题以前台界面定制为核心，两者文件组织和自述文件格式有明确区分。
• 应用目录名必须与应用ID相同，系统以此识别应用，推荐使用全小写或驼峰命名并避免重复。
• 开发Z-Blog应用需分别在Z-Blog全局设置和应用中心插件设置中开启开发模式，该模式会显示详细错误信息，线上环境应慎用。
• 可通过应用中心插件的图形界面新建应用，系统将自动创建目录和初始文件。

关键实体

- Z-Blog (product) ⚠️建议建页

- 插件 (concept) ⚠️建议建页

- 主题 (concept) ⚠️建议建页

建议新建页面

• [[Z-Blog插件开发指南]] — 原文详细描述了插件的目录结构、自述文件和开发规范，值得单独提炼为独立指南。
• [[Z-Blog主题开发指南]] — 原文详细描述了主题的用途、自述文件和管理方式，值得单独提炼为独立指南。
• [[Z-Blog应用中心]] — 作为应用管理和发布的核心平台，其功能和规范值得详细阐述。

---

> 编译时间: 2026-06-12 09:57 | 来源: `zblog-docs/dev-05-start.md`