后端前端CLI【免费下载链接】FreshRSSA free, self-hostable news aggregator…项目地址https://gitcode.com/gh_mirrors/fr/FreshRSS点击查看免费下载本篇指南面向希望参与 FreshRSS 文档编写、或想要在本地预览文档站点的开发者完整讲解 FreshRSS 官方文档仓库的构建原理与本地运行方法从环境准备、依赖安装、本地服务启动到 docs/_config.yml 站点配置与多语言文档结构的深度剖析。读完本文你将能够在本地一键启动文档站点、理解 Jekyll 构建管线的工作方式并掌握与 FreshRSS 主仓库开发流程联动的文档维护方法。一、docs/README.md 的定位文档站点的操作入口FreshRSS 的文档源码存放在仓库根目录的 docs 目录中其开篇 docs/README.md 第一行就明确了该目录的使命This is the documentation deployed by GitHub Pages.即docs/下的全部内容正是通过 GitHub Pages 构建并对外发布的那份用户手册、管理员手册与开发者手册。这份文件本身并不讲解 FreshRSS 的使用方法而是告诉每一位文档贡献者如何把文档站在本地跑起来——这是参与文档工作前必须读的第一份文件。整个文档体系在docs/目录下分为两套语言en/与fr/每套语言内部再按受众划分为三大部分对应 docs/en/index.md 中的章节划分users/用户手册例如 docs/en/users/02_First_steps.md 讲述添加订阅源、阅读视图与个性化配置admins/管理员手册覆盖安装、维护与用户管理等任务developers/开发者手册例如 docs/en/developers/01_Index.md 提供开发环境搭建、测试运行与源码结构指引。docs/README.md 给出的本地构建流程只有寥寥几步却是整个文档工作流的核心骨架下面逐一展开。二、环境准备Ruby 与 BundlerFreshRSS 文档站点基于JekyllRuby 生态的静态站点生成器构建因此本地运行的前置条件是拥有可用的 Ruby 环境。具体版本要求并不在 docs/README.md 中列出但从 docs/Gemfile 可以看到对jekyll版本明确锁定为~ 4.3这意味着你需要一个能够安装 Ruby 3.x 时代 Gem 的现代 Ruby 环境通常建议 Ruby 3.0具体以本机 RubyGems 解析 Gemfile 的结果为准。依赖管理使用Bundler。安装 Bundler 与所需 Gem 的标准方式是gem install bundler随后即可进入文档目录执行依赖安装。三、安装依赖bundle install 与 Gemfile 剖析docs/README.md 给出的第一个命令是bundle install该命令需要在docs/目录下执行Bundler 会查找当前目录的Gemfile。它会依据 docs/Gemfile 解析并安装全部 Gem 依赖并生成Gemfile.lock以锁定版本。仓库中已经存在一份 docs/Gemfile.lock因此首次安装时 Bundler 会严格按照锁定的版本安装保证与项目 CI 环境一致。细读 docs/Gemfile可以还原出文档站点的完整技术栈source https://rubygems.org gem jekyll, ~ 4.3 gem kramdown-parser-gfm gem base64 # Stdlib in Ruby 3.3, gem in 3.4; pulled in by safe_yaml. group :jekyll_plugins do gem jekyll-coffeescript gem jekyll-commonmark gem jekyll-gist gem jekyll-github-metadata gem jekyll-relative-links gem jekyll-optional-front-matter gem jekyll-readme-index gem jekyll-default-layout gem jekyll-titles-from-headings gem jekyll-i18n_tags end逐项解读Gem作用jekyll ~ 4.3站点生成器核心锁定 4.3.x 系列版本kramdown-parser-gfm提供 GitHub Flavored Markdown 解析表格、删除线、自动链接等base64Ruby 3.4 中移出标准库的 stdlib 包由safe_yaml间接依赖显式声明以兼容新旧 Ruby 版本jekyll-coffeescript支持在站点中使用 CoffeeScript 资源jekyll-commonmark启用 CommonMark 规范的 Markdown 渲染后端与_config.yml中markdown: CommonMark对应jekyll-gist支持嵌入 GitHub Gist 代码片段jekyll-github-metadata向站点注入仓库元数据用于 GitHub Pages 环境jekyll-relative-links将 Markdown 中的相对链接在构建时转换为最终 HTML 链接jekyll-optional-front-matter允许没有 YAML front matter 的 Markdown 文件也参与构建jekyll-readme-index将目录下的 README 自动作为该目录索引页jekyll-default-layout为未指定布局的页面自动套用默认布局jekyll-titles-from-headings从页面 H1 标题自动提取title元数据jekyll-i18n_tags提供{%t %}等多语言翻译标签自定义插件见下文导航部分值得注意这份插件清单正是 GitHub Pages 官方允许的 Jekyll 插件白名单子集与docs/ 由 GitHub Pages 部署的定位完全吻合——本地构建与线上部署使用同一套插件保证渲染结果一致。四、本地启动bundle exec jekyll serve 逐参数拆解依赖安装完成后docs/README.md 给出的第二个命令是bundle exec jekyll serve -H 127.0.0.1 --watch --incremental逐参数说明其作用bundle exec确保使用 Gemfile 中锁定的 Gem 版本执行而不是系统中其他版本避免环境漂移jekyll serve启动内置的本地 HTTP 服务器并执行一次构建-H 127.0.0.1将监听地址绑定到回环地址localhost。这是安全默认值——只允许本机访问不向局域网开放适合开发预览。若需要在同一局域网内的其他设备如手机上预览可改为-H 0.0.0.0但应知晓其暴露面--watch监听docs/下的文件变化任何 Markdown、模板或配置修改都会触发自动重建无需手动重启--incremental启用增量构建模式只重新生成发生变化的页面大幅缩短大文档站点下的重建时间与--watch配合可显著提升编辑-预览循环的效率。启动成功后终端会输出类似Server address: http://127.0.0.1:4000/的信息而 docs/README.md 明确给出了实际访问地址The documentation should be reachable at http://127.0.0.1:4000/FreshRSS/.地址中带/FreshRSS/前缀并非偶然而是与 docs/_config.yml 中的关键配置直接对应baseurl: /FreshRSSbaseurl决定了站点所有资源与页面的 URL 前缀。GitHub Pages 将 FreshRSS 文档部署在freshrss.github.io/FreshRSS/路径下因此本地开发时也必须带上相同前缀才能正确解析资源引用这也是 docs/README.md 特意强调完整地址的原因。若直接访问 http://127.0.0.1:4000/ 根路径通常会 404 或出现资源路径错误。五、站点配置深度剖析docs/_config.ymldocs/_config.yml 是文档站点的总配置除上文提到的baseurl外还有几处值得文档贡献者关注title: FreshRSS description: Documentation center baseurl: /FreshRSS logo: /img/FreshRSS-logo.png include: [contributing.md] exclude: [CHANGELOG*.md, README.md, vendor]include: [contributing.md]Jekyll 默认忽略以_开头及部分特殊文件contributing.md需要显式包含才会被构建对应docs/en/contributing.md与docs/fr/contributing.mdexclude排除CHANGELOG*.md、README.md与vendor目录防止它们被当成文档页面发布——这解释了为什么仓库根目录的 CHANGELOG 不会混入文档站点。多语言与 Markdown 渲染相关配置defaults: - scope: path: en values: lang: en - scope: path: fr values: lang: fr markdown: CommonMark commonmark: options: [SMART, FOOTNOTES, UNSAFE] extensions: [strikethrough, autolink, table, tagfilter] highlighter: rougedefaults按路径前缀为en/、fr/下的所有页面注入lang元数据供模板做语言分支判断markdown: CommonMark配合commonmark的options与extensions启用智能标点SMART、脚注FOOTNOTES、删除线、自动链接、表格与标签过滤highlighter: rouge代码块语法高亮方案。translations块含back_to_freshrss、search_docs、toggle_aside等键值则配合jekyll-i18n_tags插件为模板中的{%t choose_language %}一类标签提供英/法双语字符串实现导航与界面文案的语言切换。六、文档结构与多语言导航模板docs/README.md 本身不展开导航细节但理解构建结果如何组织对贡献者定位文件至关重要。语言切换由 docs/_includes/lang_dropdown.html 实现模板中硬编码了en与fr两个入口并通过{%t %}标签渲染界面文案。侧边导航由 docs/_includes/docs_nav.html 驱动其逻辑体现了文档站点的组织方式当page.lang en时渲染 Home、User manual、Administrator manual、Developer manual、Contributor guidelines 五个一级入口用户手册、管理员手册、开发者手册三个子菜单通过遍历site.pages自动生成凡是 URL 包含/en/users/、/en/admins/、/en/developers/且带有title的页面都会按顺序出现在对应菜单下——新增文档只需放入对应目录并写好标题导航会自动收录无需手工维护菜单列表法语分支page.lang fr则注释掉了管理员手册!-- TODO: French doesnt have admin docs --如实反映当前法语文档仅覆盖用户与开发者两部分的事实。这种约定优于配置的组织方式让多语言文档的维护成本显著降低。七、与主仓库开发流程的联动docs/README.md 面向的是文档贡献者但 FreshRSS 的文档与代码开发是紧密咬合的构建文档站点的技能可以直接复用到主仓库的开发流程中开发环境一致性开发者手册 docs/en/developers/02_First_steps.md 中说明FreshRSS 使用自制框架 Minz依赖直接内置于源码无需 Composer。文档站点的bundle install与此类似——都是进入对应目录、安装依赖、启动服务的三步式工作流。Makefile 中的 Docker 工作流仓库根目录 Makefile 定义了make start、make stop、make build、make test-all等命令其中TAG默认alpine、端口默认8080与文档中本地 4000 端口预览文档、8080 端口预览应用形成互补构成完整的本地双栈开发环境。i18n 数据同步文档中的翻译进度表如 20 语言由 cli/check.translation.php 自动生成见 README.md 中translations注释而文档站点的jekyll-i18n_tags插件则负责界面文案的翻译两者共同维护项目的多语言体系。文档内容引用源码手册中大量章节指向真实源码与配置例如安装章节指向 config.default.php 与 cli/README.md开发章节指向 AGENTS.md人类与 AI Agent 共同的编码规范。修改文档时应同步核对这些引用路径是否仍然有效。八、常见问题与排错结合上文原理梳理几个本地构建时的高频问题现象原因与解法bundle: command not foundBundler 未安装先执行gem install bundlerbundle install报 Ruby 版本不兼容本机 Ruby 过旧低于 Jekyll 4.3 要求的 Ruby 版本需升级 Ruby 或使用 rbenv/rvm 切换版本访问http://127.0.0.1:4000/出现 404忘记baseurl前缀应访问http://127.0.0.1:4000/FreshRSS/修改 Markdown 后页面未更新确认--watch --incremental已启用若改动的是_config.yml或模板文件增量模式可能不生效重启jekyll serve即可端口被占用4000 端口被其他进程占用时可用--port 4001指定新端口但访问 URL 的前缀/FreshRSS/不变新增页面未出现在导航中检查文件是否位于正确的en/或fr/子目录、文件是否包含带title的 YAML front matter或依赖jekyll-titles-from-headings从 H1 提取九、从本地预览到线上部署docs/README.md 明确指出当前文档即由 GitHub Pages 部署。本地工作流与线上发布的关系如下本地通过bundle installbundle exec jekyll serve预览与调试文档内容提交docs/目录下的 Markdown、模板与配置变更GitHub Pages 侧使用与 docs/Gemfile 相同的插件白名单自动构建产出站点部署到/FreshRSS/路径由于本地与线上共用同一份 Gemfile 与_config.yml可最大限度地保证本地所见即线上所得。因此参与文档维护的完整闭环可以总结为读懂 docs/README.md 的启动步骤 → 理解 Gemfile 与 _config.yml 的构建管线 → 在正确目录中编写带 front matter 的 Markdown → 本地增量预览 → 提交并由 GitHub Pages 自动发布。掌握这一流程后你既能高效维护 FreshRSS 的官方文档也能将其迁移到任何基于 Jekyll 的文档站点项目中。赞分享后端前端CLI【免费下载链接】FreshRSSA free, self-hostable news aggregator…项目地址https://gitcode.com/gh_mirrors/fr/FreshRSS点击查看免费下载相关推荐InstaPy 文档站点实战基于 Docusaurus 2 构建、本地开发与 GitHub Pages 部署全流程InstaPy 文档站点实战基于 Docusaurus 2 构建、本地开发与 GitHub Pages 部署全流程 本篇以仓库中的 docusaurus/RERPA社交工作流自动化Hindsight 官方文档站构建指南基于 Docusaurus 的本地开发、构建与部署全流程Hindsight 官方文档站构建指南基于 Docusaurus 的本地开发、构建与部署全流程 本指南围绕 hindsight docs/README.md人工智能AI AgentAgent 记忆MCP 服务ExoPlayer 官方文档网站剖析基于 Jekyll 与 GitHub Pages 的静态站点构建与本地预览实战ExoPlayer 官方文档网站剖析基于 Jekyll 与 GitHub Pages 的静态站点构建与本地预览实战 本文围绕 ExoPlayer 仓库中的 d音视频移动开发上一篇超实用Flink调优指南任务并行度与槽位配置全解析下一篇Symfony Certification Preparation List社区贡献指南如何为项目添砖加瓦创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 FreshRSS 文档站点本地构建指南：基于 Jekyll 与 GitHub Pages 的开发与部署全流程
后端前端CLI【免费下载链接】FreshRSSA free, self-hostable news aggregator…项目地址https://gitcode.com/gh_mirrors/fr/FreshRSS点击查看免费下载本篇指南面向希望参与 FreshRSS 文档编写、或想要在本地预览文档站点的开发者完整讲解 FreshRSS 官方文档仓库的构建原理与本地运行方法从环境准备、依赖安装、本地服务启动到 docs/_config.yml 站点配置与多语言文档结构的深度剖析。读完本文你将能够在本地一键启动文档站点、理解 Jekyll 构建管线的工作方式并掌握与 FreshRSS 主仓库开发流程联动的文档维护方法。一、docs/README.md 的定位文档站点的操作入口FreshRSS 的文档源码存放在仓库根目录的 docs 目录中其开篇 docs/README.md 第一行就明确了该目录的使命This is the documentation deployed by GitHub Pages.即docs/下的全部内容正是通过 GitHub Pages 构建并对外发布的那份用户手册、管理员手册与开发者手册。这份文件本身并不讲解 FreshRSS 的使用方法而是告诉每一位文档贡献者如何把文档站在本地跑起来——这是参与文档工作前必须读的第一份文件。整个文档体系在docs/目录下分为两套语言en/与fr/每套语言内部再按受众划分为三大部分对应 docs/en/index.md 中的章节划分users/用户手册例如 docs/en/users/02_First_steps.md 讲述添加订阅源、阅读视图与个性化配置admins/管理员手册覆盖安装、维护与用户管理等任务developers/开发者手册例如 docs/en/developers/01_Index.md 提供开发环境搭建、测试运行与源码结构指引。docs/README.md 给出的本地构建流程只有寥寥几步却是整个文档工作流的核心骨架下面逐一展开。二、环境准备Ruby 与 BundlerFreshRSS 文档站点基于JekyllRuby 生态的静态站点生成器构建因此本地运行的前置条件是拥有可用的 Ruby 环境。具体版本要求并不在 docs/README.md 中列出但从 docs/Gemfile 可以看到对jekyll版本明确锁定为~ 4.3这意味着你需要一个能够安装 Ruby 3.x 时代 Gem 的现代 Ruby 环境通常建议 Ruby 3.0具体以本机 RubyGems 解析 Gemfile 的结果为准。依赖管理使用Bundler。安装 Bundler 与所需 Gem 的标准方式是gem install bundler随后即可进入文档目录执行依赖安装。三、安装依赖bundle install 与 Gemfile 剖析docs/README.md 给出的第一个命令是bundle install该命令需要在docs/目录下执行Bundler 会查找当前目录的Gemfile。它会依据 docs/Gemfile 解析并安装全部 Gem 依赖并生成Gemfile.lock以锁定版本。仓库中已经存在一份 docs/Gemfile.lock因此首次安装时 Bundler 会严格按照锁定的版本安装保证与项目 CI 环境一致。细读 docs/Gemfile可以还原出文档站点的完整技术栈source https://rubygems.org gem jekyll, ~ 4.3 gem kramdown-parser-gfm gem base64 # Stdlib in Ruby 3.3, gem in 3.4; pulled in by safe_yaml. group :jekyll_plugins do gem jekyll-coffeescript gem jekyll-commonmark gem jekyll-gist gem jekyll-github-metadata gem jekyll-relative-links gem jekyll-optional-front-matter gem jekyll-readme-index gem jekyll-default-layout gem jekyll-titles-from-headings gem jekyll-i18n_tags end逐项解读Gem作用jekyll ~ 4.3站点生成器核心锁定 4.3.x 系列版本kramdown-parser-gfm提供 GitHub Flavored Markdown 解析表格、删除线、自动链接等base64Ruby 3.4 中移出标准库的 stdlib 包由safe_yaml间接依赖显式声明以兼容新旧 Ruby 版本jekyll-coffeescript支持在站点中使用 CoffeeScript 资源jekyll-commonmark启用 CommonMark 规范的 Markdown 渲染后端与_config.yml中markdown: CommonMark对应jekyll-gist支持嵌入 GitHub Gist 代码片段jekyll-github-metadata向站点注入仓库元数据用于 GitHub Pages 环境jekyll-relative-links将 Markdown 中的相对链接在构建时转换为最终 HTML 链接jekyll-optional-front-matter允许没有 YAML front matter 的 Markdown 文件也参与构建jekyll-readme-index将目录下的 README 自动作为该目录索引页jekyll-default-layout为未指定布局的页面自动套用默认布局jekyll-titles-from-headings从页面 H1 标题自动提取title元数据jekyll-i18n_tags提供{%t %}等多语言翻译标签自定义插件见下文导航部分值得注意这份插件清单正是 GitHub Pages 官方允许的 Jekyll 插件白名单子集与docs/ 由 GitHub Pages 部署的定位完全吻合——本地构建与线上部署使用同一套插件保证渲染结果一致。四、本地启动bundle exec jekyll serve 逐参数拆解依赖安装完成后docs/README.md 给出的第二个命令是bundle exec jekyll serve -H 127.0.0.1 --watch --incremental逐参数说明其作用bundle exec确保使用 Gemfile 中锁定的 Gem 版本执行而不是系统中其他版本避免环境漂移jekyll serve启动内置的本地 HTTP 服务器并执行一次构建-H 127.0.0.1将监听地址绑定到回环地址localhost。这是安全默认值——只允许本机访问不向局域网开放适合开发预览。若需要在同一局域网内的其他设备如手机上预览可改为-H 0.0.0.0但应知晓其暴露面--watch监听docs/下的文件变化任何 Markdown、模板或配置修改都会触发自动重建无需手动重启--incremental启用增量构建模式只重新生成发生变化的页面大幅缩短大文档站点下的重建时间与--watch配合可显著提升编辑-预览循环的效率。启动成功后终端会输出类似Server address: http://127.0.0.1:4000/的信息而 docs/README.md 明确给出了实际访问地址The documentation should be reachable at http://127.0.0.1:4000/FreshRSS/.地址中带/FreshRSS/前缀并非偶然而是与 docs/_config.yml 中的关键配置直接对应baseurl: /FreshRSSbaseurl决定了站点所有资源与页面的 URL 前缀。GitHub Pages 将 FreshRSS 文档部署在freshrss.github.io/FreshRSS/路径下因此本地开发时也必须带上相同前缀才能正确解析资源引用这也是 docs/README.md 特意强调完整地址的原因。若直接访问 http://127.0.0.1:4000/ 根路径通常会 404 或出现资源路径错误。五、站点配置深度剖析docs/_config.ymldocs/_config.yml 是文档站点的总配置除上文提到的baseurl外还有几处值得文档贡献者关注title: FreshRSS description: Documentation center baseurl: /FreshRSS logo: /img/FreshRSS-logo.png include: [contributing.md] exclude: [CHANGELOG*.md, README.md, vendor]include: [contributing.md]Jekyll 默认忽略以_开头及部分特殊文件contributing.md需要显式包含才会被构建对应docs/en/contributing.md与docs/fr/contributing.mdexclude排除CHANGELOG*.md、README.md与vendor目录防止它们被当成文档页面发布——这解释了为什么仓库根目录的 CHANGELOG 不会混入文档站点。多语言与 Markdown 渲染相关配置defaults: - scope: path: en values: lang: en - scope: path: fr values: lang: fr markdown: CommonMark commonmark: options: [SMART, FOOTNOTES, UNSAFE] extensions: [strikethrough, autolink, table, tagfilter] highlighter: rougedefaults按路径前缀为en/、fr/下的所有页面注入lang元数据供模板做语言分支判断markdown: CommonMark配合commonmark的options与extensions启用智能标点SMART、脚注FOOTNOTES、删除线、自动链接、表格与标签过滤highlighter: rouge代码块语法高亮方案。translations块含back_to_freshrss、search_docs、toggle_aside等键值则配合jekyll-i18n_tags插件为模板中的{%t choose_language %}一类标签提供英/法双语字符串实现导航与界面文案的语言切换。六、文档结构与多语言导航模板docs/README.md 本身不展开导航细节但理解构建结果如何组织对贡献者定位文件至关重要。语言切换由 docs/_includes/lang_dropdown.html 实现模板中硬编码了en与fr两个入口并通过{%t %}标签渲染界面文案。侧边导航由 docs/_includes/docs_nav.html 驱动其逻辑体现了文档站点的组织方式当page.lang en时渲染 Home、User manual、Administrator manual、Developer manual、Contributor guidelines 五个一级入口用户手册、管理员手册、开发者手册三个子菜单通过遍历site.pages自动生成凡是 URL 包含/en/users/、/en/admins/、/en/developers/且带有title的页面都会按顺序出现在对应菜单下——新增文档只需放入对应目录并写好标题导航会自动收录无需手工维护菜单列表法语分支page.lang fr则注释掉了管理员手册!-- TODO: French doesnt have admin docs --如实反映当前法语文档仅覆盖用户与开发者两部分的事实。这种约定优于配置的组织方式让多语言文档的维护成本显著降低。七、与主仓库开发流程的联动docs/README.md 面向的是文档贡献者但 FreshRSS 的文档与代码开发是紧密咬合的构建文档站点的技能可以直接复用到主仓库的开发流程中开发环境一致性开发者手册 docs/en/developers/02_First_steps.md 中说明FreshRSS 使用自制框架 Minz依赖直接内置于源码无需 Composer。文档站点的bundle install与此类似——都是进入对应目录、安装依赖、启动服务的三步式工作流。Makefile 中的 Docker 工作流仓库根目录 Makefile 定义了make start、make stop、make build、make test-all等命令其中TAG默认alpine、端口默认8080与文档中本地 4000 端口预览文档、8080 端口预览应用形成互补构成完整的本地双栈开发环境。i18n 数据同步文档中的翻译进度表如 20 语言由 cli/check.translation.php 自动生成见 README.md 中translations注释而文档站点的jekyll-i18n_tags插件则负责界面文案的翻译两者共同维护项目的多语言体系。文档内容引用源码手册中大量章节指向真实源码与配置例如安装章节指向 config.default.php 与 cli/README.md开发章节指向 AGENTS.md人类与 AI Agent 共同的编码规范。修改文档时应同步核对这些引用路径是否仍然有效。八、常见问题与排错结合上文原理梳理几个本地构建时的高频问题现象原因与解法bundle: command not foundBundler 未安装先执行gem install bundlerbundle install报 Ruby 版本不兼容本机 Ruby 过旧低于 Jekyll 4.3 要求的 Ruby 版本需升级 Ruby 或使用 rbenv/rvm 切换版本访问http://127.0.0.1:4000/出现 404忘记baseurl前缀应访问http://127.0.0.1:4000/FreshRSS/修改 Markdown 后页面未更新确认--watch --incremental已启用若改动的是_config.yml或模板文件增量模式可能不生效重启jekyll serve即可端口被占用4000 端口被其他进程占用时可用--port 4001指定新端口但访问 URL 的前缀/FreshRSS/不变新增页面未出现在导航中检查文件是否位于正确的en/或fr/子目录、文件是否包含带title的 YAML front matter或依赖jekyll-titles-from-headings从 H1 提取九、从本地预览到线上部署docs/README.md 明确指出当前文档即由 GitHub Pages 部署。本地工作流与线上发布的关系如下本地通过bundle installbundle exec jekyll serve预览与调试文档内容提交docs/目录下的 Markdown、模板与配置变更GitHub Pages 侧使用与 docs/Gemfile 相同的插件白名单自动构建产出站点部署到/FreshRSS/路径由于本地与线上共用同一份 Gemfile 与_config.yml可最大限度地保证本地所见即线上所得。因此参与文档维护的完整闭环可以总结为读懂 docs/README.md 的启动步骤 → 理解 Gemfile 与 _config.yml 的构建管线 → 在正确目录中编写带 front matter 的 Markdown → 本地增量预览 → 提交并由 GitHub Pages 自动发布。掌握这一流程后你既能高效维护 FreshRSS 的官方文档也能将其迁移到任何基于 Jekyll 的文档站点项目中。赞分享后端前端CLI【免费下载链接】FreshRSSA free, self-hostable news aggregator…项目地址https://gitcode.com/gh_mirrors/fr/FreshRSS点击查看免费下载相关推荐InstaPy 文档站点实战基于 Docusaurus 2 构建、本地开发与 GitHub Pages 部署全流程InstaPy 文档站点实战基于 Docusaurus 2 构建、本地开发与 GitHub Pages 部署全流程 本篇以仓库中的 docusaurus/RERPA社交工作流自动化Hindsight 官方文档站构建指南基于 Docusaurus 的本地开发、构建与部署全流程Hindsight 官方文档站构建指南基于 Docusaurus 的本地开发、构建与部署全流程 本指南围绕 hindsight docs/README.md人工智能AI AgentAgent 记忆MCP 服务ExoPlayer 官方文档网站剖析基于 Jekyll 与 GitHub Pages 的静态站点构建与本地预览实战ExoPlayer 官方文档网站剖析基于 Jekyll 与 GitHub Pages 的静态站点构建与本地预览实战 本文围绕 ExoPlayer 仓库中的 d音视频移动开发上一篇超实用Flink调优指南任务并行度与槽位配置全解析下一篇Symfony Certification Preparation List社区贡献指南如何为项目添砖加瓦创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考