view release on metacpan or  search on metacpan

i18n/src/xlate.deepl-NL.pod  view on Meta::CPAN

U kunt alleen Japanse tekst terughalen met het commando B<unifdef>:

    unifdef -UORIGINAL -DJA foo.ja.pm

=item B<space>

=item B<space+>

Originele en geconverteerde tekst worden gescheiden afgedrukt door een enkele lege regel. Voor C<space+> wordt ook een nieuwe regel na de geconverteerde tekst afgedrukt.

=item B<xtxt>

Als het formaat C<xtxt> (vertaalde tekst) of onbekend is, wordt alleen vertaalde tekst afgedrukt.

=back

=item B<--xlate-maxlen>=I<chars> (Default: 0)

Geef de maximale lengte op van de tekst die in één keer naar de API mag worden verzonden. De standaardwaarde 0 betekent de eigen limiet van de engine: voor de gratis DeepL-accountservice is dat 128K voor de API (B<--xlate>) en 5000 voor de klembord...

=item B<--xlate-maxline>=I<n> (Default: 0)

Geef het maximum aantal regels tekst op dat in één keer naar de API moet worden gestuurd.

Stel deze waarde in op 1 als je één regel per keer wilt vertalen. Deze optie heeft voorrang op de C<--xlate-maxlen> optie.

=item B<--xlate-prompt>=I<text>

Geef een aangepaste prompt op die naar de vertaalengine moet worden verzonden. Deze optie is beschikbaar voor de LLM-engines (C<gpt3>, C<gpt4o>, C<gpt5>), maar niet voor DeepL. U kunt het vertaalgedrag aanpassen door specifieke instructies aan het AI...

=item B<--xlate-context>=I<text>

Geef aanvullende contextinformatie op die naar de vertaalmachine moet worden gestuurd. Deze optie kan meerdere keren worden gebruikt om meerdere contextstrings op te geven. De contextinformatie helpt de vertaalmachine om de achtergrond te begrijpen e...

=item B<--xlate-context-window>=I<n>

