CMS 内容发布系统使用指南

应用介绍

CMS 内容发布系统使用指南 欢迎使用 YBB CMS 内容发布系统。本系统允许您使用 Markdown 编写文章，并通过简单的命令行工具将其同步到线上网站。 1. 快速开始 1.1 准备工作 确保您已经配置了 .env 文件中的 API 密钥： [cms] apikey = your_secret_key_here 1.2 编写文章 在 content 目录下创建一个新的 .md 文件，例如 my-first-post.md。 1.3 发布文章 在项目根目录下运行以下命令（Windows 用户可直接双击 publish.bat）： php think publish:content --path=content 2. 文章格式规范 我们支持两种元数据格式：YAML Front Matter（推荐）和 Legacy 格式。 2.1 YAML Front Matter (推荐) 在文件顶部使用 YAML 语法定义元数据： --- title: 我的文章标题 category: 技术分享 keywords: PHP, ThinkPHP, 教程 description: 这是文章的摘要描述，用于SEO优化。 flag: hot --- 这里是正文内容... 2.2 Legacy 格式 (旧版) 直接在文件开头使用特定关键字： # 我的文章标题 分类: 技术分享 关键词: PHP, ThinkPHP 描述: 摘要描述 标记: hot 这里是正文内容... 3. 支持的 Markdown 语法 本系统内置了增强型的 Markdown 解析器，支持以下常用语法： 3.1 文本样式 加粗文本：使用 **text** 斜体文本：使用 *text* 链接：使用 [text](url) 图片： (系统会自动提取第一张图片作为封面图) 3.2 代码块 支持多语言代码高亮： namespace app\index\controller; class Index { public function index() { return 'Hello CMS!'; } } 3.3 列表与引用 这是一个引用块，用于强调重要信息。 无序列表： 简单易用 自动化管理 支持批量同步 3.4 多级标题 支持 # 到 ###### 六级标题，系统会自动解析为 HTML 的 <h1> - <h6>。 4. 高级功能 自动分类：系统会根据文件所在的目录结构自动创建或匹配栏目。 智能标签：如果未提供 keywords 或 tags，系统会自动从标题中提取关键词。 封面图提取：自动分析正文中的图片，将第一张图设为文章封面。 安全验证：所有 API 请求均通过 API Key 签名验证，确保数据安全。 自动清理：标题或文件名包含“测试”、“Test”等关键词的文章将被自动识别为测试数据并删除。 本文档由 CMS 发布系统自动生成。