
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NAME

Locale::Po4a::VimHelp - konvertiert Vim-Hilfedateien von/in PO-Dateien

=head1 BESCHREIBUNG

Das Projektziel von Po4a (PO für alles) ist es, die Übersetzung (und
interessanter, die Wartung der Übersetzung) zu vereinfachen, indem die
Gettext-Werkzeuge auch für Gebiete verwendet werden, wo diese nicht erwartet
werden, wie Dokumentation.

C<Locale::Po4a::VimHelp> ist ein Modul, das bei der Übersetzung einer
Vim-Hilfedatei hilft. Siehe auch L<Writing help
files|https://vimhelp.org/helphelp.txt.html#help-writing> für deren Syntax.

=head1 STATUS DIESES MODULS

Dieses Modul befindet sich in einem frühen Entwicklungsstadium. Es wurde
erfolgreich mit einfachen Dateien wie C<helphelp.txt> getestet. Allerdings
wurde es noch nicht mit vollständigen Hilfedateien getestet und die Art, wie
es diese auswertet, kann sich für Fehlerkorrekturen und Verbeserungen noch
ändern, insbesondere beim Absatzumbruch.

=head1 ENTWICKLUNG

Die Auswertung von Vim-Hilfedateien ist schwierig. Im folgenden werden
einige Hindernisse bei diesem Modul beschrieben. Falls Sie eine bessere Idee
haben, können Sie diese gerne mit einem Patch einreichen (mit zusätzlichen
Testfällen).

=over

=item C<1. foo> sieht nach einer sortierten Liste aus

Nicht notwendigerweise. Betrachten Sie den folgenden Absatz:

 There are 2 wandering tanukis, not
 1. He's using his cloning technique.

Aus dem gleichen Grund kann etwas, das nach einer Überschrift (z.B. C<1.1
bar>) oder einer unsortierten Liste (z.B. C<o baz>) aussieht, nicht erkannt
werden.

=item Rechts ausgerichtete Markierungen sollten vom Übersetzungsziel
ausgeschlossen werden

Dieses Thema ist auch schwierig, da es sich auf Sprachunterschiede in der
Lokalisierung bezieht.

Betrachten Sie das folgende Beispiel:

 Such a common and short concept in some languages *tags*

Was wie folgt übersetzt werden könnte:

 They are unfamiliar, there are no corresponding concepts and *tags*
 it takes a longer sentence to express them in this language

Wenn dies passiert, müssen Sie entscheiden, an welcher Stelle sie eine
Markierung I<schön> ergänzen können. Das sollte nicht leicht sein. Die
Vim-Hilfe-Datei ist in einem hart umgebrochenen Format, selbst für Teile,
die keine Code-Blöcke sind.

Das gleiche gilt für Markierungsreferenzen wie C<|ref|>.

=item Nutzen von C<--wrapcol>, um die Textbreite zu überwachen.

Es scheint ein vernünftiger Ansatz zu sein, die Option C<--wrapcol> zu
verwenden, um Warnungen auszugeben, wenn die Textbreite die festgelegten
Grenzen überschreitet. Die offizielle Vim-Hilfedatei enthält eine
Moduszeile, wie C<vim:tw=78:ts=8:noet:ft=help:norl:>, wie das in
L<C<runtime/doc/if_perl.txt>|https://github.com/vim/vim/blob/04cc8975930b7b2c5d6753d3eddf57dab2816518/runtime/doc/if_perl.txt#L307>
gesehen werden kann. Allerdings sind ein paar Herausforderungen zu meistern:

=over

=item Dateiauswertverhalten

Wenn diese Option implementiert ist, wäre es ideal, die gesamte Datei zuerst
einzulesen, zu ermitteln, ob eine Moduszeile existiert, und dann zu
bestimmen, welche Abschnitte betroffen sind. Unglücklicherweise wird der
fortschreitende Auswertmechanismus in diesem Fall nicht eingesetzt.

=item Standard kontra angepasste Werte

Der generische Standardwert von C<--wrapcol> ist 76, während
VIM-Hilfedateien typischerweise 78 verwenden. In den meisten Fällen ist der
Wert, der in den Optionen an dieses Modul übergeben wird, standardmäßig 76,
aber es ist nicht klar, ob dieser Wert explizit gesetzt oder implizit
angewandt wurde.

=back

=back

=head1 SIEHE AUCH

L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|po4a.7>

=head1 AUTOREN

 gemmaro <gemmaro.dev@gmail.com>

=head1 URHEBERRECHT UND LIZENZ

 Copyright © 2024, 2025 gemmaro.

Dieses Programm ist freie Software; Sie können es unter den Bedingungen der
GPL v2.0 oder neuer (siehe die Datei F<COPYING>) vertreiben und/oder
verändern.
