Add po4a for ru translate

[ArduanovDanil]

No description provided.

[samdark]

Thank you!

[rob006]

Is it possible to have a more practical directory structure? From translator POV it is more practical to have all translated files for single language in one directory. Something like:

en/
    caching_data.md.pot
    caching_overview.md.pot
    ...
ru/
    caching_data.md.po
    caching_overview.md.po
    ...

[ArduanovDanil]

Hi, @rob006! Is it really need? :) When we did translating with .po files we didn't think about convenience in directories :) What about this structure?

Directory pot for .pot files and {lang} for .po files? You can see it this repository https://github.com/ArduanovDanil/docs/tree/po4a-files-in-one-dir/cookbook/po

[rob006]

What about this structure?

Looks good for me. 👍

Although I wouldn't use po as directory name - it looks like a another language code (and while po is not used right now as a valid language code, it could be used in the future). I would go with something like _translations - that would make clear distinct and put this directory at the top, so it would separate it from MD files.

[rob006]

I would remove redundant language codes from file names:
cookbook/po/ru/README.md.ru.po
->
cookbook/po/ru/README.md.po

[ArduanovDanil]

Maybe this?

https://github.com/ArduanovDanil/docs/tree/3c82bd73c6b15b925aab590c1ff79a6e52b6848d/_translations/cookbook

[rob006]

I would go with:

_translations/
   cookbook/
      pot/
         README.md.pot
         ...
      po/
         ru/
            README.md.po
            ...
         pl/
            README.md.po
            ...

That should be quite easy to integrate this with external tools like Weblate (which IMO should be a next step).

Alternatively I would remove po and pot directories completely:

_translations/
   cookbook/
      README.md.pot
      ...
      ru/
         README.md.po
         ...
      pl/
         README.md.po
         ...

[ArduanovDanil]

Something like that

https://github.com/ArduanovDanil/docs/tree/69c25d1cad213f06645bd50e8a60b94d4c00793e/_translations/cookbook