include_str_from_dir!() { /* proc-macro */ }Expand description
명시한 언어별 디렉토리에서 기본 파일과 이름이 같은 문서를 포함한다.
기본 파일 뒤에 하나 이상의 언어 = "디렉토리" 매핑을 받는다. 키는 중복 없는
소문자 ISO 639-1 코드이며 디렉토리 이름 자체가 언어 코드일 필요는 없다.
모든 경로는 호출 패키지의 Cargo.toml 기준이다. 디렉토리 끝의 / 하나는 허용한다.
아래 예시는 한국어 선택 시 docs/ko/guide.md, 영어 선택 시
translations/english/guide.md를 포함한다. 기본 경로의 상위 디렉토리는 붙이지 않는다.
예시 파일은 소비 프로젝트가 직접 작성해야 하므로 이 코드 블록은 독립 실행하지 않는다.
ⓘ
#[doc = cargo_textus::include_str_from_dir!(
"docs/guide.md", ko = "docs/ko", en = "translations/english",
)]
pub fn example() {}언어 미선택 시 기본 파일을 사용한다. 선택하지 않은 매핑도 코드·중복·경로를
검증하지만 파일 존재 여부는 선택한 파일만 검사한다. 선택 언어의 매핑이나 파일이
없으면 컴파일 오류이며 자동 대체하지 않는다. CLI로 선택하려면 해당 언어를
package.metadata.textus.i18n.languages에도 등록해야 한다.