LingoBot Users Guide

From Lingoport Wiki
Revision as of 22:39, 19 December 2018 by Rdaly (talk | contribs) (Critical Errors:)
Jump to: navigation, search

Available Commands Overview

LingoBot allows developers and i18n/l10n managers to make use of Lingoport's product suite without ever having to leave their collaboration environment. With a variety of easy-to-understand commands, users can scan their codebase for potential i18n and l10n issues, gain quick access to the Lingoport dashboard, as well as send resource files for translation and retrieve translation status reports. Here you will find a summary list of the commands which LingoBot will recognize as well as a brief description of each command. Further down you will find in-depth breakdowns of the commands, their use cases, as well as examples of each command in use. If you have any questions that this document doesn't answer, be sure to check out the FAQ page for additional information.

Universal

Duplicate Project:

duplicate project[ --force] <group>.<project>:<branch>

  • If the force flag is included, a new git branch of the same name will also be created.
  • Creates a child project based on the branch name (source cannot be a child project).
  • Shorthand: dup proj, -f

Delete Project:

delete project <group>.<project>:<branch>

  • Deletes the specified child project.
  • Shorthand: del proj

Update Dashboard:

update dashboard <group>.<project>[:<branch>]

  • Updates the dashboard with the latest information from the specified project/branch.
  • Shorthand: up dash

Show Dashboard:

show dashboard[ <group>.<project>[:<branch>]]

  • Displays the URL of the dashboard corresponding to the specified project.
  • Shorthand: show dash

List Projects:

list projects[ <query>]

  • Displays a list of active projects (optionally containing the query )
  • Example: list projects LRM

Ping:

ping

  • Replies with "PONG".
  • A way to test the LingoBot connectivity.

Cleanup:

cleanup

  • Deletes all projects whose branches no longer exist.

Help:

help[ <query>]

  • Displays a list of all available commands, filtered by the query if it is specified.

Status:

status

  • Report the status of any request that is actively awaiting a response.
  • If there are no requests pending a response, the status will be 'Idle'.

LRM Only

Critical Errors:

show errors <group>.<project>[:<branch>]

  • Displays top 10 LRM-critical errors in the specified project/branch.

Pseudo-localize:

pseudoloc <group>.<project>:<branch>

  • Pseudo-localizes the specified project and pushes it to the repository.

Prep Kit (Translate):

prep kit <group>.<project>:<branch>

  • If there are no errors in the specified project/branch, send the project resource files to the translation vendor.
  • Alternative: translate

Translation Status:

translation status [-a] <group>.<project>[:<branch>]

  • Displays a summary of the current status of translations on the specified project/branch.
  • Shorthand: tran stat
  • Optional: Include the all flag (-a) to show all translation status instead of the first 10 locales.
  • Use | to divide locales to show specific language translation status.

Example: translation status <group_name>.<project_name>:<branch>|<locale1>|<locale2>

Notify:

  • Manages the notification dispatch system for translation imports

notify me <group>.<project>[:<branch>]

  • Adds sender (user or room) to recipient list

notify who <group>.<project>[:<branch>]

  • Displays recipient list

notify stop <group>.<project>[:<branch>]

  • Removes sender (user or room) from recipient list

Globalyzer Lite Only

I18n Scan:

i18n scan <group>.<project>:<branch>

  • Scans the differences between the branch and its parent for any internationalization issues and displays a summary of the scan results.

Batch

Create Batch project

add <project> to <batch>

  • Create the <batch> and add <project> to it

Duplicate Project:

duplicate project[ --force] <batch>:<branch>

  • If the force flag is included, a new git branch of the same name will also be created.
  • Creates a child project based on the branch name (source cannot be a child project).
  • Shorthand: dup proj

Delete Project:

delete project <batch>

  • Delete the batch project, but leave the projects that were the components alone and in the list.
  • Shorthand: del proj

Update Dashboard:

update dashboard <batch>

  • Updates the dashboard with the latest information from all projects in the batch.
  • Shorthand: up dash

Show Dashboard:

show dashboard <batch>

  • Displays the URL of the dashboard corresponding all the projects in the batch.
  • Shorthand: show dash

List Projects:

list projects <batch>

  • Displays a list of all the projects in the batch.
  • Shorthand: list proj

Remove project from batch:

remove <project> from <batch>

  • Remove projects from a batch, but leave them in the list of projects.

LRM Only

Critical Errors:

show errors <group>.<project>:<branch1>:<branch2>

show errors <batch>

  • Displays top 10 LRM-critical errors in the specified project/branch.

Pseudo-localize:

  • pseudoloc <group>.<project>:<branch1>:<branch2> or pseudoloc <batch>
  • Pseudo-localizes the specified project.

Prep Kit (Translate):

  • prep kit <group>.<project>:<branch1>:<branch2> or prep kit <batch>
  • If there are no errors in the specified project/branch, sends the project to the translation vendor.
  • Alternative: translate

Translation Status:

  • translation status <group>.<project>:<branch1>:<branch2> or translation status <batch>
  • Displays a summary of the current status of translations on the specified project/branch.
  • Shorthand: tran stat

Globalyzer Lite Only

I18n Scan:

  • i18n scan <group>.<project>:<branch1>:<branch2> or i18n scan <batch>
  • Scans differences between the branch and its parent for any i18n issues and displays a summary of the scan results.