From: Bruce Momjian <bruce@momjian.us>
To: Daniel Gustafsson <daniel@yesql.se>
Cc: goran.luledzija@gmail.com, Pg Docs <pgsql-docs@lists.postgresql.org>
Cc: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
Cc: Georgios <gkokolatos@protonmail.com>
Subject: Re: Update documentation page for translators
Date: Wed, 17 Aug 2022 16:56:57 -0400
Message-ID: <Yv1WGYHevqZCmdU7@momjian.us> (raw)
In-Reply-To: <84001965-130C-4622-A7ED-DAEACF7A3BCC@yesql.se>
References: <163490116698.684.10398197970578456928@wrigleys.postgresql.org>
<84001965-130C-4622-A7ED-DAEACF7A3BCC@yesql.se>
Is there a reason this patch was not applied?
---------------------------------------------------------------------------
On Fri, Nov 12, 2021 at 02:46:40PM +0100, Daniel Gustafsson wrote:
> > On 22 Oct 2021, at 13:12, PG Doc comments form <noreply@postgresql.org> wrote:
> >
> > The following documentation comment has been logged on the website:
> >
> > Page: https://www.postgresql.org/docs/11/nls-translator.html
> > Description:
> >
> > In the documentation for translators
> > (https://www.postgresql.org/docs/11/nls-translator.html) it is mentioned to
> > use any text editor for translating .po files. It can be very error prone
> > with regular text editors, especiially for non-tech people such as
> > translators.
>
> I think this makes sense, having done some translation work myself I agree that
> the PO editors out there can help quite a bit. Now, I'm sure anyone interested
> is perfectly capable of Googling, but since this chapter is there to help
> potential or new contributors I think it's fine to lower the bar and be a bit
> more verbose.
>
> I don't feel like linking to any specific tool though, so I just added a small
> sentence to indicate that options exist, and that we don't necessarily require
> anyone to use a text editor.
>
> CC:ing developers who have spent time with translations for input.
>
> --
> Daniel Gustafsson https://vmware.com/
>
> diff --git a/doc/src/sgml/nls.sgml b/doc/src/sgml/nls.sgml
> index d49f44f3f2..0b3c638594 100644
> --- a/doc/src/sgml/nls.sgml
> +++ b/doc/src/sgml/nls.sgml
> @@ -202,7 +202,9 @@ make update-po
> <title>Editing the PO Files</title>
>
> <para>
> - The PO files can be edited with a regular text editor. The
> + The PO files can be edited with a regular text editor. There are also
> + several specialized editors for PO files which can help the process with
> + translation specific features. The
> translator should only change the area between the quotes after
> the msgstr directive, add comments, and alter the fuzzy flag.
> There is (unsurprisingly) a PO mode for Emacs, which I find quite
--
Bruce Momjian <bruce@momjian.us> https://momjian.us
EDB https://enterprisedb.com
Indecision is a decision. Inaction is an action. Mark Batterson
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: bruce@momjian.us, daniel@yesql.se, pgsql-docs@lists.postgresql.org, peter.eisentraut@enterprisedb.com, gkokolatos@protonmail.com
Subject: Re: Update documentation page for translators
In-Reply-To: <Yv1WGYHevqZCmdU7@momjian.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox