콘텐츠로 이동

공유 콘텐츠 테스트 베드

이 섹션은 BeeWare 문서의 나머지 부분에서 사용하기 위해 이 저장소에서 제공되는 공유 콘텐츠를 검증하기 위한 목적으로 포함되었습니다. "공유 콘텐츠"란 여러 다른 저장소에 공통적으로 사용되는 문서 또는 문서의 일부를 의미합니다. 이러한 콘텐츠는 해당 저장소들에 포함시키기 위해 여기에 저장됩니다. 이는 업데이트가 필요할 때 단일 소스가 존재하며, 해당 변경 사항이 해당 공유 콘텐츠를 사용하는 모든 저장소에 반영된다는 것을 의미합니다.

기존 콘텐츠를 업데이트하는 경우 다음 단계는 필요하지 않습니다. 테스트 사이트를 빌드하기만 하면 업데이트 내용이 렌더링되는 것을 확인할 수 있습니다.

shared-content 디렉터리에 포함되지 않을 새로운 공유 문서 파일을 how-to 디렉터리에 생성하는 경우 다음을 완료하십시오:

  1. 새 콘텐츠 파일과 동일한 파일명으로, 끝에 "_include"를 추가하여 content_test_bed 안에 파일을 생성하십시오.
    • style_guide.md의 경우, style_guide_include.md를 추가하면 됩니다.
  2. 스니펫 구문을 사용하여 파일 이름을 filename_include.md에 추가합니다. 콘텐츠를 포함하기 위한 스니펫 구문은 -8<- "filename.md"입니다.
    • style_guide.md의 경우, -8<- "style_guide.md"style_guide_include.md에 추가하면 됩니다.
  3. Shared content test bed 섹션의 /docs/SUMMARY.md 부분을 업데이트하여 새로운 _include 파일과 경로를 포함시키되, 해당 섹션 내 다른 항목들과 동일한 들여쓰기 수준으로 맞추십시오.
    • style_guide_include.md의 경우, - [Style guide](content_test_bed/style_guide_include.md)를 추가하면 됩니다.

이 단계들을 완료하면 테스트 사이트를 빌드하고 새로 생성된 문서가 렌더링된 모습을 확인할 수 있습니다.