Skip to content

Latest commit

 

History

History
128 lines (84 loc) · 4.19 KB

File metadata and controls

128 lines (84 loc) · 4.19 KB

AFTERGLOW 零代码使用指南

这份指南面向没有编程经验的博客作者。项目启动后,你只需要使用浏览器后台,不需要修改源码、数据库文件或配置文件。

1. 第一次进入后台

打开博客地址,在网址后加上 /admin,例如:

http://localhost:3001/admin

第一次进入时,页面会让你创建管理密码。设置完成后,这个密码就是后台登录凭据。

2. 发布第一篇文章

  1. 点击左侧“写新文章”;
  2. 输入标题、摘要、分类和标签;
  3. 在正文区域直接输入内容;
  4. 使用工具栏插入标题、列表、引用、链接、按钮、代码块、表格或双栏内容;
  5. 点击“保存版本”保留草稿,或点击“立即发布”。

编辑器会自动保存。正文中的顶层区块可以拖动调整顺序。

文章发布方式

  • 草稿:只有后台管理员可以看到;
  • 私密预览:保存后生成分享链接,适合发布前交给朋友审阅;
  • 公开展示:出现在首页、搜索和归档中;
  • 仅链接可见:不进入公开文章列表,知道链接的人可以阅读;
  • 密码文章:读者输入文章密码后才能阅读;
  • 定时发布:选择时间后点击“定时发布”。

3. 使用媒体库

进入“媒体库”可以批量上传:

  • JPG、PNG、WebP 等图片;
  • 视频;
  • 音频;
  • PDF 文件。

大图片会自动压缩。图片可以一键裁成正方形,也可以在不修改文章的情况下替换原文件。

写文章时点击“媒体/画廊”,可以把单个媒体插入正文,或勾选多张图片组成画廊。

4. 一键更换视觉方案

进入“站点设置”或“设计编排”:

  • 选择整套主题配色和预设图片;
  • 修改强调色;
  • 切换字体、页面布局和组件风格;
  • 关闭不想使用的首页模块;
  • 上下移动模块调整首页顺序;
  • 修改导航文字和链接。

保存后前台立即更新,不需要编辑 CSS。

5. 建立专栏和合集

  1. 进入“专栏合集”;
  2. 填写名称、简介和封面;
  3. 发布专栏;
  4. 回到文章编辑器,为文章选择所属专栏和专栏内顺序。

前台会自动生成专栏封面、文章目录和连续阅读的上下篇导航。

6. 管理友链、项目和自定义页面

“页面建设”提供关于、友链、项目和归档页面模板。填写页面标题和正文即可发布。

友链和项目还可以在“友链项目”中按字段管理:名称、简介、链接、图片和补充信息。前台会自动排版成卡片。

7. 管理评论和留言

进入“互动订阅”可以:

  • 通过或隐藏评论;
  • 置顶重要评论;
  • 以作者身份回复;
  • 删除评论;
  • 审核公开留言;
  • 阅读联系表单发来的私信。

如果希望先审核再公开,在“站点设置”中打开“新评论先审核再公开”。单篇文章也可以关闭评论。

8. 管理邮件订阅

博客在首页和读者中心提供订阅入口。

如需真正自动发送邮件:

  1. 注册 Resend 并取得 API Key;
  2. 在 Resend 中验证发件域名或发件地址;
  3. 进入后台“互动订阅”;
  4. 填写发件人和 API Key;
  5. 打开“发布文章后自动发送”。

以后发布新文章时会自动通知有效订阅者。也可以选择一篇已发布文章手动发送。

9. 使用读者账户

读者可以在“我的”页面注册账户。登录后可以跨设备同步:

  • 收藏文章;
  • 阅读历史;
  • 新文章邮件订阅状态。

10. 备份与迁移

后台左下角“导出备份”会下载完整 JSON 备份。

“内容导入”支持 Markdown、JSON 和本站备份格式。更换电脑或重新部署前,建议先导出一份备份。

日常维护是否需要代码?

不需要。以下工作都在后台完成:

  • 写作和排版;
  • 发布、删除和恢复文章;
  • 上传与替换媒体;
  • 更换主题和首页结构;
  • 建立专栏、页面、友链和项目;
  • 管理评论、留言和订阅;
  • 查看数据与导出备份。

只有第一次安装、连接托管平台或升级项目版本时可能需要终端操作。这些一次性步骤也可以交给 Codex 完成。