Hello, the translation help page [1] says:
--- There are currently no efforts underway to include translated manual pages in the pacman codebase. However, this is not to say translations are unwelcome. If someone has experience with i18n man pages and how to best include them with our source, please contact the pacman-dev mailing list at pacman-...@archlinux.org. --- OK, then let me introduce my approach. Although the man page translations are already maintained in the manpages-l10n project [2] for some years, I think it is it better to use Pacman's upstream tree instead. The external maintenance has some disadvantages: We download distribution packages, create the templates, translate them and release the translated man pages some months later. Besides this delay, we don't know how many users know about the existence of the translated versions. Having the translations in the upstream project (translated using Transifex) would be better, and the localized versions would be released with Pacman itself and always in sync with the English ones. See the attached patch and config file. The patch manpage-markup.diff fixes the Asciidoc markup to get Po4a [3] properly working. After applying the patch, put po4a.cfg in doc/po/. I've imported German, Brazilian Portuguese and French translations from manpages-l10n, but even compressed they are too big for the list. The .po files will follow in separate mails.To test the creation of the translated Asciidoc files, just run 'po4a po4a.cfg'. This command creates a translation template and a subdirectory for each language and saves the resulting files there. Once you have the Asciidoc files, they can be processed further like those in doc/. Unfortunately, I don't have neither Autotools nor Meson knowledge, maybe someone else can help with integration into the build systems? [1] https://archlinux.org/pacman/translation-help.html#_translating_manpages [2] https://salsa.debian.org/manpages-l10n-team/manpages-l10n [3] https://po4a.org/index.php.en Best Regards, Mario
diff --git a/doc/makepkg.conf.5.asciidoc b/doc/makepkg.conf.5.asciidoc index 76c27f6a..a5ff4c99 100644 --- a/doc/makepkg.conf.5.asciidoc +++ b/doc/makepkg.conf.5.asciidoc @@ -39,11 +39,11 @@ Options well, and any protocol can have a download agent. Any spaces in option arguments are required to be escaped to avoid being split. Several examples are provided in the default makepkg.conf. - + - If present, `%u` will be replaced with the download URL. Otherwise, the - download URL will be placed on the end of the command. If present, `%o` will - be replaced with the local file name, plus a ``.part'' extension, which allows - makepkg to handle resuming file downloads. ++ +If present, `%u` will be replaced with the download URL. Otherwise, the +download URL will be placed on the end of the command. If present, `%o` will +be replaced with the local file name, plus a ``.part'' extension, which allows +makepkg to handle resuming file downloads. **VCSCLIENTS=(**\'protocol::package' ...**)**:: Sets the packages required to fetch version controlled source files. When @@ -282,9 +282,9 @@ Options Specify a command prefix for running pacman as root. If unset, makepkg will check for the presence of sudo(8) and su(1) in turn, and try the first one it finds. - + - If present, `%c` will be replaced with the shell-quoted form of the command - to run. Otherwise, the command to run is appended to the auth command. ++ +If present, `%c` will be replaced with the shell-quoted form of the command +to run. Otherwise, the command to run is appended to the auth command. diff --git a/doc/pacman.conf.5.asciidoc b/doc/pacman.conf.5.asciidoc index fd765f3d..fbf6ba78 100644 --- a/doc/pacman.conf.5.asciidoc +++ b/doc/pacman.conf.5.asciidoc @@ -127,10 +127,10 @@ Options instances of `%o` will be replaced with the local filename, plus a ``.part'' extension, which allows programs like wget to do file resumes properly. - + - This option is useful for users who experience problems with built-in - HTTP/FTP support, or need the more advanced proxy support that comes with - utilities like wget. ++ +This option is useful for users who experience problems with built-in +HTTP/FTP support, or need the more advanced proxy support that comes with +utilities like wget. *NoUpgrade =* file ...:: All files listed with a `NoUpgrade` directive will never be touched during diff --git a/doc/repo-add.8.asciidoc b/doc/repo-add.8.asciidoc index 8de4485b..1b637c2e 100644 --- a/doc/repo-add.8.asciidoc +++ b/doc/repo-add.8.asciidoc @@ -1,5 +1,5 @@ repo-add(8) -========== +=========== Name ----
po4a.cfg
Description: Binary data
