Welcome to the Lingoport Sandbox. Use the sandbox to get a feel for Lingoport Globalyzer results on the Lingoport Dashboard.
Viewing example issues
To view i18n issues in current, sample code, visit the Lingoport Dashboard at sandbox.lingoport.com. The left side of the Dashboard shows Globalyzer i18n results. The right side shows Lingoport Resource Manager (LRM) translation status. Feel free to explore the Dashboard and click on anything of interest. If you get lost, click on the green logo in the upper left hand corner. Then click on 'Lingoport.Sandbox'.
On the left hand side (Globalyzer) you can click on the number next to issue types such as 'Concatenations' or 'Embedded Strings'. There you will see examples of these issues. Double-click on the center of the red issue bars to view the actual source code with the specific issue highlighted.
Making your own modifications
Initially the scan results will not appear on the Dashboard but they will be available on GitHub. Here is an example. Once your changes are accepted by a Lingoport Administrator, they will appear on the Dashboard.
To make your own changes, follow the instructions below. Lingoport recommends testing with up to two hundred lines of code in the Sandbox. If you add your own code, please use UI or other user facing elements, since that is where most internationalization issues are located.
Instructions for making modifications
In order to make changes the the sandbox, you will need a GitHub account. If you do not have a GitHub account, you may also contact Lingoport via this form on our web page. Or email firstname.lastname@example.org. We will create a GitHub account for you.
In this Sandbox:
- New issues will be displayed on any pull requests that you make.
- As pull requests are merged, the issues will be included in the Lingoport Dashboard.
- Add or modify resource bundles.
- Use filename_en_US.(json/properties/resx) for the base files.
- Watch as updates to en_US files are automatically added to fr_FR, de_DE, ja_JP, and zh_CN resource files, then sent for translation.
- So for example: Update messages_en_US.properties and watch as other message_ files, such as messages_ja_JP.properties, are updated. Or errors_en_US.resx and errors_de_DE.resx, etc.
- Translation updates will occur every 8 hours.
Fork this repository on GitHub
Login to GitHub, or create an account if you do not yet have one.
Once logged in, visit this page (https://github.com/sandboxLingoport/sandbox).
Then click on the 'Fork' button on the top right. This will create a version of the Sandbox code for you to modify.
You may make changes to the code directly through the GitHub web interface, or download the code to your computer and make changes there.
Make changes through the web interface
You can add code for Lingoport Suite analysis on GitHub's website. This is the simplest way.
- Open the repository that you cloned.
- Select the 'working' branch. You may either make changes within this branch, or fork a new branch from it. If you're not sure, just use the 'working' branch.
- Browse to and open one of the existing files.
- Look for a pencil-like icon at the top right of the file. This is the 'edit this file' icon. Click on it.
- You may now make changes to the file.
- Once you are done, scroll down to where the page says 'Commit changes'.
- In the 'Commit changes' section, add a comment describing your change.
- Click 'Commit changes'.
Clone the repository locally to make your changes
If you prefer, you may also download the code to your computer.
- Clone the repository.
- $ git clone https://github.com/\<your github username>/sandbox.git
- Checkout the working branch.
- $ git checkout working
- Commit and push you changes.
- $ git add <changed files here>
- $ git commit
- $ git push origin working
Create a pull request
- Look for the 'New pull request' button on GitHub at the home of the project you forked.
- After clicking 'New pull request', you'll have the option to select the branch and fork to merge.
- base fork: Select sandboxLingoport/sandbox
- head fork: Select <your GitHub username>/sandbox
- base: Select 'working'
- compare: Select the branch you have made changes to.
- Click 'Create pull request' once it appears.
- Type in a title and description for the pull request.
- Click the 'Create pull request' button again.
Within a couple of minutes, any detected i18n issues will be noted in the pull request by Lingoport automation.
After Lingoport approves the pull request, the Lingoport Sandbox Dashboard will update to include a scan of your changes.
Updates you make to English resource files will be automatically translated within 8 hours. You can see the translation status in the dashboard here.
Contact lingoport support at email@example.com
The 'working' branch will be reset every two weeks.
For more information, view the following sandbox videos.