.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "LOCALE::PO4A::VIMHELP.3PM 1" .TH LOCALE::PO4A::VIMHELP.3PM 1 2025-11-22 "perl v5.42.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NOME .IX Header "NOME" Locale::Po4a::VimHelp \- converte file di aiuto Vim da/a file PO. .SH DESCRIZIONE .IX Header "DESCRIZIONE" L\*(Aqobiettivo del progetto po4a (PO per tutto) è di facilitare le traduzioni (e cosa più interessante, la manutenzione delle traduzioni) usando gli strumenti associati a gettext in aree inaspettate come la documentazione. .PP \&\f(CW\*(C`Locale::Po4a::VimHelp\*(C'\fR è un modulo per aiutare la traduzione del file di aiuto di Vim. Vedere anche Scrivere di file di aiuto per la sua sintassi. .SH "STATO DI QUESTO MODULO" .IX Header "STATO DI QUESTO MODULO" Questo modulo è in una fase iniziale di sviluppo. È stato testato con successo su file semplici come \f(CW\*(C`helphelp.txt\*(C'\fR. Tuttavia, non è ancora stato testato su file di aiuto completi e il modo in cui li analizza potrebbe cambiare a causa di correzioni e miglioramenti, in particolare la parte che gestisce l\*(Aqinterruzione di paragrafo. .SH SVILUPPO .IX Header "SVILUPPO" L\*(Aqanalisi dei file di aiuto di Vim per po4a è difficile. Ecco alcuni ostacoli durante lo sviluppo di questo modulo. Se si pensa di aver avuto un\*(Aqidea migliore, sentitevi liberi di suggerire una patch (con test aggiuntivi). .ie n .IP """1. foo"" sembra un elenco ordinato" 4 .el .IP "\f(CW1. foo\fR sembra un elenco ordinato" 4 .IX Item "1. foo sembra un elenco ordinato" Non necessariamente. Si consideri il seguente paragrafo. .Sp .Vb 2 \& There are 2 wandering tanukis, not \& 1. He\*(Aqs using his cloning technique. .Ve .Sp Per lo stesso motivo, ciò che sembra essere un\*(Aqintestazione (ad esempio \&\f(CW\*(C`1.1 bar\*(C'\fR) o un elenco non ordinato (ad esempio \f(CW\*(C`o baz\*(C'\fR) non può essere rilevato. .IP "I tag svuotati a destra dovrebbero essere esclusi dall\*(Aqobiettivo di traduzione" 4 .IX Item "I tag svuotati a destra dovrebbero essere esclusi dall'obiettivo di traduzione" Anche questo argomento è difficile perché riguarda le differenze linguistiche nella localizzazione. .Sp Si consideri il seguente esempio. .Sp .Vb 1 \& Such a common and short concept in some languages *tags* .Ve .Sp che potrebbe essere tradotto in .Sp .Vb 2 \& They are unfamiliar, there are no corresponding concepts and *tags* \& it takes a longer sentence to express them in this language .Ve .Sp Quando ciò accade, bisogna decidere a che punto si vuole aggiungere un marcatore \fInicely\fR. Non dovrebbe essere facile. Il file di aiuto di Vim è in un formato con ritorni a capo non modificabili, anche per le parti che non sono blocchi di codice. .Sp Lo stesso vale per i riferimenti a marcatori come \f(CW\*(C`|ref|\*(C'\fR. .ie n .IP "Utilizzo di ""\-\-wrapcol"" per monitorare la larghezza del testo" 4 .el .IP "Utilizzo di \f(CW\-\-wrapcol\fR per monitorare la larghezza del testo" 4 .IX Item "Utilizzo di --wrapcol per monitorare la larghezza del testo" Usare l\*(Aqopzione \f(CW\*(C`\-\-wrapcol\*(C'\fR per visualizzare avvisi quando la larghezza del testo supera i limiti specificati sembra un approccio ragionevole. I file di aiuto ufficiali di Vim presentano una riga di modalità, come \&\f(CW\*(C`vim:tw=78:ts=8:noet:ft=help:norl:\*(C'\fR, come mostrato in \&\f(CW\*(C`runtime/doc/if_perl.txt\*(C'\fR . Tuttavia, ci sono alcune difficoltà da considerare: .RS 4 .IP "Comportamento dell\*(Aqanalisi dei file" 4 .IX Item "Comportamento dell'analisi dei file" Se questa opzione viene implementata, sarebbe ideale leggere prima l\*(Aqintero file, verificare se la riga di modalità esiste e determinare quali sezioni sono interessate. Purtroppo, in questo caso il meccanismo di analisi progressiva non viene utilizzato. .IP "Valori predefiniti contro personalizzati" 4 .IX Item "Valori predefiniti contro personalizzati" Il valore predefinito generico di \f(CW\*(C`\-\-wrapcol\*(C'\fR è 76, mentre i file di aiuto di Vim usano comunemente 78. Nella maggior parte dei casi, il valore nelle opzioni passate a questo modulo è impostato di default su 76, ma non è chiaro se questo valore sia stato impostato esplicitamente o applicato implicitamente. .RE .RS 4 .RE .SH "VEDERE ANCHE" .IX Header "VEDERE ANCHE" \&\fBLocale::Po4a::TransTractor\fR\|(3pm), \fBpo4a\fR\|(7) .SH AUTORI .IX Header "AUTORI" .Vb 1 \& gemmaro .Ve .SH TRADUZIONE .IX Header "TRADUZIONE" .Vb 2 \& Danilo Piazzalunga \& Marco Ciampa .Ve .SH "COPYRIGHT E LICENZA" .IX Header "COPYRIGHT E LICENZA" .Vb 1 \& Copyright © 2024, 2025 gemmaro. .Ve .PP Questo programma è software libero; è lecito ridistribuirlo o modificarlo secondo i termini della licenza GPL v2.0 o successive (vedere il file \&\fICOPYING\fR).