scratchfoundation/scratch-l10n
1
0
Fork 0
mirror of https://github.com/scratchfoundation/scratch-l10n.git synced 2024-12-22 05:32:34 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions 3
No description
261 commits 26 branches 1325 tags 210 MiB
JavaScript 99.2%
Shell 0.8%
Find a file
Chris Garrity 30b1975e94 Scripts to pull translations and update Freshdesk 
* Fixed a bug in the push script (tags were not saved as correct structured json, so they weren’t getting put into transifex)
* extended FreshDesk API with functions to update knowledge base. Functions automatically try to create the item if it isn’t found for updating
* tx-pull-help-names: pulls category and folder name translations from transifex and updates them in Freshdesk (Note, since we don’t send people into the knowledge base, these aren’t really public, but the actual folders and categories have to exist to be able to save articles)
* tx-pull-help-articles: pull article translations from Transifex and update the Freshdesk KB.
* help-utils: utility functions for the tx-pull-help-* scripts. Handles limiting the number of things happening in parallel - currently two languages may be processed at the same time.
2020-05-06 14:46:09 -04:00
.github Update PR template 2019-12-18 16:54:19 -05:00
.tx New scripts to support www in scratch-l10n 2019-02-12 10:50:43 +01:00
editor pull new editor translations from Transifex 2020-04-28 21:32:32 +00:00
scripts Scripts to pull translations and update Freshdesk 2020-05-06 14:46:09 -04:00
src Add Kurdish to supported languages. 2020-03-24 15:57:43 -04:00
www pull new editor translations from Transifex 2020-05-05 21:32:36 +00:00
.babelrc Add scripts for automation 2018-11-25 18:05:44 -05:00
.eslintignore L10n packaging (#1) 2017-09-21 11:54:41 -04:00
.eslintrc.js Add www resources 2018-03-13 11:46:37 -04:00
.gitignore L10n packaging (#1) 2017-09-21 11:54:41 -04:00
.jshintrc Add www resources 2018-03-13 11:46:37 -04:00
.npmignore Add www resources 2018-03-13 11:46:37 -04:00
.travis.yml Helpers for failing validations 2019-03-21 11:00:12 +01:00
LICENSE Include default Scratch License and TM files 2018-06-19 17:03:04 -04:00
package-lock.json update package.json 2020-05-06 14:46:09 -04:00
package.json update package.json 2020-05-06 14:46:09 -04:00
README.md added notes about .tx/config deprecation 2019-01-22 09:51:45 -05:00
TRADEMARK Include default Scratch License and TM files 2018-06-19 17:03:04 -04:00
webpack.config.js Add scripts for automation 2018-11-25 18:05:44 -05:00

README.md

scratch-l10n

Translation of all Scratch projects is managed on the Transifex service: https://www.transifex.com/llk/public

This repository collects translations submitted to the Scratch projects on Transifex. Please do not submit PRs. If you would like to contribute translations, please sign up to translate on Transifex.

Using scratch-l10n in development

Installation

npm install --save-dev scratch-l10n

Basic Use

import locales, {localeData, isRtl} from 'scratch-l10n';
import editorMessages from 'scratch-l10n/locales/editor-messages';
  • locales: currently supported locales for the Scratch project
  • isRtl: function that returns true if the locale is one that is written right-to-left
  • localeData: locale data for the supported locales, in the format accepted by addLocaleData required by react-intl
  • editorMessages: the actual message strings for all supported locales for a particular resource. editorMessages collects all the strings for the interface, extensions and paint-editor.

Useful Scripts

scratch-l10n provides:

  • build-i18n-src: script that uses babel and plugins to extract all FormattedMessage strings for translation. Combines the message from all the source files into one en.json
  • tx-push-src: script to push the en.json file to Transifex. Requires that the environment variable TX_TOKEN is set with a value that has developer access to the Scratch projects on Transifex (i.e. Scratch Team only)

Versioning

scratch-l10n uses semantic versioning - breaking changes will increment the major version number, and new features (e.g. a new language) will increment the minor version number. However, the patch number is actually a datetime string. That way it's easy to see how recently the translations were updated.

In general, changes that require a PR (new functionality, new language) should increment the minor version. Pulling new translations from Transifex is automated and will commit to master directly.

Deprecations

We are moving away from using the tx cli, so the .tx/config file will eventually be deprecated.