1. Manuals
  2. Tumbleweed
  3. po4a-lang
  4. Locale::Po4a::VimHelp(3pm)

Scroll to navigation

LOCALE::PO4A::VIMHELP.3PM(1) User Contributed Perl Documentation LOCALE::PO4A::VIMHELP.3PM(1)

NAAM

Locale::Po4a::VimHelp - Vim-hulpbestanden van/naar PO-bestanden converteren

BESCHRIJVING

Het doel van het project po4a (PO voor alles) is om de vertaalwerkzaamheden (en interessanter nog, het onderhoud van vertalingen) te vergemakkelijken met behulp van gettext-hulpmiddelen in domeinen waarin deze niet meteen verwacht worden, zoals documentatie.

"Locale::Po4a::VimHelp" is een module om de vertaling van Vim-hulpbestanden te ondersteunen. Zie ook Writing help files <https://vimhelp.org/helphelp.txt.html#help-writing> voor de syntaxis ervan.

STATUS VAN DEZE MODULE

Deze module bevindt zich in een vroeg stadium van ontwikkeling. Zij is succesvol getest op eenvoudige bestanden zoals "helphelp.txt". Zij is echter nog niet getest op volledige hulpbestanden, en de manier waarop zij deze verwerkt, kan nog veranderen met het oog op probleemoplossingen en verbeteringen, in het bijzonder de alinea-omloop.

ONTWIKKELING

Het ontleden van Vim-hulpbestanden voor po4a is moeilijk. Hier volgen enkele obstakels tijdens het ontwikkelen van deze module. Als u een beter idee heeft, stel dan gerust een patch voor (met extra testgevallen).

"1. foo" klinkt als een geordende lijst
Niet noodzakelijk. Kijk maar naar de volgende paragraaf: 

 Er zijn 2 rondzwervende tanuki's, niet.
 1. Hij gebruikt zijn kloontechniek.

Om dezelfde reden kan wat lijkt op een kop (bijv. "1.1 bar") of een ongeordende lijst (bijv. "o baz") niet worden gedetecteerd.

Dit onderwerp is ook moeilijk omdat het betrekking heeft op taalkundige verschillen in lokalisatie.

Bekijk het volgende voorbeeld

 Zo'n algemeen en kort concept in sommige talen *tags*

wat vertaald zou kunnen worden als

 Ze zijn onbekend, er zijn geen overeenkomstige concepten en *tags*
 vereisen een langere zin om ze in deze taal uit te drukken

Wanneer dit gebeurt, moet u beslissen op welk punt u een tag op een aangename manier wilt toevoegen. Dit zou niet eenvoudig moeten zijn. De opmaak van het hulpbestand van Vim heeft een harde indeling, zelfs voor onderdelen die geen codeblokken zijn.

Hetzelfde geldt voor tagverwijzingen zoals "|ref|".

Het gebruik van de optie "--wrapcol" om waarschuwingen te geven wanneer de tekstbreedte de opgegeven limieten overschrijdt, lijkt een redelijke aanpak. De officiële helpbestanden van Vim bevatten een modusregel, zoals "vim:tw=78:ts=8:noet:ft=help:norl:", zoals te zien is in "runtime/doc/if_perl.txt" <https://github.com/vim/vim/blob/04cc8975930b7b2c5d6753d3eddf57dab2816518/runtime/doc/if_perl.txt#L307>. Er zijn echter een paar uitdagingen om rekening mee te houden:
Als deze optie is geïmplementeerd, zou het ideaal zijn om eerst het hele bestand te lezen, te detecteren of de modusregel bestaat en te bepalen welke secties erdoor worden beïnvloed. Helaas wordt het progressieve ontleedmechanisme in dit geval niet gebruikt.
De algemene standaardwaarde van "--wrapcol" is 76, terwijl Vim-hulpbestanden vaak 78 gebruiken. In de meeste gevallen is de waarde in de opties die aan deze module worden doorgegeven standaard 76, maar het is onduidelijk of deze waarde expliciet is ingesteld of impliciet is toegepast.

ZIE OOK

Locale::Po4a::TransTractor(3pm), po4a(7)

AUTEURS

 gemmaro <gemmaro.dev@gmail.com>

COPYRIGHT EN LICENTIE

 Copyright © 2024, 2025 gemmaro.

Dit programma is vrije software; u kunt het verder verspreiden en/of aanpassen onder de bepalingen van de GPL v2.0 of recenter (zie het bestand COPYING).

2026-03-23 perl v5.42.0