Help us learn about your current experience with the documentation. Take the survey.

Wiki 设置

  • 版本：免费版、专业版、旗舰版
  • 产品：GitLab Self-Managed

调整您 GitLab 实例的 Wiki 设置。

Wiki 页面内容大小限制

您可以为 Wiki 页面设置最大内容大小限制。此限制可以防止该功能被滥用。默认值为 52428800 Bytes (50 MB)。

它是如何工作的？

当通过 GitLab 界面 (UI) 或 API 创建或更新 Wiki 页面时，内容大小限制会生效。通过 Git 推送的本地更改则不会进行验证。

为避免影响现有的 Wiki 页面，该限制在页面被再次编辑且内容发生更改前不会生效。

Wiki 页面内容大小限制配置

此设置无法通过 管理员区域设置 进行配置。要配置此设置，请使用 Rails 控制台或 应用程序设置 API。

限制值必须以字节为单位。最小值为 1024 字节。

通过 Rails 控制台

要通过 Rails 控制台配置此设置：

  1. 启动 Rails 控制台：

    # For Omnibus installations
sudo gitlab-rails console

# For installations from source
sudo -u git -H bundle exec rails console -e production

  2. 更新 Wiki 页面最大内容大小：

    ApplicationSetting.first.update!(wiki_page_max_content_bytes: 50.megabytes)

要获取当前值，请启动 Rails 控制台并运行：

Gitlab::CurrentSettings.wiki_page_max_content_bytes

通过 API

要通过应用程序设置 API 设置 Wiki 页面大小限制，请使用如下命令，就像您 更新任何其他设置 一样：

curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/application/settings?wiki_page_max_content_bytes=52428800"

您也可以使用 API 来 获取当前值：

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/application/settings"

缩减 Wiki 仓库大小

Wiki 会计入 命名空间存储大小 的一部分，因此您应尽可能让 Wiki 仓库保持精简。

有关用于压缩仓库的工具的更多信息，请阅读关于 缩减仓库大小 的文档。

允许 AsciiDoc 包含 URI

包含指令 (Include directives) 会从独立页面或外部 URL 导入内容，并将其作为当前文档内容的一部分进行显示。要启用 AsciiDoc 包含功能，请通过 Rails 控制台或 API 启用该功能。

通过 Rails 控制台

要通过 Rails 控制台配置此设置：

  1. 启动 Rails 控制台：

    # For Omnibus installations
sudo gitlab-rails console

# For installations from source
sudo -u git -H bundle exec rails console -e production

  2. 更新 Wiki 以允许 AsciiDoc 包含 URI：

    ApplicationSetting.first.update!(wiki_asciidoc_allow_uri_includes: true)

要检查是否已启用包含功能，请启动 Rails 控制台并运行：

Gitlab::CurrentSettings.wiki_asciidoc_allow_uri_includes

通过 API

要通过 应用程序设置 API 设置 Wiki 以允许 AsciiDoc 包含 URI，请使用 curl 命令：

curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" \
  "https://gitlab.example.com/api/v4/application/settings?wiki_asciidoc_allow_uri_includes=true"

相关主题