pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedUpdate documentation page for translators
6+ messages / 3 participants
[nested] [flat]
* Update documentation page for translators
@ 2021-10-22 11:12 PG Doc comments form <noreply@postgresql.org>
0 siblings, 1 reply; 6+ messages in thread
From: PG Doc comments form @ 2021-10-22 11:12 UTC (permalink / raw)
To: pgsql-docs@lists.postgresql.org; +Cc: goran.luledzija@gmail.com
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 thought you it would be useful to suggest usage of dedicated editors for
.po files, such as "Free PO editor" (https://pofile.net/free-po-editor)
which will guide them how to translate, without file structure errors.
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Update documentation page for translators
@ 2021-11-12 13:46 Daniel Gustafsson <daniel@yesql.se>
parent: PG Doc comments form <noreply@postgresql.org>
0 siblings, 1 reply; 6+ messages in thread
From: Daniel Gustafsson @ 2021-11-12 13:46 UTC (permalink / raw)
To: goran.luledzija@gmail.com, Pg Docs <pgsql-docs@lists.postgresql.org>; +Cc: Peter Eisentraut <peter.eisentraut@enterprisedb.com>; Georgios <gkokolatos@protonmail.com>
> 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/
Attachments:
[application/octet-stream] translations.diff (704B, ../../84001965-130C-4622-A7ED-DAEACF7A3BCC@yesql.se/2-translations.diff)
download | inline diff:
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
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Update documentation page for translators
@ 2022-08-17 20:56 Bruce Momjian <bruce@momjian.us>
parent: Daniel Gustafsson <daniel@yesql.se>
0 siblings, 1 reply; 6+ messages in thread
From: Bruce Momjian @ 2022-08-17 20:56 UTC (permalink / raw)
To: Daniel Gustafsson <daniel@yesql.se>; +Cc: goran.luledzija@gmail.com, Pg Docs <pgsql-docs@lists.postgresql.org>; Peter Eisentraut <peter.eisentraut@enterprisedb.com>; Georgios <gkokolatos@protonmail.com>
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
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Update documentation page for translators
@ 2022-08-17 20:58 Daniel Gustafsson <daniel@yesql.se>
parent: Bruce Momjian <bruce@momjian.us>
0 siblings, 1 reply; 6+ messages in thread
From: Daniel Gustafsson @ 2022-08-17 20:58 UTC (permalink / raw)
To: Bruce Momjian <bruce@momjian.us>; +Cc: goran.luledzija@gmail.com, Pg Docs <pgsql-docs@lists.postgresql.org>; Peter Eisentraut <peter.eisentraut@enterprisedb.com>; Georgios <gkokolatos@protonmail.com>
> On 17 Aug 2022, at 22:56, Bruce Momjian <bruce@momjian.us> wrote:
> Is there a reason this patch was not applied?
Only that it fell of my radar, if you think it's adding value I'm happy to get
it done now.
--
Daniel Gustafsson https://vmware.com/
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Update documentation page for translators
@ 2022-08-17 21:24 Bruce Momjian <bruce@momjian.us>
parent: Daniel Gustafsson <daniel@yesql.se>
0 siblings, 1 reply; 6+ messages in thread
From: Bruce Momjian @ 2022-08-17 21:24 UTC (permalink / raw)
To: Daniel Gustafsson <daniel@yesql.se>; +Cc: goran.luledzija@gmail.com, Pg Docs <pgsql-docs@lists.postgresql.org>; Peter Eisentraut <peter.eisentraut@enterprisedb.com>; Georgios <gkokolatos@protonmail.com>
On Wed, Aug 17, 2022 at 10:58:55PM +0200, Daniel Gustafsson wrote:
> > On 17 Aug 2022, at 22:56, Bruce Momjian <bruce@momjian.us> wrote:
>
> > Is there a reason this patch was not applied?
>
> Only that it fell of my radar, if you think it's adding value I'm happy to get
> it done now.
Sure, it looked useful to me too.
--
Bruce Momjian <bruce@momjian.us> https://momjian.us
EDB https://enterprisedb.com
Indecision is a decision. Inaction is an action. Mark Batterson
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Update documentation page for translators
@ 2022-08-17 21:47 Daniel Gustafsson <daniel@yesql.se>
parent: Bruce Momjian <bruce@momjian.us>
0 siblings, 0 replies; 6+ messages in thread
From: Daniel Gustafsson @ 2022-08-17 21:47 UTC (permalink / raw)
To: Bruce Momjian <bruce@momjian.us>; +Cc: goran.luledzija@gmail.com, Pg Docs <pgsql-docs@lists.postgresql.org>; Peter Eisentraut <peter.eisentraut@enterprisedb.com>; Georgios <gkokolatos@protonmail.com>
> On 17 Aug 2022, at 23:24, Bruce Momjian <bruce@momjian.us> wrote:
>
> On Wed, Aug 17, 2022 at 10:58:55PM +0200, Daniel Gustafsson wrote:
>>> On 17 Aug 2022, at 22:56, Bruce Momjian <bruce@momjian.us> wrote:
>>
>>> Is there a reason this patch was not applied?
>>
>> Only that it fell of my radar, if you think it's adding value I'm happy to get
>> it done now.
>
> Sure, it looked useful to me too.
Done, thanks.
--
Daniel Gustafsson https://vmware.com/
^ permalink raw reply [nested|flat] 6+ messages in thread
end of thread, other threads:[~2022-08-17 21:47 UTC | newest]
Thread overview: 6+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2021-10-22 11:12 Update documentation page for translators PG Doc comments form <noreply@postgresql.org>
2021-11-12 13:46 ` Daniel Gustafsson <daniel@yesql.se>
2022-08-17 20:56 ` Bruce Momjian <bruce@momjian.us>
2022-08-17 20:58 ` Daniel Gustafsson <daniel@yesql.se>
2022-08-17 21:24 ` Bruce Momjian <bruce@momjian.us>
2022-08-17 21:47 ` Daniel Gustafsson <daniel@yesql.se>
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