Mirror配置完全指南10个核心参数打造个性化GitHub博客【免费下载链接】MirrorA blogging tool powered by GitHub API. Write your blog on GitHub issue.项目地址: https://gitcode.com/gh_mirrors/mirror9/Mirror用 GitHub Issues 写博客正在成为越来越多开发者的选择——不需要购买服务器、不需要维护数据库把文章当作 Issue 发布GitHub 就是你的内容后台。Mirror 配置就是这套玩法的明星方案它是一款基于 GitHub API 的博客工具只需一份配置文件就能把「GitHub 博客」快速变成一个清爽、现代、带评论功能和个人主页的个人站点。这篇Mirror 配置完全指南将带你逐一认识index.sample.html中的 10 个核心参数学会如何通过修改参数完成GitHub 博客个性化配置全程零后端、零数据库新手也能轻松上手。一、认识 MirrorGitHub Issue 即博客Mirror 的核心思路极其简洁文章 Issue评论 Issue 评论。它通过 GitHub GraphQL API 拉取指定仓库的 Issue 数据再渲染成博客页面。因此配置 Mirror 的第一步就是告诉它你是谁、你的文章存在哪个仓库——这一切都由window.config对象里的参数决定。所有参数都写在项目根目录的 index.sample.html 中即文件里这一段script window.config { user: LoeiFy, repository: Recordum, title: Mirror, // ... 其余参数 } /script下面逐一拆解这 10 个关键参数。二、10 个核心参数逐一详解1.user指定你的 GitHub 用户名必填user是 Mirror 配置中最重要的参数它决定了博客内容的归属者。Mirror 会向 GitHub 查询这个用户名下的仓库与 Issue 数据。例如user: LoeiFy表示博客数据来自 LoeiFy 这个账号。 如果你用组织Organization账号请配合后面的organization参数一起设置。2.repository指定博客文章仓库必填repository告诉 Mirror 从哪个仓库读取 Issue 作为文章。建议单独建一个仓库比如blog专门存放你的文章把每篇博客写成一条 Issue。配置示例repository: Recordum。3.title设置博客标题与浏览器标签页title会显示在博客页面的标题位置同时用于浏览器标签页如文章标题 - 博客标题。把它改成你自己的名字或站点名即可例如title: 我的技术博客。4.authors设置作者署名authors用于展示文章作者名。如果是单人博客填你的 GitHub 用户名即可如果是多人协作博客可用逗号分隔多个作者。比如authors: LoeiFy或authors: 小明,小红。5.perpage控制每页文章数量perpage决定博客首页每页展示多少篇文章默认值为5。喜欢瀑布流长列表可以调大到10追求精炼则保留5。该参数同时会影响分页游标cursor的生成逻辑详见 src/api/issues.js 中的查询拼接。6.order定义文章排序规则order控制文章列表的排序方式仅支持两个值CREATED_AT按创建时间排序文章发布即排序UPDATED_AT按更新时间排序编辑过的文章会提前如果填了其他值代码会自动回退为UPDATED_AT见 src/api/issues.js 的兜底逻辑。7.ignores忽略指定文章ignores用于排除某些 Issue 不显示在博客中以逗号分隔的编号列表形式配置。典型用途是把仓库里用于置顶说明、待办清单的 Issue 隐藏掉。例如ignores: 17,13表示跳过第 17 号和 13 号 Issue。8.organization启用组织账号模式默认organization: false表示以个人用户user模式拉取数据若你的博客挂在组织名下请改为true。切换后src/api/user.js 会改用organization查询语句展示组织的头像、邮箱与主页信息。9.hash存放加密后的 GitHub Token这是 Mirror 配置中最需要小心的一项。GitHub GraphQL API 需要 Token 鉴权而 Mirror 不会让你把 Token 明文写进页面——它通过 src/helper/secret.js 提供的加密函数对 Token 做简单混淆处理生成的字符串就填在hash字段里。具体做法在浏览器控制台调用window.encrypt(你的Token)把返回的加密串填入hash。注意host参数会影响加密结果改域名后需重新生成。10.host绑定自定义域名host用于指定站点的域名默认mirror.am0200.com。它有两个作用一是参与 Token 加密校验防止 Token 被复制到其他站点使用见 src/helper/secret.js二是配合项目根目录的 CNAME 文件实现自定义域名的绑定。三、完整配置示例与个性化建议把以上参数组合起来一份典型的 Mirror 配置长这样script window.config { organization: false, order: UPDATED_AT, title: 我的技术博客, user: your-name, repository: my-blog, authors: your-name, ignores: 1,2, host: blog.example.com, hash: 由window.encrypt生成的加密串, perpage: 8, } /script个性化小贴士改风格项目样式全部位于 src/style 目录如 index.less、posts.less改完重新构建即可。开评论文章页的评论模块源码在 src/api/comments.js每条 Issue 评论都会渲染为博客评论。修路由页面切换逻辑在 src/router/index.js支持/posts/:id这样的动态路由。四、构建与发布三步上线你的 GitHub 博客配置完成后按以下步骤构建并部署拉取源码git clone https://gitcode.com/gh_mirrors/mirror9/Mirror安装依赖并构建在项目根目录执行npm install然后运行npm run build构建配置见 falco.config.js产物输出到 docs 目录入口为 src/index.js。部署将构建生成的docs目录托管到 GitHub Pages、Gitee Pages 或任意静态服务器把域名填进host与 CNAME 即可。五、常见问题速查现象排查方向页面一直 Loading检查user/repository是否拼写正确Token 是否有效文章排序不对确认order只填CREATED_AT或UPDATED_AT某条 Issue 莫名出现把它加入ignores列表换域名后报错用新域名重新执行window.encrypt更新hash组织头像不显示将organization改为true掌握了这 10 个核心参数你就已经完成了Mirror 配置的 90%。剩下的 10% 交给想象力——GitHub 博客的优雅与自由值得你亲自体验一次。【免费下载链接】MirrorA blogging tool powered by GitHub API. Write your blog on GitHub issue.项目地址: https://gitcode.com/gh_mirrors/mirror9/Mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考