LOCALE::PO4A::VIMHELP.3PM

Section: User Contributed Perl Documentation (1)
Updated: 2025-04-21
Index Return to Main Contents

NAME

Locale::Po4a::VimHelp - convert Vim help files from/to PO files.

DESCRIPTION

The po4a (PO for anything) project goal is to ease translations (and more interestingly, the maintenance of translations) using gettext tools on areas where they were not expected like documentation.

"Locale::Po4a::VimHelp" is a module to help the translation of Vim help file. See also Writing help files <https://vimhelp.org/helphelp.txt.html#help-writing> for its syntax.

CONFIGURATION

textwidth: The default value of the text width parameter for the document (default is 78, as used in most original Vim help files). If specified in the source document modeline, this value will be overridden.

STATUS OF THIS MODULE

This module is in an early stage of development. It has been successfully tested on simple files like "helphelp.txt". However, it has not yet been tested on full help files, and the way it parses them may change for fixes and improvements, especially paragraph wrapping.

DEVELOPING

Parsing Vim help files for po4a is difficult. Here are some obstacles while developing this module. If you have a better idea, feel free to suggest a patch (with additional test cases).

"1. foo" sounds like an ordered list

Not necessarily. Consider the following paragraph.

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

For the same reason, what appears to be a heading (e.g. "1.1 bar") or an unordered list (e.g. "o baz") cannot be detected.

Flushed right tags should be excluded from translation target

This topic is also difficult since it relates to language differences in localization.

Consider the following example.

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

which might be translated to

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

When this happens, you have to decide at what point you want to add a tag nicely. This shouldn't be easy. The Vim help file is in a hard wrapped format, even for parts that are not code blocks.

The same applies to tag references such as "|ref|".

AUTHORS

 gemmaro <gemmaro.dev@gmail.com>

COPYRIGHT AND LICENSE

 Copyright © 2024 gemmaro.

This program is free software; you may redistribute it and/or modify it under the terms of GPL v2.0 or later (see the COPYING file).

This document was created by using the manual pages.
Time: 21:55:53 GMT, April 21, 2025