Wiki設定

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

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

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

コンテンツサイズ制限の動作

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

既存のWikiページを壊す場合、Wikiページが再度編集され、コンテンツが変更されるまで、制限は適用されません。

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

この設定は、管理者エリア設定からは利用できません。この設定を設定するには、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ページの最大コンテンツサイズを更新します:

   ApplicationSetting.first.update!(wiki_page_max_content_bytes: 5.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=5242880"

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

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

Wikiリポジトリサイズの削減

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

リポジトリを圧縮するためのツールに関する詳細は、リポジトリサイズの削減に関するドキュメントをお読みください。

AsciiDocでURIインクルードを許可する

インクルードディレクティブは、個別のページまたは外部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. AsciiDocのURIインクルードを許可するようにWikiを更新します:

   ApplicationSetting.first.update!(wiki_asciidoc_allow_uri_includes: true)

インクルードが有効になっているか確認するには、Railsコンソールを起動して実行します:

Gitlab::CurrentSettings.wiki_asciidoc_allow_uri_includes

APIを介して

アプリケーション設定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"

関連トピック

• Wikiのユーザードキュメント
• プロジェクトWiki API
• グループWiki API