技术¶

如何关闭 Cloudflare Pages 的 Access Policy 功能

Access Policy 这个功能又容易一不小心打开，又难关掉。想要在 dashboard 关，必须得开通一个方案，而免费方案还必须要银行卡才能开通，一切都显得非常荒谬。

它甚至会把我自己拦在我自己网站的预览分支外面！我点了发送以后，从来没收到过那个所谓的「验证码」！

所幸，在群文档预览分支功能被 Access Policy 陷害了两三个月之后，社区又一次为我提供了解决方案。

Cloudflare Pages 有一个问题，就是没有设定 fetch 深度的选项。默认只会到最新一次提交，于是所有时间都变成了构建当天的日期。

光是时间不对也就算了。MkDocs 的 RSS 插件甚至还会报错 IndexError！

怎么解决呢？我在 RSS 插件的 issues 列表里找到了办法。

文档历史说明

本文档最早位于 PumpkinJui/sk-api，于 sk-api@9b49714 添加。后因内容整合，于 sk-api@867eaeb 迁出。

迁出后，本文档进行了 MkDocs 适配，并进行了补充和完善。

通过调用大模型 API，在 Python 或 CLI 中进行 AI 对话补全。

文档历史说明

本文档最早位于群文档，于 groupdocs@2ba4aaa 添加，作为编写参考。后因群文档迁移至 Docusaurus 而失去其原有作用，特此于 groupdocs@d1d1b43 迁出。

迁出后，本文档进行了 MkDocs 适配，并对一些问题进行更新。感谢 @鸽子对此次更新的贡献。

本文档之目的为，在已有 GitBook 文档项目的前提下，通过 GitBook-cli 进行预览。文档假设您基本没有使用命令行的经验。

GitBook-cli 是 CloudFlare Pages 构建时可以选择使用的框架之一。它是现在的 GitBook.com Platform 的前身，随开发重心转移而被搁置。

As the efforts of the GitBook team are focused on the GitBook.com platform, the CLI is no longer under active development.

在群文档的建设中，一般需要在推送更改后等待 CF Pages 更新，然后查看是否有 bug，将 bug 修复后再次提交并推送。这样很不方便，而且一次提交能解决的事情，为什么要两次提交解决呢？

后来，群文档将 GitBook-cli 使用的 Markdown 语法作为归档类文件添加，以期有所改善。但查看文档 (甚至是全英的文档)，怎么能比得上自己用相同的框架打包一次来得快、准确和可靠呢？

因此，作为 groupdocs#21 的解决方案，我们将在本文中指导您如何安装 GitBook-cli，及如何利用它进行测试。

在下文中，我们就分别在 Termux 平台和 Windows 平台指导您安装它。