
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">Hi, as just discussed on PSC meeting. We want to setup some guidelines on i18n of pygeoapi.<div class="">This is an effort to list some of the initial aspects of such a strategy.<br class=""><div class="">Looking forward to hear your thoughts on following aspects:</div><div class=""><br class=""></div><div class="">- Use of Transifex is an option to allow users to translate to their language of choice. Transifex does support a variety of output formats. It is free of use to opensource projects (used by osgeolive, geonetwork, …) Ownership of the translated strings remains with the authors.</div><div class="">- Who can contribute i18n best practices from geopython world? </div><div class="">- i18n in jinja templates. The templates for html generation provide an option to add translations via a jinja i18n extension: <a href="https://jinja.palletsprojects.com/en/2.11.x/templates/#i18n-in-templates" class="">https://jinja.palletsprojects.com/en/2.11.x/templates/#i18n-in-templates</a></div><div class="">- Jinja and python will share a single translation file, or each will have a set of translations, with risk of duplication of basic strings.</div><div class="">- A choice should be made to have the translation key as human readable english (so code can print the key if no translation is provided) or use human unfriendly keys and let the code look up the english translation in case no translation is available.</div><div class="">- Technical errors should not be translated, users should be able to copy paste it into google to find the best match possible.</div><div class="">- Are we also providing translation options for the documentation?</div><div class=""><br class=""></div><div class="">I recently made a translation guidelines document for the geonetwork opensource project at <a href="https://github.com/geonetwork/core-geonetwork/wiki/Translation-guidelines" class="">https://github.com/geonetwork/core-geonetwork/wiki/Translation-guidelines</a>, probably some aspects are relevant to the pygeoapi project as well.</div></div></body></html>