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)

NAMN

Locale::Po4a::VimHelp – konvertera Vim-hjälpfiler från/till PO-filer

BESKRIVNING

Målet med po4a-projektet (PO för allt) är att underlätta översättningar (och, ännu mer intressant, underhållet av översättningar) med hjälp av gettext-verktyg på områden där de inte förväntades användas, såsom dokumentation.

"Locale::Po4a::VimHelp" är ett modul som hjälper till med översättningen av Vims hjälpfiler. Se även Skriva hjälpfiler <https://vimhelp.org/helphelp.txt.html#help-writing> för dess syntax.

STATUS FÖR DENNA MODUL

Denna modul befinner sig i ett tidigt utvecklingsstadium. Den har testats med framgång på enkla filer som "helphelp.txt". Den har dock ännu inte testats på fullständiga hjälpfiler, och sättet den analyserar dem på kan komma att ändras för att åtgärda fel och förbättra funktionen, särskilt vad gäller radbrytning.

UTVECKLING

Det är svårt att analysera Vim-hjälpfiler för po4a. Här är några hinder som uppstod under utvecklingen av denna modul. Om du har en bättre idé är du välkommen att föreslå en patch (med ytterligare testfall).

"1. foo" låter som en ordnad lista
Inte nödvändigtvis. Tänk på följande stycke: 

 Det finns två vandrande tanukis, inte
 1. Han använder sin kloningsteknik.

Av samma anledning kan det som ser ut som en rubrik (t.ex. "1.1 bar") eller en osorterad lista (t.ex. "o baz") inte upptäckas.

Detta ämne är också svårt eftersom det rör språkskillnader i lokalisering.

Tänk på följande exempel

 Ett så vanligt och kort begrepp i vissa språk *taggar*

vilket kan översättas till

 De är okända, det finns inga motsvarande begrepp och *taggar*
och det krävs en längre mening för att uttrycka dem på detta språk

När detta händer måste du bestämma vid vilken punkt du vill lägga till en tagg nicely. Detta bör inte vara enkelt. Vim-hjälpfilen har ett format med fast radbrytning, även för delar som inte är kodblock.

Detsamma gäller taggreferenser som "|ref|".

Att använda flaggan "--wrapcol" för att utfärda varningar när textbredden överskrider angivna gränser verkar vara en rimlig metod. De officiella hjälpfilerna för Vim har en lägesrad, till exempel "vim:tw=78:ts=8:noet:ft=help:norl:", som visas i "runtime/doc/if_perl.txt" <https://github.com/vim/vim/blob/04cc8975930b7b2c5d6753d3eddf57dab2816518/runtime/doc/if_perl.txt#L307>. Det finns dock några utmaningar att ta hänsyn till:
Om denna flagga implementeras skulle det vara idealiskt att först läsa hela filen, upptäcka om lägesraden finns och avgöra vilka avsnitt som påverkas. Tyvärr används inte den progressiva tolkningsmekanismen i detta fall.
Det generiska standardvärdet för C-<--wrapcol> en är 76, medan Vim-hjälpfiler vanligtvis använder 78. I de flesta fall är värdet i de flaggor som skickas till denna modul standardinställt till 76, men det är oklart om detta värde har ställts in explicit eller tillämpats implicit.

SE ÄVEN

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

UPPHOVSPERSONER

 gemmaro <gemmaro.dev@gmail.com>

UPPHOVSRÄTT OCH LICENS

 Copyright © 2024, 2025 gemmaro.

Detta program är fri programvara; du får distribuera och/eller modifiera det enligt villkoren i GPL v2.0 eller senare (se filen COPYING ).

2026-03-23 perl v5.42.0