재사용 가능 요소 정보
재사용 가능 단락이나 절차 목록과 같은 재사용 가능한 텍스트의 긴 문자열로, 여러 콘텐츠 파일에서 참조할 수 있습니다.
재사용 가능 항목에는 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 %}로 액세스할 수 있습니다.