(Context-aware engines only, e.g. C<gpt5> on the llm backend)
Aantal omringende vertaalde blokken dat als referentiecontext wordt doorgegeven bij het opnieuw vertalen van gewijzigde blokken (standaard 2). De context omvat ook de onbewerkte brontekst rondom het gewijzigde gebied (koppen, lijststructuur, bijschri...

=item B<--xlate-cache-seed>=I<file>

Initialiseer de cache van een nieuw document vanuit het cachebestand van een ander document. Handig voor periodieke rapporten: vul de cache van de nieuwe uitgave aan met die van de vorige uitgave, zodat ongewijzigde alinea’s niet opnieuw worden ver...

=item B<--xlate-anonymize>=I<file>

Anonimiseer gevoelige tekenreeksen voordat ze naar de vertaal-API worden verzonden, en herstel ze in de uitvoer. Het woordenboekbestand bevat één vermelding per item: in JSON (canonisch, machinaal genereerbaar)

    [ { "category": "person",  "text": "山田太郎" },
      { "category": "company", "regex": "アクメ(株式会社)?" } ]

of in een eenvoudige regelindeling (C<category pattern>,  C</.../>voor reguliere expressies). Elk item wordt vervangen door een categorietag zoals C<< <person id="1" /> >>; dezelfde tekenreeks krijgt altijd dezelfde tag, zodat het model kan bijhouden...

Een woordenboek kan worden gegenereerd door een externe tool – bijvoorbeeld een lokaal model dat gevoelige entiteiten extraheert:

    llm -m <local-model> \
        -s 'Extract sensitive entities as a JSON array of objects
            with "category" and "text" fields.' \
        < report.md > report.anon.json
    greple -Mxlate --xlate-anonymize=report.anon.json ...

Een UTF-8 BOM in het bestand wordt getolereerd. Waarden in het ‘front matter’-regelformaat mogen alleen een afsluitende opmerking op hun eigen regel bevatten, niet na de waarde.

=item B<--xlate-anonymize-mark>[=I<regex>]

Verzamel anonimiseringsvermeldingen uit inline-markeringen in het document zelf. Markeer de eerste keer dat de tekenreeks voorkomt als C<{{ person("山田太郎") }}> en elke keer dat de tekenreeks in het hele document voorkomt, wordt deze geanonimis...

Merk op dat bij een optie met een optionele waarde zoals deze, een volgend bestandsargument als waarde wordt beschouwd: schrijf C<--xlate-anonymize-mark=> (met een afsluitende C<=>) bij gebruik van de standaardnotatie.

Alternatieve notaties kunnen worden geconfigureerd, bijvoorbeeld C<< --xlate-anonymize-mark='@@(?<category>[a-z][a-z0-9_]*):(?<text>[^\n]+?)@@' >> voor markeringen in de stijl van C<@@person:NAME@@>, of een HTML-commentaarvorm die onzichtbaar blijft ...

=item B<--xlate-template>[=I<regex>]

Behandel sjabloonuitdrukkingen (standaard: Jinja2 C<{{ ... }}>, C<{% ... %}>, C<{# ... #}>) als ondoorzichtige plaatshouders: geef het model de opdracht om ze ongewijzigd te kopiëren en controleer per blok of het antwoord precies dezelfde uitdrukkin...

Merk op dat bij een optie met een optionele waarde zoals deze, een volgend bestandsargument als de waarde zou worden beschouwd: schrijf C<--xlate-template=> (met een afsluitend C<=>) bij gebruik van de standaardnotatie.

=item B<--xlate-frontmatter>

Behandel een inleidend C<---> ... C<--->-blok als YAML-frontmatter: sluit het uit van de vertaling en van de fase-2-contextfragmenten, en voeg de platte C<key: value>-waarden ervan toe aan de anonimiseringsregels (categorie C<var>) als vangnet. Bij m...

Laat altijd een lege regel achter na de afsluitende C<--->. Bij een overeenkomend patroon in paragraafstijl vormt front matter dat direct overgaat in de hoofdtekst één blok dat de uitsluiting niet kan onderdrukken (in dat geval wordt een waarschuwi...

=item B<--xlate-glossary>=I<glossary>

Geef een woordenlijst-ID op die moet worden gebruikt voor vertaling. Deze optie is alleen beschikbaar wanneer je de DeepL engine gebruikt. De woordenlijst-ID moet verkregen worden via je DeepL account en zorgt voor een consistente vertaling van speci...

=item B<--xlate-dryrun>

Roep de vertaal-API niet aan; toon in plaats daarvan via de voortgangsbalk elke payload precies zoals deze zou worden verzonden (na anonimisering en maskering). Handig om te controleren wat de machine verlaat en om de kosten van een vertaalrun in te ...

=item B<-->[B<no->]B<xlate-progress> (Default: True)

Bekijk het vertaalresultaat in realtime in de STDERR-uitvoer. De C<From>-payload wordt weergegeven zoals deze wordt verzonden, na anonimisering en maskering.

=item B<--xlate-review>

Voor een één-op-één gewijzigd blok wordt het kleinste aaneengesloten gewijzigde segment in de oude en nieuwe brontekst weergegeven, gevolgd door het overeenkomstige segment in de oude en nieuwe vertaling. Het rapport wordt naar STDERR geschreven,...

=item B<--xlate-stripe>

Gebruik de module L<App::Greple::stripe> om het gematchte deel weer te geven met zebrastrepen. Dit is nuttig wanneer de gematchte delen rug-aan-rug verbonden zijn.

Het kleurenpalet wordt omgeschakeld volgens de achtergrondkleur van de terminal. Als je dit expliciet wilt specificeren, kun je B<--xlate-stripe-light> of B<--xlate-stripe-dark> gebruiken.

=item B<--xlate-mask>

Voer de maskeerfunctie uit en geef de geconverteerde tekst weer zoals hij is, zonder restauratie.

=item B<--match-all>

Stel de hele tekst van het bestand in als doelgebied.

=item B<--lineify-cm>

=item B<--lineify-colon>

In het geval van de C<cm> en C<colon> opmaak wordt de uitvoer regel voor regel opgesplitst en opgemaakt. Daarom kan het verwachte resultaat niet worden verkregen als slechts een deel van een regel moet worden vertaald. Deze filters herstellen uitvoer...

In de huidige implementatie, als meerdere delen van een regel worden vertaald, worden ze uitgevoerd als onafhankelijke regels.

=back