Markdown 파일¶

Added in version 5.0.

참고

이 형식에 대한 지원은 개발 중입니다. 일부 기능은 아직 사용할 수 없으며 동작이 릴리스 간에 변경될 수 있습니다. 테스트 피드백을 환영합니다.

번역 가능한 콘텐츠는 Markdown 파일에서 추출되어 번역용으로 제공됩니다. JSX 문법이 있는 Markdown 파일에는 MDX 파일 를 사용하세요.

Markdown units automatically get the md-text, auto-safe-html and strict-same flags. This keeps the unsafe HTML check active for plain text, standard HTML, and custom elements while avoiding HTML cleanup on non-HTML angle-bracket syntax such as MDX or JSX-like components. Use the explicit safe-html flag for strings that are known to contain HTML and should always be sanitized, including SVG or MathML snippets.

참고

대부분의 다른 형식과 달리, 번역 파일의 변경 사항은 안정적으로 가져올 수 없으므로 Weblate로 가져오지 않습니다. 번역의 기준 소스는 번역 파일이 아닌 Weblate입니다.

Markdown

파일 예시:

# Ahoj světe!

Orangutan has five bananas.

Try Weblate at [weblate.org](https://demo.weblate.org/)!

*Thank you for using Weblate.*

지원 기능¶
파일 확장자	`.markdown`, `.md`
언어성 ⓘ	단일 언어
복수형 지원 ⓘ	`No`
설명 지원 ⓘ	`No`
설명 지원 ⓘ	`No`
문맥 지원 ⓘ	`No`
위치 지원 ⓘ	`No`
플래그 지원 ⓘ	`No`
API 식별자	`markdown`
읽기 전용 문자열 지원 ⓘ	`No`
Supports removing obsolete strings ⓘ	`No`
이 형식이 추가하는 검사 플래그 ⓘ	`auto-safe-html`, `strict-same`, `md-text`

Weblate 구성¶

일반적인 Weblate 구성요소 설정
파일 마스크	`path/*.md`
단일언어 기반 언어 파일	`path/en.md`
신규 번역의 템플릿	`path/en.md`
파일 형식	마크다운 파일
파일 형식 매개변수	`markdown_merge_duplicates=True`

중복 문자열 처리¶

기본적으로 Weblate는 줄 기반 컨텍스트를 제공하기 위해 문자열의 각 출현을 별도의 번역 단위로 처리합니다. 이는 행 재정렬이 컨텍스트를 변경하고 번역 손실을 초래할 수 있는 Markdown 테이블에서 문제가 될 수 있습니다.

동일한 문자열을 단일 번역 단위로 통합하려면 파일 형식 매개변수 에서 중복 문자열 제거 를 활성화하세요.

참고

이 옵션을 활성화하면 병합된 단위의 줄 기반 컨텍스트가 비활성화되어 문서 내에서 행이나 섹션이 이동하더라도 번역이 안정적으로 유지됩니다.

Translating front matter values¶

By default, YAML front matter is extracted as a single translatable block. Enable Translate front matter values in 파일 형식 매개변수 to parse YAML front matter and translate only scalar string values while preserving keys, structure, comments, and formatting when possible. The same setting is available for MDX 파일 files.