pub fn directory_document_path(
path: &str,
directories: &[(&str, &str)],
language: Option<&str>,
) -> Result<String, String>Expand description
기본 파일 또는 언어에 명시적으로 연결된 디렉토리의 동일 파일명을 선택한다.
directories는 (언어 코드, 패키지 기준 디렉토리) 쌍의 목록이다.
docs/api/guide.md와 ("ko", "translations/korean/")을 사용하면 한국어
선택 결과는 translations/korean/guide.md다. 기본 경로의 상위 디렉토리는
복사하지 않으며 디렉토리 끝의 / 하나를 제거한 뒤 파일명 전체를 붙인다.
언어가 없으면 기본 파일을 선택하지만 모든 매핑의 유효성을 먼저 확인한다. 이렇게 하면 언어를 전환해야만 설정 오타가 드러나는 일을 줄일 수 있다. 선택하지 않은 파일의 존재 여부를 포함해 파일 시스템은 검사하지 않는다.
§오류
기본 경로는 document_path와 같은 규칙을 따른다. 빈 매핑 목록, 미배정 코드,
중복 키, 빈 디렉토리, 절대 경로, 역슬래시·콜론, 빈 구간과 ..를 거부한다.
요청 언어의 유효성과 매핑 존재 여부는 별개로 검사하며, 유효하지만 매핑이 없는
언어에는 등록 누락 오류를 반환한다. 기본 파일이나 다른 언어로 대체하지 않는다.