위키 설정

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

GitLab 인스턴스의 위키 설정을 조정합니다.

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

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

작동 방식

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

기존 위키 페이지를 깨뜨리지 않기 위해, 제한은 기존 위키 페이지가 다시 편집되고 콘텐츠가 변경될 때까지 적용되지 않습니다.

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

이 설정은 관리자 영역 설정을 통해서는 사용할 수 없습니다. 이 설정을 구성하려면 Rails 콘솔이나 응용 프로그램 설정 API를 사용하세요.

참고: 제한 값은 바이트 단위여야 합니다. 최솟값은 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를 통해

응용 프로그램 설정 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를 사용하여 다음을 실행할 수 있습니다: 현재 응용 프로그램 설정 가져오기.

위키 저장소 크기 축소

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

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

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"

관련 주제