Skip to main content

이 버전의 GitHub Enterprise Server는 다음 날짜에 중단됩니다. 2024-08-29. 중요한 보안 문제에 대해서도 패치 릴리스가 이루어지지 않습니다. 더 뛰어난 성능, 향상된 보안, 새로운 기능을 위해 최신 버전의 GitHub Enterprise Server로 업그레이드합니다. 업그레이드에 대한 도움말은 GitHub Enterprise 지원에 문의하세요.

재사용 가능한 콘텐츠 만들기

여러 콘텐츠 파일에서 참조할 수 있는 재사용 가능한 콘텐츠를 만들 수 있습니다.

재사용 가능 요소 정보

재사용 가능 단락이나 절차 목록과 같은 재사용 가능한 텍스트의 긴 문자열로, 여러 콘텐츠 파일에서 참조할 수 있습니다.

재사용 가능 항목에는 YAML 대신 Markdown을 사용합니다. Markdown을 사용하면 지역화 파이프라인에서 문자열을 번역 가능한 세그먼트로 더 작게 분할할 수 있으므로 원본 영어 콘텐츠를 변경할 때 번역 오류와 변동 사항이 줄어듭니다.

각 재사용 가능 항목은 자체 Markdown 파일에 있습니다.

각 Markdown 파일의 {b>경로<b} 및 {b>파일 이름<b}에 따라 데이터 개체의 경로가 결정됩니다. 예를 들어 페이지의 {% data reusables.foo.bar %}와 같이 /data/reusables/foo/bar.md라는 파일에 액세스할 수 있습니다.

재사용 가능 파일은 일반적으로 작업별로 디렉터리로 나뉩니다. 예를 들어 GitHub 알림에 대한 문서에 대해 재사용 가능한 문자열을 생성하는 경우 data/reusables/notifications/ 디렉터리, data/reusables/notifications/YOUR-REUSABLE-NAME.md 파일에 해당 문자열을 추가합니다. 원본에 추가할 콘텐츠 참조는 {% data reusables.notifications.YOUR-REUSABLE-NAME %}과 같습니다.

재사용 가능 패키지에 버전 관리 적용

재사용 가능 패키지에는 현재 표시된 버전에 따라 콘텐츠를 조건부로 렌더링하는 Liquid 조건부가 포함될 수 있습니다.

변수 정보

변수는 재사용 가능한 텍스트의 긴 문자열입니다.

변수에 YAML 파일을 사용합니다.

각 YAML 파일 내의 {b>경로<b}, {b>파일 이름<b}, {b>키<b}에 따라 데이터 개체 에 어떤 경로가 있는지 결정됩니다.

예를 들어 이 YAML 파일 data/variables/foo/bar.yml은 다음 두 개의 변수를 포함합니다.

# the YAML file can contain multiple short strings in one file
meaning_of_life: 42

# the strings can also be nested if needed
nested:
  values:
    too: Yes!

해당 값은 {% data foo.bar.meaning_of_life %}{% data foo.bar.nested.values.too %}로 액세스할 수 있습니다.