You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 7-8.RSVP
Socket
Socket
Sign inDemoInstall

grunt-onesky-import

Package Overview
Dependencies
4
Maintainers
1
Versions
11
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

grunt-onesky-import

Import translation files into your OneSky project


Version published
Maintainers
1
Created

Readme

Source

grunt-onesky-import

Import a single or multiple translation files into your OneSky project

Getting Started

This plugin requires Grunt ~0.4.5

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-onesky-import --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-onesky-import');

The "oneskyImport" task

Overview

In your project's Gruntfile, add a section named oneskyImport to the data object passed into grunt.initConfig().

IMPORTANT:

  • Your translation file should include translation strings in the base language set up in your OneSky project.
  • After a successful upload, translations strings may not be immediately available in your project as they are automatically queued to be imported. This process can take a few seconds/minutes dependent on server load.

Options

options.authFile

Type: String Default value: onesky.json

A JSON file with your OneSky API keys.

{
    "publicKey": "YOUR_PUBLIC_KEY",
    "secretKey": "YOUR_SECRET_KEY"
}
options.projectId

Type: String

Your OneSky project ID

options.file

Type: String

The path to the translation file to be upload to your OneSky project.

NOTE: In each task definition, use either the files OR file property, not both.

options.files

Type: String OR array of strings/globbing patterns

'src/locales/**/*.json'

OR

[
    'src/locales/**/*.json',
    '!src/translations/**/*.json',
    ...
]

NOTE: In each task definition, use either the files OR file property, not both.

options.locale

Type: String Default value: Your project main language

The language (and region if specified) of your file. For example, you will use en-GB if you want to upload a file in english especially for Great Britain.

options.fileFormat

Type: String

The file format for OneSky to assume when importing translations. See list of available file formats.

options.isKeepingAllStrings (optional)

Type: String Default value: true

When uploading a file which overwrites an existing file in your OneSky project, set this value to false to deprecate strings that cannot be found in the existing file. Files with different file names will not be overwritten or deprecate previous strings.

Usage Examples

Upload a single file in one task:

grunt.initConfig({
    oneskyImport: {
        options: {
            authFile: 'onesky.json',
            projectId: '12345',
            isKeepingAllStrings: false
        },
        import: {
            options: {
                locale: 'en-GB',
                file: 'media.json',
                fileFormat: 'HIERARCHICAL_JSON'
            }
        }
    },
});

Upload multiple files in one task:

grunt.initConfig({
    options: {
        authFile: 'onesky.json',
        projectId: '12345',
        isKeepingAllStrings: false
    },
    import: {
        options: {
            // Globbing pattern string
            files: 'src/locales/**/*.json'
        }
    }
});

OR

grunt.initConfig({
    options: {
        authFile: 'onesky.json',
        projectId: '12345',
        isKeepingAllStrings: false
    },
    import: {
        options: {
            files: [
                // Array of globbing patterns or array of file paths
                'src/locales/**/*.json',
                '!src/translations/**/*.json'
            }
        }
    }
});

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style via eslint. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Keywords

FAQs

Package last updated on 09 Feb 2017

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc