假定你已按安装与部署装好、能打开首页。下面是第一次进站的最短路径,约 5 分钟。
本页导航
1. 登录后台
访问 /admin/,用安装向导里设置的管理员账号登录。左侧是 16 个模块(完整说明见使用手册):仪表盘、文章、页面、分类标签、多语、记事本、评论、用户、附件、主题、页面布局、系统升级、插件、云市场、设置、工具。
建议第一件事:到「用户」改掉初始口令;到「工具 → 备份」生成一次全库备份。
2. 站点设置
「设置」里至少填这几项:
| 选项 | 说明 |
|---|---|
site.name / site.name_en | 站点中文名 / 英文名(/en/ 下显示英文名) |
site.subtitle / site.subtitle_en | 副标题 |
site.description | 站点描述,用于首页与 SEO meta |
site.languages / site.default_lang | 启用语言与基准语言,如 ["zh","en"] / zh |
site.url | 与实际访问域名一致(影响 canonical、登录会话) |
stats.head / stats.foot | 统计代码位;留空即零外发 |
完整选项表见使用手册:配置项。
3. 切换主题
「主题」页列出 themes/ 下全部主题(当前 34 套),点选即切换;「主题设置」按该主题 theme.json 的 settings 声明项调整配色、宽度、每页条数、最新文章数、是否显示侧栏等。
切完首页没变?清缓存并重建首页静态件,见第 7 步。
4. 启用插件
「插件」页按目录列出 20 个内置插件。常用组合:
| 插件 | 作用 | 建议 |
|---|---|---|
poly | 多语言与 AI 翻译 | 做多语站才启用 |
market | /theme、/plugin、/downloads、/market 等应用市场页 | 官网形态建议开 |
site | 企业官网模式(可让首页走官网版式) | 按需启用 |
forum | 论坛与社区 | 按需启用 |
home-static / entry-static | 首页 / 入口静态件烘焙 | 高流量时启用 |
statx | 站点统计 | 按需启用 |
启用时会自动执行该插件 migrations/ 下的幂等迁移(见插件开发);停用只停注册,数据保留。
5. 发布第一篇文章
「文章 → 新建」:
- 填标题,系统生成 slug(可手改,只含字母数字与连字符);
- 写摘要、正文(Markdown,支持表格、``
lang 代码块、{#anchor}` 显式锚点); - 选分类与标签、上传封面;
- 状态选
publish,可设定published_at定时发布; - 保存后访问
/<slug>.html。
「页面」同理,用于关于、联系、文档等独立页,URL 同为 /<slug>.html;导航里想出现,去 Nav::defs() 或后台自定义导航添加(见使用手册:导航)。
6. 首页版式
「设置 / 页面布局」里几个关键开关:
| 选项 | 作用 |
|---|---|
home.landing | 1 = 使用主题的门户首页(landing.php),0 = 文章列表首页 |
home.style | text 文字列表 / img 图文列表 |
home.show_circle | 是否显示社区/博客圈区块 |
theme.sidebar_mode | flow 普通 / sticky 固定栏内滚动 |
theme.options.latest_n | 首页最新文章条数 |
7. 清缓存并验收
# 也可后台「工具 → 清缓存」
php -r 'chdir("/www/wwwroot/yecha.org"); require "config.inc.php"; require "core/bootstrap.php"; Cache::flush("pages"); Cache::flush("blocks");'
rm -f /www/wwwroot/yecha.org/var/home-static/index.html
curl -s -o /dev/null -w '%{http_code}\n' -H 'Host: example.com' https://127.0.0.1/验收:首页按新主题渲染;/<slug>.html 可访问;/sitemap.xml 里出现新文章;/feed 正常;后台保存设置无报错。