documentation icon indicating copy to clipboard operation
documentation copied to clipboard

Move formal german user documentation from "de" to "de_DE"

Open rakekniven opened this issue 5 months ago • 13 comments

Actually the server and all apps (desktop and mobile as well) have the formal german translation at language code "de_DE".

The user documentation uses code "de" for the formal version (there is no informal version for the user docs).

This confuses translators at Transifex.

Target is to use de_DE for user docs as well.

rakekniven avatar Jul 04 '25 08:07 rakekniven

@nickvergessen Which steps are necessary for the shift?

rakekniven avatar Jul 04 '25 08:07 rakekniven

That would break all links that were posted anywhere, so I'm against this?

nickvergessen avatar Jul 04 '25 09:07 nickvergessen

See discussion at https://help.nextcloud.com/t/die-deutsche-ubersetzung-von-nextcloud-hier-diskutieren-und-fehler-melden-was-sollte-ich-wissen-wenn-ich-bei-der-ubersetzung-helfen-mochte-oder-eine-anmerkung-habe/32139/624

The user docs have not been available in translated form for very long. That's why there aren't many links yet, I think. In a quick search, I found most of the links to the English docs on German-language sites.

My vote is therefore for the Shift. This would remove an inconsistency for the translators.

rakekniven avatar Jul 04 '25 10:07 rakekniven

Sphinx itself supports German as de only: https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language

Best idea I could come up with would be trying to change transifex sync to map from de_DE to de there.


But while reading the docs:

e.g. the German version of myfigure.png will be myfigure.de.png by default setting

This sounds very interesting for us :)

nickvergessen avatar Jul 11 '25 06:07 nickvergessen

Sphinx itself supports German as de only

We have "fi_FI" and "hu_HU" as well. How does that work?

Best idea I could come up with would be trying to change transifex sync to map from de_DE to de there.

Thought of this solution as well. At least there would be no confusion for the translators at Transifex

rakekniven avatar Jul 11 '25 09:07 rakekniven

We have "fi_FI" and "hu_HU" as well. How does that work?

They don't …

https://docs.nextcloud.com/server/latest/user_manual/nb_NO/

It says "Edit on Github" and "Next" for the pagination

https://docs.nextcloud.com/server/latest/user_manual/de/

German says "Auf GitHub bearbeiten" and "Nächste Seite"

nickvergessen avatar Jul 11 '25 12:07 nickvergessen

Best idea I could come up with would be trying to change transifex sync to map from de_DE to de there.

Do you have an idea how to achieve this?

rakekniven avatar Jul 14 '25 12:07 rakekniven

I wonder if the language map is for that and wanted to try it on Friday, but then something crossed my plans. E.g. we have fi_FI: fi as part of it https://github.com/nextcloud/spreed/blob/main/.tx/config#L3

https://help.transifex.com/en/articles/6265125-github-installation-and-configuration#h_94380d9cd8

I tried adding that for fi_FI now, so let's see if that correctly moves it from fi_FI to fi in https://github.com/nextcloud/documentation/tree/master/user_manual/locale

nickvergessen avatar Jul 21 '25 07:07 nickvergessen

Have you seen the differents of the yaml examples and our json code?

I tried adding that for fi_FI now

Where did you make the changes? Haven't seen a related PR in docs repo.

rakekniven avatar Jul 21 '25 19:07 rakekniven

In Transifex in the GitHub Sync settings, but it seemed to have no effect:

Image

Ref https://help.transifex.com/en/articles/6265125-github-installation-and-configuration#h_94380d9cd8

The REMOTE_CODE is the language code supported by Transifex. And the LOCAL_CODE is your language code.

So I would have expected uk from Transifex syncs down as uk_UA, but the files are still in uk: https://github.com/nextcloud/documentation/tree/master/user_manual/locale/uk/LC_MESSAGES

nickvergessen avatar Jul 21 '25 20:07 nickvergessen

But now that I posted it, maybe it is not translated 100%, let me try a sync with less %

nickvergessen avatar Jul 21 '25 20:07 nickvergessen

Hello,

any news here?

rakekniven avatar Aug 28 '25 07:08 rakekniven

Ping :-)

rakekniven avatar Oct 03 '25 20:10 rakekniven