도움말 페이지 메시지 사용자 정의

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

대규모 조직에서는 도움이 필요할 때 누구에게 연락해야 하는지 또는 어디로 가야 하는지에 대한 정보가 유용합니다. GitLab /help 페이지에 이 정보를 사용자 정의하고 표시할 수 있습니다.

도움말 메시지를 도움말 페이지에 추가

GitLab /help 페이지 상단에 표시되는 도움말 메시지를 추가할 수 있습니다(예: https://gitlab.com/help):

  1. 왼쪽 사이드바에서 아래쪽에 있는 관리자를 선택합니다.
  2. 설정 > 기본 환경을 선택합니다.
  3. 도움말 페이지를 확장합니다.
  4. 도움말 페이지에 표시할 추가 텍스트란에 표시하고 싶은 정보를 입력합니다.
  5. 변경 사항 저장을 선택합니다.

이제 /help에서 메시지를 볼 수 있습니다.

참고: 기본적으로 /help은 인증되지 않은 사용자에게 표시됩니다. 그러나 공개 가시성 수준이 제한되면 /help은 인증된 사용자만 볼 수 있습니다.

로그인 페이지에 도움말 메시지 추가

  • 로그인 페이지에 표시할 추가 텍스트는 GitLab 17.0에서 사용 중지됨니다.

로그인 페이지에 도움말 메시지를 추가하려면 로그인 및 등록 페이지를 사용자 정의합니다.

도움말 페이지에서 마케팅 관련 항목 숨기기

GitLab 마케팅 관련 항목은 때때로 도움말 페이지에 표시됩니다. 이러한 항목을 숨기려면:

  1. 왼쪽 사이드바에서 아래쪽에 있는 관리자를 선택합니다.
  2. 설정 > 기본 환경을 선택합니다.
  3. 도움말 페이지를 확장합니다.
  4. 도움말 페이지에서 마케팅 관련 항목 숨기기 확인란을 선택합니다.
  5. 변경 사항 저장을 선택합니다.

사용자 정의 지원 페이지 URL 설정

사용자가:

  • 도움말 > 지원을 선택합니다.
  • 도움말 페이지의 웹 사이트에서 도움을 찾아보세요를 선택합니다.

할 때 사용자를 이동시킬 사용자 정의 URL을 지정할 수 있습니다.

  1. 왼쪽 사이드바에서 아래쪽에 있는 관리자를 선택합니다.
  2. 설정 > 기본 환경을 선택합니다.
  3. 도움말 페이지를 확장합니다.
  4. 지원 페이지 URL 필드에 URL을 입력합니다.
  5. 변경 사항 저장을 선택합니다.

/help 페이지 리디렉션

모든 /help 링크를 필요한 요구 사항을 충족하는 대상지로 리디렉션할 수 있습니다.

  1. 왼쪽 사이드바에서 아래쪽에 있는 관리자를 선택합니다.
  2. 설정 > 기본 환경을 선택합니다.
  3. 도움말 페이지를 확장합니다.
  4. 문서 페이지 URL 필드에 URL을 입력합니다.
  5. 변경 사항 저장을 선택합니다.

만약 문서 페이지 URL 필드가 비어 있는 경우, GitLab 인스턴스는 GitLab의 doc 디렉토리에서 소스를 참고해 기본 버전의 문서를 표시합니다.

대상 요구 사항

/help를 리디렉션할 때, GitLab은:

  • 지정된 URL로 요청을 리디렉션합니다.
  • URL에 ee 및 버전 번호를 포함하는 문서 경로를 추가합니다.
  • URL에 .md가 있다면 이를 제거하고 .html을 추가합니다.

예를 들어, URL이 https://docs.gitlab.com로 설정되어 있고, /help/administration/settings/help_page.md에 대한 요청이 온다면: https://docs.gitlab.com/${VERSION}/ee/administration/settings/help_page.html로 리디렉션이 됩니다.