快速开始

假定你已按安装与部署装好、能打开首页。下面是第一次进站的最短路径,约 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. 发布第一篇文章

「文章 → 新建」:

  1. 填标题,系统生成 slug(可手改,只含字母数字与连字符);
  2. 写摘要、正文(Markdown,支持表格、``lang 代码块、{#anchor}` 显式锚点);
  3. 选分类与标签、上传封面;
  4. 状态选 publish,可设定 published_at 定时发布;
  5. 保存后访问 /<slug>.html。

「页面」同理,用于关于、联系、文档等独立页,URL 同为 /<slug>.html;导航里想出现,去 Nav::defs() 或后台自定义导航添加(见使用手册:导航)。

6. 首页版式

「设置 / 页面布局」里几个关键开关:

选项作用
home.landing1 = 使用主题的门户首页(landing.php),0 = 文章列表首页
home.styletext 文字列表 / img 图文列表
home.show_circle是否显示社区/博客圈区块
theme.sidebar_modeflow 普通 / 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 正常;后台保存设置无报错。

下一步