Come together with the global Drupal community in Rotterdam, 28 Sept – 1 Oct 2026. Sessions, contribution, connection, and Early Bird savings until 8 June.I am a module maintainer.
Someone has posted a translation for one of my modules.
I know nothing about translations.
Where do I go?
This page http://drupal.org/node/11130 said:
> For developers adding multilingual support to modules, see the Multilingual support handbook section.
That took me to http://drupal.org/node/303984
I didn't find anything useful there, but it said:
> See the Translation of contributed modules handbook section for information on how to generate POT files for your module.
That took me to http://drupal.org/node/11396
This is about a translator creating the files, not for a module maintainer doing something with them.
I've looked here too: http://drupal.org/node/7765 but nothing.
Help!
Comments
Comment #1
jhodgdonHmmmm...
When I go to http://drupal.org/node/11130, I see in the left sidebar (book navigation) a "sibling" page called "Translation of contributed modules", which is http://drupal.org/node/11396
That page (which I guess you did mention above), says in its last paragraph that you should put the translations into the /translations directory of your project. Does that help?
However, I take your point that the information is a bit disorganized, so I'll leave this issue open (marking it "normal" rather than "critical" since the information is on one of the pages you found). If I have time later this week, I'll see about doing something about it.
Comment #2
jhodgdonJust a note that this information on translating should also be more prominently linked from the "Getting Involved: contrib module" section http://drupal.org/node/7765, as well as the module dev guide http://drupal.org/developing/modules
Comment #3
jhodgdonI think I've improved the situation sufficiently, so I'm marking this fixed. Please check out the pages linked above, and if you don't agree the translation information is easy to find, please leave a comment and re-open this issue.
Comment #4
joachim commentedI'm still not entirely surre which bit I'm meant to find.
Here http://drupal.org/node/303984 there is the following sentence:
Is that it? It's shoved in the middle of a paragraph -- blink and you've missed it.
The links on that page like 'Tutorial - Building a multi-language site' make it look like the whole page isn't relevant when I scan it.
What is needed is either a clear heading or a dedicated page that says "Translating your contrib module".
The question that needs answering is: "Someone has just posted a PO file for my module. What do I do with it?" and it needs to be answered in simple steps that a maintainer looking at the issue queue late at night can follow without engaging their brain. Eg:
What to do with PO files:
1. Create a translations subfolder if not already
2. Unzip
3. Stick it in.
If it's really that simple then that's great -- it's just a mystery to me and the docs should provide confirmation that it really is that simple :)
Comment #5
jhodgdonHow's this version?
http://drupal.org/node/303984
Comment #6
joachim commentedHuge improvement! Very clear, thank you :D