Wiki articles on translating Koha
Hi, last week I posted this request on the DACH Koha mailing list, but maybe it is better here. I was about to suggest to some of our new Koha users to contribute to Koha translation and manual translation, as these are nice tasks that non-programmers can do to support Koha development. However, the Wiki pages on translation are outdated: https://wiki.koha-community.org/wiki/Translating_the_Koha_Manual https://wiki.koha-community.org/wiki/Translating_Koha Is there any web page with up-to-date instructions on how to work on Koha translations with Weblate that I can point interested people to? There is a wiki article relating to Weblate, but it is on the migration from Pootle to Weblate and seems too complicated for newbies anyway: https://wiki.koha-community.org/wiki/Translation_server_migration_weblate Unfortunately I cannot update the wiki pages myself, as I lack the necessary Weblate expertise (and am not sure I am using it correctly in the first place). Thanks in advance for any hints or updated Wiki pages. Anke Bruns -- Anke Bruns M.A. (LIS) Arbeitsgruppe "Anwendungs- und Informationssysteme" E-Mail: anke.bruns@gwdg.de Tel.: +49 551 39-30291 ------------------------------------------------- Gesellschaft für wissenschaftliche Datenverarbeitung mbH Göttingen (GWDG) Burckhardtweg 4, 37077 Göttingen, URL: https://gwdg.de Support: Tel.: +49 551 39-30000, URL: https://gwdg.de/support Sekretariat: Tel.: +49 551 39-30001, E-Mail: gwdg@gwdg.de Geschäftsführer: Prof. Dr. Ramin Yahyapour Aufsichtsratsvorsitzender: Prof. Dr. Christian Griesinger Sitz der Gesellschaft: Göttingen Registergericht: Göttingen, Handelsregister-Nr. B 598 ------------------------------------------------- Zertifiziert nach ISO 9001 und ISO 27001
Hello, What kind of information do you think the wiki page is missing? I can answer your questions if you have some. Regards, Jonathan Le lun. 18 mars 2024 à 10:24, Bruns, Anke via Koha-translate <koha-translate@lists.koha-community.org> a écrit :
Hi,
last week I posted this request on the DACH Koha mailing list, but maybe it is better here.
I was about to suggest to some of our new Koha users to contribute to Koha translation and manual translation, as these are nice tasks that non-programmers can do to support Koha development. However, the Wiki pages on translation are outdated:
https://wiki.koha-community.org/wiki/Translating_the_Koha_Manual https://wiki.koha-community.org/wiki/Translating_Koha
Is there any web page with up-to-date instructions on how to work on Koha translations with Weblate that I can point interested people to?
There is a wiki article relating to Weblate, but it is on the migration from Pootle to Weblate and seems too complicated for newbies anyway: https://wiki.koha-community.org/wiki/Translation_server_migration_weblate
Unfortunately I cannot update the wiki pages myself, as I lack the necessary Weblate expertise (and am not sure I am using it correctly in the first place).
Thanks in advance for any hints or updated Wiki pages.
Anke Bruns
-- Anke Bruns M.A. (LIS) Arbeitsgruppe "Anwendungs- und Informationssysteme" E-Mail: anke.bruns@gwdg.de Tel.: +49 551 39-30291 ------------------------------------------------- Gesellschaft für wissenschaftliche Datenverarbeitung mbH Göttingen (GWDG) Burckhardtweg 4, 37077 Göttingen, URL: https://gwdg.de
Support: Tel.: +49 551 39-30000, URL: https://gwdg.de/support Sekretariat: Tel.: +49 551 39-30001, E-Mail: gwdg@gwdg.de
Geschäftsführer: Prof. Dr. Ramin Yahyapour Aufsichtsratsvorsitzender: Prof. Dr. Christian Griesinger Sitz der Gesellschaft: Göttingen Registergericht: Göttingen, Handelsregister-Nr. B 598 ------------------------------------------------- Zertifiziert nach ISO 9001 und ISO 27001 _______________________________________________ Koha-translate mailing list Koha-translate@lists.koha-community.org https://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-translate website: www.koha-community.org git: git.koha-community.org bugs: bugs.koha-community.org
Hi, what I mean is what how to page can I direct possible would-be Koha translators to if they want to inform themselves on how to participate in translations. The wiki pages relate to the former Pootle translation system and should be updated. I find it confusing myself to use the new Weblate and would also be happy to have some instructions. Concrete questions would be: - How to find one's way about the Weblate pages - How is a translation done, what are the steps to take? - What's the difference between proposing or submitting a translation? - How to find the relevant context of text passages? - Syntax to use when linking to parts of Koha or the Manual? - What to do if one made a mistake and already submitted the passage in question? - What happens if contents of the manual have to be changed, deleted or extended for a new Koha version - are there alerts telling people which passages to look at and work on with priority? - After submitting / proposing a translation, what are the following steps and when and how does the translated text passage make its way into a Koha or manual version? - What does the message "String freeze" in the mailing list mean? There might be more that I can't think of at present. Regards, Anke
-----Ursprüngliche Nachricht----- Von: Jonathan Druart <jonathan.druart@bugs.koha-community.org> Gesendet: Mittwoch, 20. März 2024 09:05 An: Bruns, Anke <Anke.Bruns@gwdg.de> Cc: koha-translate@lists.koha-community.org Betreff: Re: [Koha-translate] Wiki articles on translating Koha
Hello,
What kind of information do you think the wiki page is missing? I can answer your questions if you have some.
Regards, Jonathan
Le lun. 18 mars 2024 à 10:24, Bruns, Anke via Koha-translate <koha-translate@lists.koha-community.org> a écrit :
Hi,
last week I posted this request on the DACH Koha mailing list, but maybe it is better here.
I was about to suggest to some of our new Koha users to contribute to
Koha
translation and manual translation, as these are nice tasks that non-programmers can do to support Koha development. However, the Wiki pages on translation are outdated:
https://wiki.koha-community.org/wiki/Translating_the_Koha_Manual https://wiki.koha-community.org/wiki/Translating_Koha
Is there any web page with up-to-date instructions on how to work on Koha translations with Weblate that I can point interested people to?
There is a wiki article relating to Weblate, but it is on the migration from Pootle to Weblate and seems too complicated for newbies anyway: https://wiki.koha- community.org/wiki/Translation_server_migration_weblate
Unfortunately I cannot update the wiki pages myself, as I lack the necessary Weblate expertise (and am not sure I am using it correctly in the first place).
Thanks in advance for any hints or updated Wiki pages.
Anke Bruns
-- Anke Bruns M.A. (LIS) Arbeitsgruppe "Anwendungs- und Informationssysteme" E-Mail: anke.bruns@gwdg.de Tel.: +49 551 39-30291 ------------------------------------------------- Gesellschaft für wissenschaftliche Datenverarbeitung mbH Göttingen (GWDG) Burckhardtweg 4, 37077 Göttingen, URL: https://gwdg.de
Support: Tel.: +49 551 39-30000, URL: https://gwdg.de/support Sekretariat: Tel.: +49 551 39-30001, E-Mail: gwdg@gwdg.de
Geschäftsführer: Prof. Dr. Ramin Yahyapour Aufsichtsratsvorsitzender: Prof. Dr. Christian Griesinger Sitz der Gesellschaft: Göttingen Registergericht: Göttingen, Handelsregister-Nr. B 598 ------------------------------------------------- Zertifiziert nach ISO 9001 und ISO 27001 _______________________________________________ Koha-translate mailing list Koha-translate@lists.koha-community.org https://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-translate website: www.koha-community.org git: git.koha-community.org bugs: bugs.koha-community.org
Hi, I am attaching a presentation about Weblate I gave during the last Swedish Koha User Group meeting. Trying to answer you:
Concrete questions would be: - How to find one's way about the Weblate pages
We are using a new feature of Weblate: the categories. It allows us to have a tree structure. First the project, then the categories and finally the components. * https://translate.koha-community.org/projects/ In our case, the project is "Koha". We are also using Weblate to translate the manual. * https://translate.koha-community.org/projects/koha/ the categories are the different versions of Koha we maintain * https://translate.koha-community.org/projects/koha/master/ and the components are the different .po files.
- How is a translation done, what are the steps to take?
If you want to translate "master" in German, I am suggesting you this view: https://translate.koha-community.org/projects/koha/master/-/de/ You pick a component, say "messages" then you can select the strings that are not translated yet "Untranslated strings": https://translate.koha-community.org/translate/koha/master/messages/de/?q=st... Enter your translation, save. It's done :)
- What's the difference between proposing or submitting a translation?
Everybody needs an account to contribute. If you have an account but are not part of a group you can only do suggestions. People part of a group can submit translations and approve suggestions. Administrators of a group can manage it (add/remove members)
- How to find the relevant context of text passages?
See the presentation p.17. There is a "String information" block on the right of the page when you translate, that give you information about the file and line number. For instance this string https://translate.koha-community.org/translate/koha/master/messages/de/?chec... is at koha-tmpl/intranet-tmpl/prog/en/modules/suggestion/suggestion.tt:1509 Which is this place in the code: https://gitlab.com/koha-community/Koha/-/blob/master/koha-tmpl/intranet-tmpl... (bad example, it's not really useful...)
- Syntax to use when linking to parts of Koha or the Manual?
What do you mean? Do you have an example?
- What to do if one made a mistake and already submitted the passage in question?
Just edit again and resubmit.
- What happens if contents of the manual have to be changed, deleted or extended for a new Koha version - are there alerts telling people which passages to look at and work on with priority?
If your question is about the manual you should contact the documentation team. Especifically Caroline or Aude.
- After submitting / proposing a translation, what are the following steps and when and how does the translated text passage make its way into a Koha or manual version?
See page 6 of the presentation. When you submit a translation change it will be part of the Weblate database then it will be merged with the existing strings during the night and then be part of the koha-l10n repository. https://gitlab.com/koha-community/koha-l10n Which means it is available in the developer environment (koha-testing-docker) the day after (as well as the sandboxes) you made the changes. The next releases will contain it.
- What does the message "String freeze" in the mailing list mean?
It means that the release maintainers will stop pushing patches with string changes. That gives time to the translators to fully translate the version before it is released. Example: Release is on 23th String freeze on 20th Maintainers will push patches with string changes until 20th. After that they will only push bug fixes without string changes. At night, Weblate cronjob script will merge the new strings (from Koha) and the new translations (from Weblate) and push them to koha-l10n => Weblate has the new strings that were present in the patches from the day => Koha will be able to use koha-l10n with the new translations Translators have 3 days to translate. On 23th the package maintainer will generate the new debian packages with the new release of Koha and the last version of koha-l10n (from the branch, there is one branch in koha-l10n per version of Koha)
There might be more that I can't think of at present.
Let me know if you have more! :) Cheers, Jonathan
Regards, Anke
-----Ursprüngliche Nachricht----- Von: Jonathan Druart <jonathan.druart@bugs.koha-community.org> Gesendet: Mittwoch, 20. März 2024 09:05 An: Bruns, Anke <Anke.Bruns@gwdg.de> Cc: koha-translate@lists.koha-community.org Betreff: Re: [Koha-translate] Wiki articles on translating Koha
Hello,
What kind of information do you think the wiki page is missing? I can answer your questions if you have some.
Regards, Jonathan
Le lun. 18 mars 2024 à 10:24, Bruns, Anke via Koha-translate <koha-translate@lists.koha-community.org> a écrit :
Hi,
last week I posted this request on the DACH Koha mailing list, but maybe it is better here.
I was about to suggest to some of our new Koha users to contribute to
Koha
translation and manual translation, as these are nice tasks that non-programmers can do to support Koha development. However, the Wiki pages on translation are outdated:
https://wiki.koha-community.org/wiki/Translating_the_Koha_Manual https://wiki.koha-community.org/wiki/Translating_Koha
Is there any web page with up-to-date instructions on how to work on Koha translations with Weblate that I can point interested people to?
There is a wiki article relating to Weblate, but it is on the migration from Pootle to Weblate and seems too complicated for newbies anyway: https://wiki.koha- community.org/wiki/Translation_server_migration_weblate
Unfortunately I cannot update the wiki pages myself, as I lack the necessary Weblate expertise (and am not sure I am using it correctly in the first place).
Thanks in advance for any hints or updated Wiki pages.
Anke Bruns
-- Anke Bruns M.A. (LIS) Arbeitsgruppe "Anwendungs- und Informationssysteme" E-Mail: anke.bruns@gwdg.de Tel.: +49 551 39-30291 ------------------------------------------------- Gesellschaft für wissenschaftliche Datenverarbeitung mbH Göttingen (GWDG) Burckhardtweg 4, 37077 Göttingen, URL: https://gwdg.de
Support: Tel.: +49 551 39-30000, URL: https://gwdg.de/support Sekretariat: Tel.: +49 551 39-30001, E-Mail: gwdg@gwdg.de
Geschäftsführer: Prof. Dr. Ramin Yahyapour Aufsichtsratsvorsitzender: Prof. Dr. Christian Griesinger Sitz der Gesellschaft: Göttingen Registergericht: Göttingen, Handelsregister-Nr. B 598 ------------------------------------------------- Zertifiziert nach ISO 9001 und ISO 27001 _______________________________________________ Koha-translate mailing list Koha-translate@lists.koha-community.org https://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-translate website: www.koha-community.org git: git.koha-community.org bugs: bugs.koha-community.org
participants (2)
-
Bruns, Anke -
Jonathan Druart