README.md

Cogita 文档中心

欢迎来到 Cogita 框架的文档中心！这里包含了使用、开发和扩展 Cogita 所需的所有信息。

📚 文档导航

🚀 快速开始

• 项目概述 - Cogita 框架简介和特性
• 快速开始 (即将推出) - 5分钟上手指南
• 最佳实践指南 ✅ - 项目组织、配置优化和部署策略

📖 用户文档

• API 参考文档 ✅ - 完整的 API 接口说明
• 配置指南 (即将推出) - 详细的配置选项
• 主题使用 (即将推出) - 主题安装和自定义

🔧 开发者文档

• 架构设计文档 ✅ - 系统架构和设计理念
• 插件开发指南 ✅ - 从零开发 Cogita 插件
• 主题开发指南 (即将推出) - 创建自定义主题

🛠️ 运维文档

• 开发指南 ✅ - 本地开发和代码规范
• 部署指南 ✅ - 多平台部署策略
• 贡献指南 ✅ - 参与项目贡献

🗂️ 文档按角色分类

👤 内容创作者

如果你主要关注内容创作和博客管理：

1. 项目概述 - 了解 Cogita 能做什么
2. 快速开始 - 创建你的第一个博客 (即将推出)
3. 最佳实践指南 - 内容创作和项目组织技巧
4. 配置指南 - 个性化你的博客设置 (即将推出)

🎨 主题用户

如果你想自定义博客外观和体验：

1. API 参考文档 - 了解可用的配置选项
2. 最佳实践指南 - 主题使用技巧和样式自定义
3. 主题使用指南 - 主题安装和配置 (即将推出)

🔌 插件开发者

如果你想为 Cogita 开发插件：

1. 架构设计文档 - 理解系统架构
2. 插件开发指南 - 完整的插件开发教程
3. API 参考文档 - 插件 API 详细说明
4. 开发指南 - 本地开发环境搭建

🎨 主题开发者

如果你想创建新的主题：

1. 架构设计文档 - 主题系统设计
2. 主题开发指南 - 主题开发完整流程 (即将推出)
3. API 参考文档 - 主题 API 和接口
4. 最佳实践指南 - 主题开发最佳实践

🚀 项目贡献者

如果你想参与 Cogita 核心开发：

1. 架构设计文档 - 深入理解系统设计
2. 开发指南 - 开发环境和工作流程
3. 贡献指南 - 贡献流程和规范
4. API 参考文档 - 核心 API 设计

📋 文档状态

文档	状态	最后更新	重要性
插件开发指南	✅ 完成	2024-01	🔥 高
API 参考文档	✅ 完成	2024-01	🔥 高
架构设计文档	✅ 完成	2024-01	🔥 高
最佳实践指南	✅ 完成	2024-01	🔥 高
开发指南	✅ 完成	2024-01	🔸 中
部署指南	✅ 完成	2024-01	🔸 中
贡献指南	✅ 完成	2024-01	🔸 中
快速开始	📝 计划中	-	🔥 高
配置指南	📝 计划中	-	🔸 中
主题开发指南	📝 计划中	-	🔸 中
主题使用指南	📝 计划中	-	🔹 低

🔍 快速查找

我想...

• 创建我的第一个博客 → 快速开始 (即将推出)
• 了解所有配置选项 → API 参考文档
• 自定义博客外观 → 最佳实践指南 + 主题使用指南 (即将推出)
• 开发一个插件 → 插件开发指南
• 理解系统架构 → 架构设计文档
• 部署到生产环境 → 部署指南 + 最佳实践指南
• 参与项目贡献 → 贡献指南 + 开发指南

常见问题

• Cogita 和其他静态站点生成器有什么区别？ → 项目概述
• 如何配置社交链接？ → API 参考文档
• 插件开发有哪些最佳实践？ → 插件开发指南
• 如何优化构建性能？ → 最佳实践指南
• 支持哪些部署平台？ → 部署指南

🤝 改进文档

我们的文档在持续改进中，欢迎你的贡献：

1. 发现错误或过时信息 → 提交 Issue
2. 建议改进内容 → 发起 Discussion
3. 直接改进文档 → 提交 Pull Request

📞 获取帮助

• 📖 查看文档 - 首先查找相关文档章节
• 💬 社区讨论 - GitHub Discussions
• 🐛 报告问题 - GitHub Issues
• 📧 联系维护者 - 通过 GitHub

---

感谢使用 Cogita！如果你喜欢这个项目，别忘了在 GitHub 上给我们一个 ⭐️