Globalization Pipeline

IBM Globalization Pipeline is a DevOps integrated application translation management service that you can use to rapidly translate and release cloud and mobile applications to your global customers. Access IBM Globalization Pipeline capabilities through its dashboard, RESTful API, or integrate it seamlessly into your application's Delivery Pipeline.

This repository contains common files and information for the IBM Globalization Pipeline service and related tools.

SDKs and Plug-ins

There are a number of SDKs/Plug-ins available for this service. Select one below for more details on how to use it.

• Python: SDK
• Java: SDK | Tools
• Angular: SDK
• Node.js: SDK | Sample
• Cordova: SDK
• Ruby: SDK | Sample
• Urban Code Deploy: Plugin

Quick Start Guide

Below are some steps to help you quickly get started. For more detailed information about the service, please visit the official Globalization Pipeline documentation page.

Lets get started!

1. Create a new Globalization Pipeline service instance

Head to the Bluemix Catalog and look for the Globalization Pipeline service - it should be under the DevOps category.

Once you click the service icon, you should be taken to the Globalization Pipeline service page where you will find more information about the service.

On this page:

1. Provide a name for your service instance
2. Connect to an application (optional)
3. Select a plan
4. Click Create

2. Globalization Pipeline Dashboard

Click on the new service instance to go to the Globalization Pipeline Dashboard.

1. The Getting Started tab provides some general information about the service and some useful links.
2. The Bundles tab allows you to view your bundles and create new bundles.
3. The API Users tab allows you to create new users with different levels of access to the service instance.
4. The Machine Translation Configuration tab can be used to configure additional Machine Translation engines from other providers, such as Watson Language Translation.

3. New Bundle

Lets go ahead and create a new Bundle. Click the New Bundle button and then fill in the new Bundle's information:

1. Give the Bundle a unique name so it can be identified later
2. Provide the Resource file that contains your messages
3. Select the Target languages
4. Click Save

In the example above, messages.json contains:

{
    "greet": "Hello there!",
    "weather": "It is snowing",
    "exit": "Goodbye"
}

Now that the new Bundle is created, select it from the Bundles list to view the Bundle details.

You can now click on one of the Target languages to view the translated messages in that language. For example, Japanese:

You can now download the translated messages by clicking the DOWNLOAD button. Or you can access the translated messages directly in your app by using one of the SDKs or Plug-ins. To get started, head to the SDKs and Plug-ins section.

4. Credentials

In order to access the service instance through the RESTful API, SDKs, or Plug-ins, you will need to provide the necessary credentials. To see the credentials, find the service instance in the Bluemix dashboard and click View Credentials:

Note: If the service instance is connected to an app on Bluemix, the credentials can be accessed from the app's environment variables - the SDKs automatically take care of this.

Caution! The default credentials shown above provide complete access to the service instance, including the ability to delete and modify bundles. When you are using the service in a production app, it is recommended that you create a new Reader account through the API Users tab. The Reader account can only read bundle data.

Beta Migration

If you have Globalization Pipeline BETA service instances previously created and want to migrate them to new service instances, see Globalization Pipeline BETA Migration Guide.

Contributing

See CONTRIBUTING.md

License

Apache 2.0. See LICENSE.txt

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.