InContext Installation

From Lingoport Wiki
Revision as of 19:30, 10 June 2019 by Rdaly (talk | contribs) (Translate all resource files)
Jump to: navigation, search

InContext QA Installation and Verification

This section identifies the tasks to get the InContext QA configured and verified. These are items, most likely, performed by a system administrator or linguistic developer. A linquistic QA, or reviewer, would not need this section for installation and should continue to the next part.

Translate all resource files

First, create a Jenkins automation job for your application and it's resources.

FullyTranslatedDashboard.jpg

Make sure the resources are fully translated.

In Jenkins, select the automation job, scroll down and select Add build step at the bottom of the Build section. Select IQA Instrument.

Configure the Jenkins job for instrumentation

Deploy the web app

Test the system

Installation for Reviewers or Linguistic QA

Pre-Requisites

In order to use Lingoport InContext QA, the user must have access to the Google Chrome browser. Lingoport InContext QA is based off a Chrome extension and other browsers do not have the same capability. Firefox or Internet Explorer can not be used as the browser in this situation.

  • LRM must be installed and
  • the G11n Continuous System's Jenkins server must be accessible from the reviewer's system.

The reviewer needs to have the following information which should be set up by the Jenkins administrator:

  • The Jenkins URL
  • A Jenkins username and password.
  • To get the API token and verify the Jenkins account:
    • Log in to Jenkins using the reviewer username and password.
    • Select the pull down next to username at the top of the window and select Configure.
      • Under API Token, Show API Token.... Copy the token.

In addition, the reviewer will need:

  • Their email address

Chrome Extension Installation

From within the Google Chrome Browser:

UserSignin.png
  • click on Add to Chrome Extension

You should see the Lingoport swirl Swirl.png at the top of the Chrome browser window.

Chrome Extension Configuration

  • Before configuring the Chrome InContext extension, a username needs to be created in Jenkins.
  • Click on the Lingoport swirl Swirl.png for the Chrome Extension (top right corner of your Chrome)
  • Click on the 'Option' icon (☰) of the dialog.
  • Fill in the data, using the username and API token and Save Credentials
 Incontext credentials.png

You should be ready to do InContext reviews.

Loading Local Files in Google Chrome

Due to security reasons Chrome will not load local files by default. You'll need to launch the Google Chrome browser from the command line window with the additional argument –allow-file-access-from-files as well as allowing local files access within the Chrome Extension.

  • Determine where chrome.exe is located on your machine by entering chrome://version into your Chrome Browser and search for Executable Path.
  • Launch the Google Chrome browser from the command line window with the additional argument –allow-file-access-from-files.
>"path to your chrome installation\chrome.exe" --allow-file-access-from-files
  • Within the Chrome Browser right-click on the Lingoport Incontext QA Chrome Extension and choose Manage Extensions

ManageExtensions.png

  • Move the Allow access to file URLs switch to the right.

UserAllowAccess.png

Using Multiple Displays with Google Chrome

In order for multiple high resolution displays to work properly with Google Chrome you'll need to launch the Google Chrome browser from the command line with additional arguments. You may want to create/change the Chrome shortcut to include the options rather than opening from a command line each time.

  • Determine where chrome.exe is located on your machine by entering chrome://version into your Chrome Browser and search for Executable Path.
  • Launch the Google Chrome browser from the command line window with additional scaling directives /high-dpi-support=1 /force-device-scale-factor=1.
>"path to your chrome installation\chrome.exe" /high-dpi-support=1 /force-device-scale-factor=1
Note: arguments are single spaced. If you need to load local files then add –allow-file-access-from-files to the argument list.