Translation of Paperless-ng

[jonaswinkler]

In an effort to provide Paperless-NG in multiple languages, I've started a translation project at crowdin, which is free for open source projects.

https://crowdin.com/project/paperless-ng (please head over to paperless-ngx)

I will provide English and German translations, but will be unable to provide anything more than that. If you wan't to see paperless in your own language, please help out! The project page shows the current languages of paperless. If you want a new language added to the project, either mention me in this issue or post a message in the discussion section at crowdin.

Some notes about translation.

• There are two resources. "src-ui/messages.xlf" is what contains the translation strings for the front end. This is important. "django.po" contains strings for the administration section of paperless, which is nice to have translated.
• Keep in mind that most of these strings are used on buttons, menu items, etc. The translated string should therefore not be much longer than the English original.
• Translation units may contain placeholders. These usually mean that there's a name of a tag or document or something in the string. You can click on the placeholders to copy them.
• Translation units may contain plural expressions such as {PLURAL_VAR, plural, =1 {one result} =0 {no results} other {<placeholder> results}}. Copy these verbatim and translate only the content in the inner {} brackets. Example: {PLURAL_VAR, plural, =1 {Ein Ergebnis} =0 {Keine Ergebnisse} other {<placeholder> Ergebnisse}}
• Changes to translations in crowdin will get pushed into the repository automatically.

[jonaswinkler]

I found it pretty hard to find good German translations for some of the terms in paperless. This usually indicates that the given term might not be the best one to use in English and we should consider finding better terms for some features.

• Saved View: This was "Saved filter" before, but since it also includes sorting, I renamed it to this.
• Matching algorithm: Is it clear what this is? We're used to saying "to match a regex against something", therefore "Matching". Maybe it's just me failing to find a good translation.
• Any, All, Fuzzy, etc. I don't think its very clear what these do without consulting the documentation. Can we do better?

I'd like to hear about these (and maybe other) from some native English speakers.

[qcasey]

Are you looking to replace Saved View with something different? That one seems quite clear.

Any, All, Fuzzy, etc. I don't think its very clear what these do without consulting the documentation. Can we do better?

Even after reading the docs I have no idea what Fuzzy match can provide, especially in contrast to Auto. Misspellings maybe?

Contains All / Contains Any might be a little clearer. Similarly Exact Match might be better than Literal.

[qcasey]

This may be a different discussion, but if you're up for change, would something like this translate well? Perhaps with "Auto" as the default and with the lower items hidden, while "Search" brings up the extra options?

Regardless, I think some examples should show up in the Match field's placeholder/hint text.

[jonaswinkler]

Are you looking to replace Saved View with something different? That one seems quite clear.

Alright, good to know!

Even after reading the docs I have no idea what Fuzzy match can provide, especially in contrast to Auto. Misspellings maybe?

That searches for terms that are similar to the provided matches. possibly useful for when OCR messes up. I never used it though.

Regarding the screenshots:

"When document contains DROPDOWN of the following" is hard to translate, and doesn't really work for "exact match" or "regex". However, providing much longer names for the algorithms in the drop down might be the key here.

[shamoon]

I think he's also asking about #164 . Do you remember what the issue was with hiding it? I can take a look if you want, I see theres a lot of other stuff going on right now!

[jonaswinkler]

Not sure. I just couldn't hook up the disabled attribute with the reactive form model.

Btw, localization support is on the development branch now. The next release will have localization support. Paperless will then support English, German, and any language that's sufficiently translated (untranslated strings will appear in English). Translating the .xlf file is mandatory, the .po is nice to have.

[shamoon]

Yea that localization tool seems awesome, crazy how fast you got all that spun up, seems like will be very straightforward for people to add other languages. Sorted out that other thing, I think.