Atributy a komentáře lokalizace

  • Článek

Komentáře k lokalizaci windows Presentation Foundation (WPF) jsou vlastnosti uvnitř zdrojového kódu XAML, které vývojáři poskytují pravidla a rady pro lokalizaci. Komentáře lokalizace WPF obsahují dvě sady informací: atributy lokalizovatelnosti a komentáře k lokalizaci volného tvaru. Atributy lokalizovatelnosti jsou používány rozhraním API pro lokalizaci WPF k označení, které prostředky se mají lokalizovat. Komentáře ve volném formuláři jsou všechny informace, které chce autor aplikace zahrnout.

Přidat komentáře k lokalizaci

Pokud autoři značek mají požadavky na konkrétní prvky v JAZYCE XAML, jako jsou omezení délky textu, řady písem nebo velikosti písma, můžou tyto informace sdělit lokalizátorům s komentáři v kódu XAML. Postup přidání komentářů ke zdrojovému kódu je následující:

  1. Vývojář aplikace přidá do zdrojového kódu XAML lokalizační komentáře.

  2. Během procesu sestavení můžete zadat v souboru .proj, zda chcete ponechat volné lokalizační komentáře v sestavení, vyříznout část komentářů nebo odstranit všechny komentáře. Prokládání komentářů se umístí do samostatného souboru. Svou možnost zadáte pomocí značky LocalizationDirectivesToLocFile , např.

    <LocalizationDirectivesToLocFile>value</LocalizationDirectivesToLocFile>

  3. Hodnoty, které je možné přiřadit, jsou:

    • Žádné – komentáře i atributy zůstanou uvnitř sestavení a negeneruje se žádný samostatný soubor.

    • CommentsOnly – Odstraní pouze komentáře ze sestavení a umístí je do samostatného souboru LocFile.

    • Vše – odstraní komentáře i atributy ze sestavení a umístí je do samostatného souboru LocFile.

  4. Při extrakci lokalizovatelných prostředků z BAML jsou atributy lokalizovatelnosti respektovány lokalizačním rozhraním API BAML.

  5. Lokalizační soubory komentářů, které obsahují pouze komentáře ve volném formátu, se později začlení do lokalizačního procesu.

Následující příklad ukazuje, jak přidat lokalizační komentáře do souboru XAML.

<TextBlock x:Id = "text01"

FontFamily = "Microsoft Sans Serif"

FontSize = "12"

Localization.Attributes = "$Content (Unmodifiable Readable Text)

FontFamily (Unmodifiable Readable)"

Localization.Comments = "$Content (Trademark)

FontSize (Trademark font size)" >

Microsoft

</TextBlock>

V předchozí ukázce část Localization.Attributes obsahuje atributy lokalizace a část Localization.Comments komentáře bez formuláře komentáře. Následující tabulky zobrazují atributy a komentáře a jejich význam pro lokalizátor.

Atributy lokalizace Význam
$Content (nemodifikovatelný čitelný text) Obsah elementu TextBlock nelze změnit. Lokalizátory nemohou změnit slovo "Microsoft". Obsah je viditelný (čitelný) pro lokalizátor. Kategorie obsahu je text.
FontFamily (neupravitelné čitelné) Vlastnost rodiny písem elementu TextBlock nelze změnit, ale je viditelná pro lokalizátor.
Komentáře k lokalizaci bez formuláře Význam
$Content (ochranná známka) Autor aplikace říká lokalizátoru, že obsah v elementu TextBlock je ochranná známka.
FontSize (velikost písma ochranné známky) Autor aplikace označuje, že vlastnost velikost písma by měla odpovídat standardní velikosti ochranné známky.

Atributy lokalizovatelnosti

Informace v Localization.Attributes obsahují seznam dvojic: cílový název hodnoty a přidružené hodnoty lokalizovatelnosti. Cílovým názvem může být název vlastnosti nebo speciální název $Content. Pokud se jedná o název vlastnosti, cílová hodnota je hodnota vlastnosti. Pokud je $Content, cílová hodnota je obsah prvku.

Existují tři typy atributů:

  • Kategorie: Určuje, zda má být hodnota modifikovatelná z nástroje lokalizátoru. Viz třída Category.

  • Čitelnost. Určuje, zda má nástroj lokalizátoru číst (a zobrazit) hodnotu. Viz třída Readability.

  • Modifiability. Určuje, jestli nástroj lokalizátoru umožňuje úpravu hodnoty. Viz třída Modifiability.

Tyto atributy lze zadat v libovolném pořadí odděleném mezerou. V případě, že jsou zadány duplicitní atributy, poslední atribut přepíše bývalé atributy. Například Localization.Attributes = "Unmodifiable Modifiable" nastaví Modifiability na Modifiability, protože je to poslední hodnota.

Modifiability a čitelnost jsou vysvětlované. Atribut Category poskytuje předdefinované kategorie, které pomáhají lokalizátoru při překladu textu. Kategorie, jako je text, popisek a název, poskytují lokalizátoru informace o tom, jak přeložit text. Existují také speciální kategorie: None, Inherit, Ignore a NeverLocalize.

Následující tabulka ukazuje význam speciálních kategorií.

Kategorie Význam
Nic Cílová hodnota nemá žádnou definovanou kategorii.
Dědí Cílová hodnota dědí svou kategorii z nadřazeného objektu.
Ignorovat Cílová hodnota se v procesu lokalizace ignoruje. Ignorování ovlivňuje pouze aktuální hodnotu. Nebude mít vliv na podřízené uzly.
NeverLocalize Aktuální hodnotu nelze lokalizovat. Tato kategorie je zděděna podřízenými prvky prvku.

Komentáře lokalizace

Localization.Comments obsahuje řetězce volného tvaru týkající se cílové hodnoty. Vývojáři aplikací můžou přidávat informace, které poskytují informace o tom, jak se má text aplikací přeložit. Formát komentářů může být libovolný řetězec obklopený znakem "()". K řídicím znakům použijte znak \.

Viz také