Need help with i18n?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

electron
466 Stars 250 Forks Other 29.5K Commits 14 Opened issues

Description

🌍 The home of Electron's translated documentation

Services available

!
?

Need anything else?

Contributors list

electron-i18n

Dependabot badge

A home for Electron's translated documentation.

🇵🇭 🇨🇳 🇹🇼 🇧🇷 🇪🇸 🇮🇱 🇰🇷 🇯🇵 🇷🇺 🇫🇷 🇹🇭 🇳🇱 🇹🇷 🇮🇩 🇺🇦 🇨🇿 🇮🇹 🇵🇱

Contributing

Do you speak multiple languages? We need your help!

To get started translating, visit crowdin.com/project/electron and log in with your GitHub account.

The following languages are currently being translated, but we can easily add more:

Installation

If you're just here to translate content, see above. ☝️

If you're here to actually use this translated content for some purpose, read on! This project is published to npm as a module containing all the translated docs.

npm install electron-i18n

Usage

The

electron-i18n
module has no dependencies and exports no functions. It is simply a large JSON object containing all of Electron's API docs and tutorial content, in every language.

Require the module in your code:

const i18n = require('electron-i18n')

i18n
is an object with the following keys:
  • electronLatestStableVersion
    is a string like
    1.7.8
  • electronLatestStableTag
    is a string like
    v1.7.8
  • electronMasterBranchCommit
    is a git commit SHA string.
  • docs
    - see #docs
  • locales
    - see #locales
  • website
    - see #website
  • date
    is a timestamp

Docs

i18n.docs
is an object with locale strings as keys:
Object.keys(i18n.docs)
[ 'en-US', 'fr-FR', 'vi-VN', 'ja-JP', 'zh-CN', '...']

Each locale object contains an object with doc HREFs as keys:

> Object.keys(i18n.docs['en-US'])

[ '/docs/tutorial/about', '/docs/api/accelerator', '/docs/tutorial/accessibility', '/docs/api/app', '...' ]

Each doc object contains metadata and an HTML version of itself, ready to be rendered:

i18n.docs['en-US']['/docs/api/app']

{ locale: 'en-US', slug: 'app', category: 'api', categoryFancy: 'API', href: '/docs/api/app', title: 'app', description: '\nControl your application's event lifecycle.\n' githubUrl: 'https://github.com/electron/electron/tree/master/docs/api/app.md', crowdinFileId: '123', isTutorial: false, isApiDoc: true, isDevTutorial: false, isApiStructureDoc: false, markdown: '...', html: '...' }

Locales

i18n.locales
is an object with locale strings as keys:
Object.keys(i18n.locales)
[ 'en-US', 'fr-FR', 'vi-VN', 'ja-JP', 'zh-CN', '...']

Each locale object contains language names, country info, and translation progress:

i18n.locales['en-US']

{ locale: 'en-US', languageCode: 'en', languageName: 'English', languageNativeName: 'English', countryCode: 'US', countryName: 'United States', stats: { translated_progress: 100, approved_progress: 100 } }

Website

i18n.website
contains localized versions of electron/electronjs.org/blob/master/data/locale.yml.

It is an object with locale strings as keys:

Object.keys(i18n.locales)
[ 'en-US', 'fr-FR', 'vi-VN', 'ja-JP', 'zh-CN', '...']
i18n.website['fr-FR']

{ tagline: 'Développez des applications desktop multi-plateformes avec JavaScript, HTML et CSS', nav: '...' }

License

MIT

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.