위키 설정

Tier: Free, Premium, Ultimate Offering: Self-managed

GitLab 인스턴스의 위키 설정을 조정하세요.

위키 페이지 콘텐츠 크기 제한

위키 페이지에 대한 최대 콘텐츠 크기 제한을 설정할 수 있습니다. 이 제한은
기능 남용을 방지할 수 있습니다. 기본값은 52428800 Bytes (50 MB)입니다.

작동 방식

콘텐츠 크기 제한은 위키 페이지가 GitLab UI 또는 API를 통해 생성되거나 업데이트될 때 적용됩니다.
Git을 통해 푸시된 로컬 변경 사항은 검증되지 않습니다.

기존 위키 페이지가 손상되지 않도록 하려면,
제한은 위키 페이지가 다시 편집되고 콘텐츠가 변경될 때까지 효력을 발휘하지 않습니다.

위키 페이지 콘텐츠 크기 제한 구성

이 설정은 Admin 영역 설정에서 사용할 수 없습니다.
이 설정을 구성하려면 Rails 콘솔이나 Application settings API를 사용하세요.

note
제한값은 바이트 단위여야 합니다. 최소값은 1024 바이트입니다.

Rails 콘솔을 통한 설정

Rails 콘솔을 통해 이 설정을 구성하려면:

  1. Rails 콘솔을 시작합니다:

    # Omnibus 설치용  
sudo gitlab-rails console  

# 소스에서 설치한 경우  
sudo -u git -H bundle exec rails console -e production

  2. 위키 페이지 최대 콘텐츠 크기를 업데이트합니다:

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

현재 값을 검색하려면 Rails 콘솔을 시작하고 다음을 실행합니다:

   Gitlab::CurrentSettings.wiki_page_max_content_bytes

API를 통한 설정

Application Settings API를 통해 위키 페이지 크기 제한을 설정하려면,
다른 설정을 업데이트하는 방법과 같이 명령을 사용하세요:

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"

위키 저장소 크기 줄이기

위키는 네임스페이스 저장소 크기의 일부로 계산되므로,
위키 저장소를 가능한 한 컴팩트하게 유지해야 합니다.

저장소를 압축하기 위한 도구에 대한 자세한 내용은
저장소 크기 줄이기 문서를 참조하세요.

AsciiDoc에 대한 URI 포함 허용

포함 지시문은 별도의 페이지나 외부 URL에서 콘텐츠를 가져와
현재 문서의 콘텐츠의 일부로 표시합니다. AsciiDoc 포함을 활성화하려면,
Rails 콘솔이나 API를 통해 기능을 활성화하세요.

Rails 콘솔을 통한 설정

Rails 콘솔을 통해 이 설정을 구성하려면:

  1. Rails 콘솔을 시작합니다:

    # Omnibus 설치용  
sudo gitlab-rails console  

# 소스에서 설치한 경우  
sudo -u git -H bundle exec rails console -e production

  2. AsciiDoc에 대한 URI 포함을 허용하도록 위키를 업데이트합니다:

    ApplicationSetting.first.update!(wiki_asciidoc_allow_uri_includes: true)

포함이 활성화되어 있는지 확인하려면, Rails 콘솔을 시작하고 다음을 실행합니다:

   Gitlab::CurrentSettings.wiki_asciidoc_allow_uri_includes

API를 통한

AsciiDoc에 대한 URI 포함을 허용하도록 위키를 설정하려면 애플리케이션 설정 API를 통해 curl 명령어를 사용하십시오:

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

관련 주제