欢迎使用 CodeSpace 博客系统
基于 Webman + Twig 构建的现代个人博客,支持 Markdown、标签分类和静态化。
功能特性
CodeSpace 博客系统专为技术写作者打造,核心特性包括:
- Markdown 渲染:文章正文使用 Markdown 编写,支持 GitHub 风格语法
- 标签分类:灵活的标签系统,按主题组织文章
- 静态化生成:可将动态页面一键生成为静态 HTML 文件
- 后台管理:基于 webman/admin 的完整内容管理后台
- 响应式设计:现代简约风格,完美适配移动端
技术栈
| 组件 | 技术 | 说明 |
|---|---|---|
| 后端框架 | Webman 2.x | 基于 Workerman 的高性能 HTTP 框架 |
| PHP 版本 | 8.4+ | 充分利用最新 PHP 特性 |
| 模板引擎 | Twig 3.x | 灵活安全的模板引擎 |
| 数据库 | MySQL / SQLite | 生产用 MySQL,开发可用 SQLite |
| 后台管理 | webman/admin | 官方后台管理方案 |
| Markdown | league/commonmark | GitHub 风格 Markdown 解析 |
快速开始
1. 安装依赖
composer install
2. 初始化数据库
php webman blog:install
这会自动创建所有数据表并填充示例数据。
3. 启动服务
php start.php start
访问 http://127.0.0.1:8787 查看博客前台,访问 http://127.0.0.1:8787/app/admin 进入后台管理。
目录结构
blog/
├── app/
│ ├── command/ # 命令行工具(安装、静态化)
│ ├── controller/ # 控制器
│ ├── model/ # 数据模型
│ └── view/ # Twig 模板
├── config/ # 配置文件
├── plugin/admin/ # 后台管理插件
├── public/ # 静态资源
├── database/seed/ # 示例数据
└── runtime/ # 运行时缓存
写作建议
- 每篇文章都应填写摘要,它会显示在文章列表中
- 合理使用标签组织文章,便于读者按主题浏览
- 文章 URL 别名(slug)使用英文短横线分隔,如
my-first-post - 封面图建议尺寸 1200×630px,保证社交媒体分享效果
感谢你选择 CodeSpace 博客系统,祝你写作愉快!
评论