Markdown ファイル¶

Added in version 5.0.

注釈

この形式への対応は開発中です。一部の機能はまだ使用できないません。動作はリリース間で変更することがあります。テスト結果のフィードバックは歓迎します。

The translatable content is extracted from the Markdown files and offered for the translation. For Markdown files with JSX syntax, use MDX files.

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.*

対応機能¶
File extensions	`.md`
Linguality ⓘ	Monolingual
Supports plural ⓘ	`No`
Supports descriptions ⓘ	`No`
Supports explanation ⓘ	`No`
Supports context ⓘ	`No`
Supports location ⓘ	`No`
Supports flags ⓘ	`No`
API identifier	`markdown`
Supports read-only strings ⓘ	`No`
Check flags added by this format ⓘ	`auto-safe-html`, `strict-same`, `md-text`

Weblate の設定¶

典型的な Weblate コンポーネント構成
ファイルマスク	`path/*.md`
モノリンガル用の、基礎となる言語ファイル	`path/en.md`
新しい翻訳のテンプレート	`path/en.md`
ファイル形式	Markdown ファイル
ファイル形式パラメータ	`markdown_merge_duplicates=True`

重複文字列の処理¶

Weblate はデフォルトで、文字列の各出現箇所を行ベースのコンテキストを提供するために別々の翻訳単位として扱います。しかし、Markdown の表では行を並べ替えるとコンテキストが変化し、翻訳が失われる原因となる場合があります。

同一の文字列を 1 つの翻訳単位に統合するには、ファイル形式パラメータで Deduplicate identical strings を有効にしてください。

注釈

このオプションを有効にすると、統合された翻訳単位に対する行ベースのコンテキストが無効になり、ドキュメント内で行やセクションが移動された場合でも翻訳が安定して保持されます。

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 files.