本地部署指南
【获取主题文件】
▸ 正式版:下载官方发布的最新稳定版本
【安装步骤】
- 解压主题包,将文件夹重命名为「ITEM」
- 将重命名后的主题目录移动至:
Typecho根目录/usr/themes/ - 登录后台控制台 → 进入「控制面板-外观」→ 激活ITEM主题
⚠️ 重要提示
[强制要求]
• 仅支持 MySQL 数据库(兼容版本:8.0+)
• 禁用 SQLite/PostgreSQL 等非MySQL数据库
[推荐环境]
✓ Typecho ≥ v1.2.0
✓ PHP ≥ v7.4.0
✓ MySQL ≥ v8.0.0
注:低于推荐版本可能导致功能异常或兼容性问题
(使用符号说明:▸表示选项分支,✓表示环境要求,⚠️表示警告信息)
📌 本地开发环境配置
【环境准备】
- 安装 Docker 与 Docker Compose
执行以下命令启动容器:
cd .docker && docker compose up -d
启动前端开发服务:
yarn && yarn watch
🖥️ 开发访问
• 访问地址:http://localhost:80
• 测试账户:dev
/ 12345678
• 代码修改实时热更新
━━━━━━━━━━━━━━━━━━━━
⚙️ 主题配置指南
【内容类型规范】
▸ 网址导航 (默认)
- 点击图标:打开文章详情页
- 点击其他区域:直接跳转目标URL
▸ 站内文章
- 任意点击均进入文章详情页
▸ 微信小程序
- 专用内容类型,点击直接进入详情页
【分类配置】
• 略缩名需对应 FontAwesome 5 图标类名
• 示例:
图标类 → <i class="fas fa-vihara">
略缩名 → vihara
【搜索引擎配置】 (JSON格式)
[{
"name": "站内",
"url": "/search",
"icon": "fas fa-search-location"
},{
"name": "谷歌",
"url": "https://www.google.com/search?q=",
"icon": "fab fa-google"
}]
【工具直达配置】 (支持自定义背景)
[{
"name": "热榜速览",
"url": "https://www.hsmy.fun",
"icon": "fas fa-fire",
"background": "linear-gradient(45deg, #97b3ff, #2f66ff)"
},{
"name": "微信文件助手",
"url": "https://filehelper.weixin.qq.com",
"icon": "fab fa-weixin",
"background": "#1ba784"
}]
【时间线功能】
后台路径:管理 > 独立页面 > 新增
• 模板选择 → 目录/时间线
• 文章类型 → 站内文章
💡 符号说明:▸-功能分支 | ⚙️-配置项 | 📌-关键步骤
评论0
暂时没有评论