Bestandsindelingen voor vertalen¶
Weblate ondersteunt een breed bereik aan vertaalindelingen. Elke indeling verschilt licht van andere en verschaft een andere set mogelijkheden.
Hint
Bij het kiezen van een bestandsindeling voor uw toepassing, is het beter te blijven bij een goed ontwikkelde indeling voor de toolkit/het platform dat u gebruikt. Op die manier kunnen vertalers aanvullend de gereedschappen gebruiken waaraan zij gewend zijn en zullen waarschijnlijk sneller bijdragen aan uw project.
Zie ook
Automatische detectie¶
Weblate probeert de bestandsindeling te detecteren gedurende Vertaalprojecten en onderdelen toevoegen. Het detecteren zou verkeerd kunnen zijn voor dezelfde serialisatie-indeling (JSON, YAML, properties) of bestandscodering, verifieer dus dat Bestandsformaat correct is voordat u het onderdeel maakt.
Mogelijkheden typen vertaling¶
Bekijk de documentatiepagina van elke individuele bestandsindeling voor informatie over welke mogelijkheden worden ondersteund in die indeling.
Tweetalige en eentalige indelingen¶
Beide indelingen, eentalig en tweetalig, worden ondersteund. Tweetalige indelingen slaan twee talen op in een enkel bestand—bron en vertaling (typische voorbeelden zijn GNU gettext PO (Portable Object), XLIFF 1.1 en 1.2 of Apple iOS tekenreeksen). Aan de andere kant identificeren eentalige indelingen de tekenreeks op zijn ID, en elk taalbestand bevat alleen de verwijzingen daarvan voor een opgegeven taal (typisch Android bronnen tekenreeksen). Sommige bestandsindelingen worden in beide varianten gebruikt, bekijk de gedetailleerde beschrijving hieronder.
Voor correct gebruiken van eentalige bestanden vereist Weblate toegang tot een bestand dat de volledige lijst bevat van te vertalen tekenreeksen, met hun bron—dat bestand wordt Enkeltalig basistaalbestand genoemd binnen Weblate, hoewel de naam kan variëren in uw paradigma.
Aanvullend kan deze werkwijze worden uitgebreid door Tussenliggend taalbestand te gebruiken om tekenreeksen op te nemen die worden verschaft door ontwikkelaars, maar niet zullen worden gebruikt in de uiteindelijke tekenreeksen.
Statussen tekenreeks¶
Veel bestandsindelingen onderscheiden alleen “Niet vertaalde” en “Vertaalde” tekenreeksen. Met enkele indelingen is het mogelijk om fijner afgestemde informatie voor de status op te slaan, zoals “Bewerken nodig” of “Goedgekeurd”.
Locatie van bronomschrijving¶
Beschrijvingen van brontekenreeksen kunnen worden gebruikt om aanvullende informatie door te geven over de te vertalen tekenreeks.
Verscheidene indelingen hebben eigen ondersteuning voor het verschaffen van aanvullende informatie aan vertalers (bijvoorbeeld XLIFF 1.1 en 1.2, GNU gettext PO (Portable Object), WebExtension JSON, CSV-bestanden, Excel Open XML, Qt Linguist .ts, go-i18n JSON-bestanden, gotext JSON-bestanden, ARB-bestand, .NET resource-bestanden (RESX, RESW)). Vele andere indelingen nemen de dichtstbijzijnde opmerking uit als beschrijving voor de brontekenreeks.
Uitleg¶
De Uitleg voor tekenreeksen kan worden opgeslagen en geparset uit een paar bestandsindelingen.
Momenteel alleen ondersteund in TermBase-eXchange indeling.
Locatie van brontekenreeks¶
Locatie van een tekenreeks in de broncode zou gevorderde vertalers kunnen helpen vast te stellen hoe de tekenreeks wordt gebruikt.
Deze informatie is gewoonlijk beschikbaar in tweetalige indelingen waar tekenreeksen worden uitgenomen uit de broncode met programma’s. Bijvoorbeeld GNU gettext PO (Portable Object) en Qt Linguist .ts.
Vlaggen voor vertaling¶
Vlaggen voor vertalingen maken het mogelijk het gedrag van Weblate aan te passen. Sommige indelingen ondersteunen het definiëren ervan in het vertaalbestand (u kunt ze altijd definiëren in de interface van Weblate, bekijk Gedrag aanpassen met vlaggen).
Deze mogelijkheid is gemodelleerd naar de vlaggen in GNU gettext PO (Portable Object).
Aanvullend, op XML gebaseerde indelingen die vlaggen ondersteunen nemen die uit het niet-standaard attribuut weblate-flags. De vlag max-length:N wordt ook ondersteund door het attribuut maxwidth, zoals dat is gedefinieerd in de standaard voor XLIFF, bekijk Vlaggen voor vertalingen specificeren.
Context¶
Context wordt gebruikt om verschil te kunnen maken tussen identieke tekenreeksen in een tweetalige indeling, gebruikt in verschillende bereiken (bijvoorbeeld Zon kan worden gebruikt als een afgekorte naam voor de dag “Zondag” of als de naam van onze dichtstbijzijnde ster).
Voor eentalige indelingen kan de identificatie van de tekenreeks (vaak sleutel genoemd) hetzelfde doel dienen en is aanvullende context niet noodzakelijk.
Tekenreeksen met meervouden¶
Meervouden zijn noodzakelijk om tekenreeksen correct te vertalen in een variabel aantal. De regels zijn afhankelijk van een doeltaal en veel indelingen volgen de specificatie CLDR daarvoor.
Ondersteuning voor meervouden in de ondersteunde objecttabellen betekent dat Weblate meervoudstekenreeksen kan weergeven voor de indeling. Sommige indelingen hebben bestaande metadata voor meervouden nodig of een specifieke variant en kunnen geen nieuwe meervoudstekenreeksen maken, tenzij dat zelf wordt ondersteund door de indeling.
Hint
Voor het maken van tekenreeksen met meervouden is ook de juiste ondersteuning van het framewerk van de toepassing nodig. Kies de eigen indeling voor uw platform, zoals GNU gettext PO (Portable Object), Android bronnen tekenreeksen of Stringsdict indeling.
Indelingen met meerdere waarden¶
Indelingen met meerdere waarden, zoals CSV-bestand met meerdere waarden en TermBase-eXchange indeling, slaan onafhankelijk bron- en doelalternatieven op binnen een tekenreeks. Deze alternatieven hebben geen paar een-op-een, en hun aantal volgt geen grammaticaregels voor meervoud.
Broncontroles inspecteren elk bronalternatief. Doelcontroles vergelijken elk doelalternatief met de bronalternatieven. Een doel slaagt als het overeenkomt met enig bronalternatief, onafhankelijk van hun volgorde of de grammaticavormen van het meervoud voor de taal. De controle Niet-gewijzigde vertaling in plaats van doelen te rapporteren die identiek zijn aan enig bronalternatief, onderworpen aan zijn normale vrijstellingen. Automatische reparaties worden alleen toegepast als alle bronalternatieven dezelfde correctie produceren.
Suggesties voor machinevertaling vertalen elk bronalternatief onafhankelijk. Automatische machinevertaling ondersteunt tekenreeksen met een bronalternatief en ten hoogste een doelalternatief; het slaat tekenreeksen met meerdere alternatieven over om ze te behouden. Woordenlijsten voor vertaalservices mogen alle alternatieven gebruiken. Automatische bijdragen aan Vertaalgeheugen slaan tekenreeksen met meerdere alternatieven over.
LLM-vertaalservices gebruiken alleen tekenreeksen met een bronalternatief en een doelalternatief als voorbeeld van eerdere vertalingen. Ze laten bestaande context van vertalingen weg voor tekenreeksen met meerdere alternatieven.
Alleen-lezen-tekenreeksen¶
Tekenreeksen Alleen-lezen uit vertaalbestanden zullen worden opgenomen, maar zij kunnen niet worden bewerkt in Weblate. Deze mogelijkheid wordt door een klein aantal indelingen zelf ondersteund (XLIFF 1.1 en 1.2 en Android bronnen tekenreeksen), maar kan door andere worden geëmuleerd door een vlag read-only toe te voegen, bekijk Gedrag aanpassen met vlaggen.
Verwijderen van overbodige tekenreeksen¶
Sommige bestandsindelingen kunnen overbodige tekenreeksen opslaan. Weblate kan deze overbodige tekenreeksen verwijderen uit indelingen die deze bewerking ondersteunen.
Andere indelingen ondersteunen¶
De meeste indelingen die worden ondersteund door translate-toolkit, welke serialisatie van ondersteuning gemakkelijk kan worden ondersteund, maar die zijn (nog) niet getest. In de meeste gevallen is een aanvullende dunne laag in Weblate vereist om de verschillen in gedrag van de verschillende opslagmogelijkheden te verbergen.
Voor het toevoegen van ondersteuning voor een nieuwe indeling is de voorkeursbenadering om eerst ondersteuning ervoor te implementeren in de translate-toolkit.
Zie ook
Parameters bestandsindeling¶
Parameters voor bestandsindelingen verschaffen een manier om instellingen te configureren die zijn gerelateerd aan de bestandsindeling. Ze worden geconfigureerd op het niveau van het onderdeel en stellen u in staat aan te passen hoe parsen en serialiseren van bestanden worden afgehandeld.
For supported XML formats, xml_utf8_bom controls the UTF-8 byte order mark:
preserve keeps the input file’s BOM, include always writes it, and
omit removes it. The default is preserve; new files without a template
omit the BOM. Other encodings are unchanged.
The xml_encoding_case parameter selects uppercase or lowercase
encoding names in the XML declaration, such as UTF-8 or utf-8.
The default, default, uses the format’s native casing.
The xml_final_newline parameter controls the newline after the complete XML
document, including any trailing comments or processing instructions. Choose
include for exactly one final line ending, or omit for none.
The default, default, leaves the format’s behavior unchanged. Explicit
inclusion uses the serializer’s line-ending style, falling back to LF when the
output contains no line endings. Translation-content whitespace is unchanged.
Lijst met parameters voor bestandsindelingen¶
Naam parameter |
Bestandsindelingen |
Label |
Helptekst |
|---|---|---|---|
csv_codering |
|
Bestandsversleuteling |
Codering gebruikt voor CSV-bestanden Beschikbare keuzes:
|
csv_escape_formules |
|
Werkbladformules escapen |
Waarden voor voorvoegsels die eruitzien als werkbladformules met een apostrof bij het opslaan als CSV-bestanden. |
csv_eenvoudige_codering |
|
Bestandsversleuteling |
Codering gebruikt voor eenvoudige CSV-bestanden Beschikbare keuzes:
|
dos_eol |
Alle bestandsindelingen |
DOS-regeleindes |
DOS regeleinden (rn) gebruiken in plaats van UNIX regeleinden (n) in tekenreeksen. |
flatxml_key_name |
|
FlatXML sleutelnaam |
|
flatxml_root_name |
|
FlatXML bronnaam |
|
flatxml_value_name |
|
FlatXML waardenaam |
|
gwt_codering |
|
Bestandsversleuteling |
Codering gebruikt voor GWT-eigenschappenbestanden Beschikbare keuzes:
|
json_indent |
|
JSON-inspringing |
|
json_indent_style |
|
stijl JSON-inspringing |
Beschikbare keuzes:
|
json_sort_keys |
|
JSON-sleutels sorteren |
Beschikbare keuzes:
|
json_use_compact_separators |
|
Vermijd spaties na scheidingstekens |
|
line_max_length |
|
Maximale regellengte |
Maximaal aantal tekens voor elke regel in het uitvoerbestand. |
md_extract_code_blocks |
|
Codeblokken uitnemen |
Of vertaalbare inhoud uit codeblokken moet worden uitgenomen in Markdown en MDX-bestanden. |
md_extract_frontmatter |
|
Frontmatter uitnemen |
Of YAML frontmatterblokken moeten worden uitgenomen en vertaald in Markdown en MDX-bestanden. |
md_frontmatter_translate_values |
|
Waarden van voorwerk vertalen |
Parseer YAML-voorwerk en vertaal alleen scalaire waarden voor tekenreeksen. Sleutels, structuur, opmerkingen en opmaak worden, waar mogelijk, behouden. |
md_no_placeholders |
|
Plaatsvervangers uitschakelen |
Schakelt ontdekken en verwerken van plaatsvervangers uit in Markdown en MDX-bestanden. |
merge_duplicates |
|
Dubbele tekenreeks corrigeren |
Voegt identieke brontekens samen tot één vertaaleenheid. Voorkomt verlies van vertalingen tijdens het herstructureren van bestanden of het herschikken van tabellen door positieafhankelijke context te verwijderen. |
po_contributor_comments |
|
Opmerkingen van medewerkers |
Voeg medewerkersnamen en jaartallen toe aan opmerkingen in de kopregel. SPDX zet ook bestaande en erkende medewerkersopmerkingen om tot SPDX-FileCopyrightText items. Beschikbare keuzes:
|
po_fuzzy_matching |
|
Vage overeenkomsten gebruiken |
|
po_keep_previous |
|
Vorige msgids van vertaalde tekenreeksen bewaren |
Beheert eerdere opmerkingen msgid voor fuzzy tekenreeksen. |
po_line_wrap |
|
Tekstterugloop |
Gettext breekt regels standaard af bij 77 tekens en bij nieuwe regels. Met de optie voor de opdrachtregel Beschikbare keuzes:
|
po_no_location |
|
Neem geen locatie-informatie in het bestand op |
|
po_remove_obsolete |
|
Overbodige tekenreeksen verwijderen |
Overbodige items verwijderen uit PO-bestanden bij het opslaan van wijzigingen in vertalingen of bijwerken vanuit een POT-bestand. |
po_report_msgid_bugs_to |
|
Ontbrekende problemen met msgid melden bij |
Laat Weblate de bestandskop “Report-Msgid-Bugs-To” bijwerken als het adres voor het rapporteren van de brontekenreeks is ingesteld. |
po_set_language_team |
|
Header language team bijwerken |
Laat Weblate de bestandskop “Language-Team” bijwerken. |
po_set_last_translator |
|
Header last translator bijwerken |
Laat Weblate de bestandskop “Last Translator” bijwerken. |
po_set_x_generator |
|
X-Generator-header bijwerken |
Laat Weblate de bestandskop “X-Generator” bijwerken. |
properties_codering |
|
Bestandsversleuteling |
Codering gebruikt voor Java-eigenschappenbestand Beschikbare keuzes:
|
strings_codering |
|
Bestandsversleuteling |
Codering gebruikt voor iOS-tekenreeksbestanden Beschikbare keuzes:
|
xliff_plaatsvervangers |
|
Ondersteuning voor plaatsbare items |
Controleert of inline-XML-elementen binnen XLIFF-tekenreeksen worden behouden als aanpasbare plaatsbare items. Platte tekst sluit alleen XML-markup uit en behandeld de inhoud als tekst. Met ondersteuning voor plaatsbare items blijven labels zoals <x id=”name” =””> of </x> in de tekenreeks en verschijnen als tijdelijke aanduidingen in de bewerker Beschikbare keuzes:
|
xml_closing_tags |
|
Sluittag toevoegen aan blanco xml-tags |
|
xml_encoding_case |
|
XML declaration encoding case |
Controls encoding names in the XML declaration, for example “UTF-8” or “utf-8”. Beschikbare keuzes:
|
xml_final_newline |
|
XML final newline |
Controls the newline at the end of the file, using the format’s line endings. Beschikbare keuzes:
|
xml_utf8_bom |
|
UTF-8 byte order mark |
Controls the UTF-8 byte order mark. Other encodings are unchanged. New files without a template omit the mark when preserving input. Beschikbare keuzes:
|
xml_whitespace_handling |
|
Omgaan met witruimte |
Controleert hoe wordt omgegaan met XLIFF-witruimte. Volg xml:space honoreert attributen in het bestand. Altijd behouden bewaart alle witruimte. Altijd normaliseren vouwt witruimte in, zelfs wanneer xml:space=”preserve” is ingesteld. Beschikbare keuzes:
|
yaml_indent |
|
YAML-inspringing |
|
yaml_line_break |
|
Regeleinden |
Beschikbare keuzes:
|
yaml_line_wrap |
|
Tekstterugloop |
Beschikbare keuzes:
|