GNOME Bugzilla – Bug 713831
Make help documentation translatable
Last modified: 2014-03-17 19:02:54 UTC
---- Reported by jim@yorba.org 2013-11-18 12:10:00 -0800 ---- Original Redmine bug id: 7703 Original URL: http://redmine.yorba.org/issues/7703 Searchable id: yorba-bug-7703 Original author: Jim Nelson Original description: A request has been made on the mailing list to make our help documentation translatable. This task is only to make the documentation available for translation; once done, we should open a separate ticket for automating importing the translations into the code base and properly installing them with `make install`. --- Bug imported by chaz@yorba.org 2013-11-21 20:23 UTC --- This bug was previously known as _bug_ 7703 at http://redmine.yorba.org/show_bug.cgi?id=7703 Unknown version " in product geary. Setting version to "!unspecified". Unknown milestone "unknown in product geary. Setting to default milestone for this product, "---". Setting qa contact to the default for this product. This bug either had no qa contact or an invalid one. Resolution set on an open status. Dropping resolution
Geary's help documentation is now available on Damned Lies, so I believe that portion of this ticket is complete. The last step here will be to verify that the translated pages are installed properly and used when the user presses F1.
In a couple of weeks I should have the time to translate the help pages in italian and check if F1 works fine. I'll keep you posted!
I've started the translation of the it.po file, but I need your help to test if it's working correctly. I've put the file in help/it/it.po, add "it" to DOC_LINGUAS in help/Makefile.am and run 'make && sudo make install'. When I click F1, the section I've started translating (write a message) is still in english. These are the help files installed: $ ls /usr/local/share/gnome/help/geary/C accounts.page figures limits.page search.page write.page archive.page index.page overview.page shortcuts.page bugs.page label.page preferences.page star.page What should I expect to see?
Federico, we previously weren't installing translated help docs at all (we weren't even generating them from the po files). I've whipped up a branch that does this work: wip/install-l10n-help-713831. With that branch, when you build Geary it should also generate translated help pages, and when you install Geary it should also install the generated translated help pages. They'll end up in /usr/local/share/gnome/help/geary/<locale>. You should then be able to simply launch Help from Geary (with your system locale set to one we have help translations for) and see the translations. One caveat for now is that we're duplicating the list of help page filenames and translation languages in both help/Makefile.am (for Damned Lies) and help/CMakeLists.txt (for our build process). So, you'll have to add your locale to the cmake file for Geary to actually build and install it. Please try the branch out and let us know if it works for you. Thanks!
I've checked out that branch and I confirm that it works. I'm at 60% of translation, it should be ready soon
Fixed in commit 2e30e47.