Differences

This shows you the differences between two versions of the page.

--- dev:localization [2012/02/16 10:01] – [Zotero Client] rmzelle
+++ dev:localization [2022/12/06 20:44] (current) – [Desktop App] dstillman
@@ Line 1: / Line 1: @@
 ====== Localization ======
-While Zotero is primarily developed in English, many parts of the Zotero ecosystem can be translated into other languages. These include the Zotero client, the wiki documentation, and the Citation Style Language (CSL) citation styles.
+While Zotero is primarily developed in English, most parts of the Zotero ecosystem have been translated into other languages. These include the Zotero client, the wiki documentation, and the Citation Style Language (CSL) citation styles.
-===== Zotero Client =====
+===== Desktop App =====
-The Zotero client software is currently localized into over 40 languages. To localize the Zotero client in your favorite language, sign up for free at https://www.transifex.net, go to the Transifex Zotero project page, https://www.transifex.net/projects/p/zotero/, and join a language translator team.
+Translation efforts for the Zotero desktop app exist for over 40 languages, but many languages are still incomplete. To help localize Zotero in your favorite language, sign up for free at https://www.transifex.com, go to the [[https://www.transifex.com/zotero/zotero/|Transifex Zotero project page]], and join a language translator team.
-You can test translations by [[:kb/user_interface_language|changing the language of the Zotero interface]].
+**Note** Translators should also check already translated strings, as some English strings have changed over time (predominantly to account for the move to Zotero as a standalone desktop app, rather than the Zotero for Firefox plugin).
-===== Documentation =====
-The contents of the Zotero wiki can be translated into a number of languages: at the top of each wiki page, a row of buttons shows the available languages. A language button is blue when a wiki page already exists for that language; otherwise it is grey. Clicking a language button moves you to the version of the page for that particular language.
+Translations can be tested by [[:kb/user_interface_language|changing the language of the Zotero interface]].
-The languages currently available are (languages abbreviations follow [[http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes | ISO 639-1]]):
+===== CSL Styles =====
-  * en - English
+Zotero uses Citation Style Language (CSL) styles to format citations and bibliographies. CSL has advanced support for (automatic) localization of terms (e.g. "and" [English] and "und" [German]), date formats (e.g. mm/dd/yyyy [American English] and dd/mm/yyyy [Dutch]), and grammar rules.
-  * ar - Arabic
-  * cs - Czech
-  * da - Danish
-  * de - German
-  * es - Spanish
-  * fr - French
-  * hu - Hungarian
-  * it - Italian
-  * ja - Japanese
-  * ko - Korean
-  * nl - Dutch
-  * pl - Polish
-  * pt - Portuguese
-  * ru - Russian
-  * sl - Slovenian
-  * sv - Swedish
-  * zh - Chinese
-If you would like to translate the wiki into a language that is currently not available, feel free to post a request on the Zotero forums to have that language added.
+CSL styles rely on a shared set of language-specific CSL locale files. Localization data can also be embedded in the styles themselves to override the data stored in these locale files.
-For editing the Zotero wiki, see the information on [[dev/documentation | writing Zotero documentation]].
+To learn more about the localization support of CSL, read the sections of the CSL specification on [[http://citationstyles.org/downloads/specification.html#locale-files-structure | locale files]], [[http://citationstyles.org/downloads/specification.html#locale | embedding localization data in styles]], and the [[http://citationstyles.org/downloads/specification.html#the-root-element-cs-style|default-locale attribute]].
-===== CSL Styles =====
+To learn how to contribute to the collection of CSL locale files, and to see the status of translation, see the [[https://github.com/citation-style-language/locales/wiki | CSL locale repository wiki]].
-Zotero uses Citation Style Language (CSL) styles to format citations and bibliographies. CSL has advanced support for (automatic) localization of terms (e.g. "and" [English] and "und" [German]), date formats (e.g. mm/dd/yyyy [American English] and dd/mm/yyyy [Dutch]), and grammar rules.
+===== Documentation =====
-CSL styles rely on a shared set of language-specific CSL locale files. Localization data can also be embedded in the styles themselves to override the data stored in these locale files.
+We're no longer accepting translations of the Zotero documentation.
-To learn more about the localization support of CSL, read the sections of the CSL specification on [[http://citationstyles.org/downloads/specification.html#locale-files-basic-structure | locale files]], [[http://citationstyles.org/downloads/specification.html#locale | embedding localization data in styles]], and the [[http://citationstyles.org/downloads/specification.html#the-root-element-cs-style|default-locale attribute]].
+Zotero staff and volunteers spend a lot of time making sure the official English documentation is comprehensive, accurate, up to date, and phrased carefully to avoid common misunderstandings we encounter in the forums, and there's no realistic way for non-English versions to be similarly maintained. Given that both Chrome and Safari now offer built-in machine translation of webpages, and it can be done in Firefox via extensions, we think that that will provide a better way of translating the official documentation for most users.
-To learn how to contribute to the collection of CSL locale files, and to see the status of translation, see the [[https://github.com/citation-style-language/locales/wiki | CSL locale repository wiki]].
+We'd encourage communities that want to maintain documentation in other languages to create more manageable usage guides elsewhere without trying to mirror the full breadth, detail, and up-to-dateness of the official documentation. If you've created a resource in another language that you feel would be useful for Zotero users, let us know in the Zotero Forums and we can add a link from the official documentation.