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.