正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

Wiki設定

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab Self-Managed

GitLabインスタンスのWiki設定を調整します。

Wikiページのコンテンツサイズ制限

Wikiページの最大コンテンツサイズ制限を設定できます。この制限により、機能の悪用を防ぐことができます。デフォルト値は5242880バイト(5 MB)です。

どのように機能しますか?

コンテンツサイズの制限は、WikiページがGitLab UIまたはAPIを介して作成または更新されたときに適用されます。Git経由でプッシュされたローカルの変更は検証されません。

既存のWikiページを中断するために、Wikiページが再度編集され、コンテンツが変更されるまで、制限は有効になりません。

Wikiページのコンテンツサイズ制限の設定

この設定は、管理者エリアの設定からは使用できません。この設定を構成するには、RailsコンソールまたはApplication設定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: 5.megabytes)

現在の値を取得するには、Railsコンソールを起動して、以下を実行します:

Gitlab::CurrentSettings.wiki_page_max_content_bytes

APIを使用します

Application設定APIからWikiページのサイズ制限を設定するには、他の設定を更新するのと同じように、コマンドを使用します:

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

APIを使用して現在の値を取得することもできます:

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

Wikiリポジトリのサイズを縮小する

Wikiはネームスペースストレージサイズの一部としてカウントされるため、Wikiリポジトリをできるだけコンパクトに保つ必要があります。

リポジトリをコンパクトにするツールの詳細については、リポジトリサイズの縮小に関するドキュメントを参照してください。

AsciiDocのURIインポートを許可する

インポートディレクティブは、個別のページまたは外部URIからコンテンツをインポートし、現在のドキュメントのコンテンツの一部として表示します。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. AsciiDocのURIインポートを許可するようにWikiを更新します:

    ApplicationSetting.first.update!(wiki_asciidoc_allow_uri_includes: true)

インポートが有効になっているかどうかを確認するには、Railsコンソールを起動して、以下を実行します:

Gitlab::CurrentSettings.wiki_asciidoc_allow_uri_includes

APIを使用します

Application設定APIを介してAsciiDocのURIインポートを許可するようにWikiを設定するには、curlコマンドを使用します:

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