USER GUIDEMADCAP LINGO 10.2

Getting Started

Copyright 2018 MadCap Software. All rights reserved.
Information in this document is subject to change without notice. The software described in this document is furnished under a license agreement or nondisclosure agreement. The software may be used or copied only in accordance with the terms of those agreements. No part of this publication may be reproduced, stored in a retrieval system,or transmitted in any form or any means electronic or mechanical, including photocopying and recording for any purpose other than the purchaser's personal use without the written permission of MadCap Software.
MadCap Software
7777 Fay Avenue
La Jolla, California 92037
858-320-0387
www.madcapsoftware.com

THIS PDF WAS CREATED US ING M ADCAP FL ARE.

CONTENTS

CHAPTER 1
Introduction

5File Types You Can Translate

6

Major Benefits

9

CAT Tool—Translators

10

Translation Workflow Management—Content Developers 12
Additional Help

14

CHAPTER 2
Starting a Lingo Project

15

Creating New Projects

16

Opening Projects

22

Updating Projects

23

Adding Files to Projects

25

CHAPTER 3
Viewing Files Requiring Translation

26

CHAPTER 4
Translating Files

CONTENTS

29

iii

CHAPTER 5
Exporting Translated Projects

31

CHAPTER 6
Other Lingo Features

34

Translation Memory

35

Machine Translation

35

Termbases

35

Concordance

36

Segmentation Rules and Split/Join

36

Statistics Reports

36

Quality Assurance Reports

37

Reviews

37

Dictionaries

37

Source Control

38

Command Line Exports and Updates

38

APPENDIX
PDFs

CONTENTS

39

iv

CHAPTER 1

Introduction
Welcome to MadCap Lingo—the first native XML, fully integrated computer-aided translation (CAT)tool and workflow management solution. Translators can use Lingo to translate documents, or you
can use Lingo as a management tool while a translator uses a third-party CAT tool.
This chapter discusses the following:

CHAPTER 1

File Types You Can Translate

6

Major Benefits

9

CAT Tool—Translators

10

Translation Workflow Management—Content Developers

12Additional Help

145

File Types You Can Translate
Lingo is a desktop solution that you can use to open and translate the following:nAdobe Adobe FrameMaker files (FM, MIF, and BOOK)nAdobe InDesign files (IDML)n

DITA files (DITA, DITAMAP, XML)nDoc-To-Help projects (D2H)n

HTM and HTML documentsn

MadCap Capture image files (BMP, GIF, HDP, JPG, JPEG, PNG, TIF, TIFF, WDP)
NOTE: PDF image files cannot be translated.

n

MadCap Contributor files (MCDOC)n

MadCap Flare language skins (FLLNG)
NOTE: When translating language skin segments, the interface element value isadded to the segment as a segment note for your reference.

n

MadCap Flare package files (FLPRJZIP)nMadCap Flare projects (FLPRJ)

CHAPTER 1

6

n

MadCap Flare target files (FLTAR)
NOTE: You can translate metadata tags in PDF and EPUB targets. The metadata
type is added to the segment as a segment note for your reference.

n

MadCap Lingo bundles (ZIP)n

MadCap Mimic movies and collections (MIMOV, MIPRJ)n

Microsoft .NET Resource files (RESX)n

Microsoft Excel documents (XLS, XLSX)nMicrosoft PowerPoint documents (PPT, PPTX)nMicrosoft Word documents (DOC, DOCX)CHAPTER 1

7

nProperties files (.properties)
NOTE: When translating .properties files, only the value is translatable. The entire
value pair is added to the segment as a segment note for your reference.

nRich text files (RTF)n

SDL Trados newer files (SDLXLIFF)n

SDL Trados older files (TTX)n

SQL files
NOTE: When translating SQL files, only the expression is translatable.

n

TXT filesnWordfast files (TXML)n

XLIFF 1.2 files (XLF)n

XML files

CHAPTER 1

8

Major Benefits
Major benefits of MadCap Lingo include the following:n

Choice between using Lingo in one of the following ways:l

CAT tool (for translators)
ORlTranslation workflow management solution (for content developers who need to get theirfiles into the hands of a translator)nEasy-to-use interfacen32- and 64-bit supportnSupport for multilingual projectsnComplete Unicode support for left-to-right (LTR) as well as right-to-left (RTL) languagesnFile List window pane, which takes the guessing out of which files need to be translated, andwhich do notnMachine translation to provide translation suggestions from popular Internet translation servicesn

A concordance to perform advanced searches in source and target segments, and to searchmachine-translated suggestionsnStatistics that let you see how much work has been completed and how much still needs tobe donen

Quality assurance reports to find discrepancies between source and target segmentsnAbility to leverage previous translation work by importing and exporting Translation Memory
eXchange (TMX) files, Termbase eXchange (TBX) files, and Segmentation Rules eXchange(SRX) filesnEasy review workflow using MadCap ContributornNo need for out-of-project file transfers, which helps avoid content and formatting corruption
problems that are common with traditional localization workflows

CHAPTER 1

9

CAT Tool—Translators
Following are the basic steps that localization experts would follow for translating a project or standalone files in Lingo. If instead you are content developer and your translator needs to use a thirdparty CAT tool to perform the translations, see the steps listed after these.
1. Start Projects You can create a new Lingo project or open an existing one. See "Starting a
Lingo Project" on page 15.
2. (Optional) Create/Import Translation Memory You can create a translation memory (TM)database for the project so that you can reuse previous translations. Creating a TM databasecan be done when you go through the process for creating a Lingo project, or it can be done
separately. You can also import a Translation Memory eXchange (TMX) file into a TM database in case you have previous translation work that you want to use in the new TM. For more
information see the online Help or the Lingo Translation Guide.
3. Open List of Files to be Translated You can quickly open a list of all files in the project thatneed to be translated. For source files such as Flare projects—which contain many uniquetypes of files—this helps take the guessing out of localization work. All files requiring translation are displayed in the File List window pane. See "Viewing Files Requiring Translation" onpage 26.
4. Open and Translate Files There are several types of files that you can open and translate.
Lingo's Translation Editor allows you to work in Translation (or grid) mode, with the source content in one column and the target language in the next column. For some types of files—suchas Flare topics, snippets, and master pages; Microsoft Excel, PowerPoint, and Word documents; DITA files; HTML files; and XML files—you can also switch to Live Preview mode,
which allows you to view content in its intended context. A suggestions area at the bottom of
the Translation Editor lets you quickly select and insert matching translations from your translation memory (TM) database. See "Translating Files" on page 29.
5. (Optional) Use Machine Translation In addition to using previous translations from a translation memory, you can also use machine translation to generate suggestions from a translation service like Google Translate, Microsoft Bing Translator, or MyMemory Translated.net.
You can use these suggestions to fill in gaps when pre-translating a project and you do nothave a previous translation available. You can also use the machine translations to provide
suggestions for an entire project, and then select translations that are appropriate and addthem to your existing TM. For more information see the online Help or the Lingo Translation
Guide.

CHAPTER 1

106. (Optional) Run QA Reports Lingo offers several quality assurance (QA) reports to help you spot
discrepancies in a translated project. These reports can be useful because they can help finderrors that you might not have otherwise noticed, such as formatting inaccuracies, repeatedsegments, or termbase errors. By running a QA report, you can locate errors and correct themearly in the translation process, preventing unnecessary rework later. You may want to run
these reports before returning the project to the content developer. For more information see
the online Help.
7. Export Translated Projects When all of the content in a project or file is translated, you canexport the work to the application, file, or location. For example, if a Flare project was translated, you can export your work out to a new Flare project; if a Word document was translated,
you can export your work out to a new Word document. This translated project or file can thenbe opened, and output can be created from it. See "Exporting Translated Projects" on page
31.
NOTE: If you have translated files for a Flare project, you also have the option of placing your Lingo project where the Flare author can access it. The author can then link
directly to the Lingo project. This way, you do not need to export the Lingo projectback out to a new Flare project. However, in order to use this process, the author
must also have Lingo 10 installed on his computer in order to correctly build the multilingual output.

CHAPTER 1

11

Translation Workflow Management—
Content Developers
Following are the basic steps that content developers would follow for using Lingo as a bridge
between their source files and a third-party CAT tool used by the translator. If instead you are atranslator and will be using Lingo to perform the translation work, see the steps listed before these.
1. Create Lingo Project (Author) The author creates a Lingo project based on the project or files
that require translation. See "Creating New Projects" on page 16.
2. (Optional) Create/Import Translation Memory (Author) You can create a new translation
memory (TM) database for the project and import a Translation Memory eXchange (TMX) filefrom the translator. Your translator's quote should take into account previous translations
from the TMX file (which makes translation work less expensive than translating brand new
segments). You can view statistics (Step 6 below) on the project to see how many translations from the TMX file match segments in your source documents. For more information
see the online Help or the Lingo Translation Guide.
3. Prepare and Send Bundle (Author) In Lingo, the author bundles the necessary files in the project. You can bundle all files or only selected files. To do this, open the File List window pane,select the appropriate files, and click the Prepare Translation Bundle button. Then send
the bundle—which is either a ZIP file (if the translator will be using a third-party tool) or an
LIPRJZIP file (if the translator will be using Lingo). This bundle file consists of the content files
requiring translation, and can also consist of translation memory databases or termbases. For
more information see the online Help.
4. Translate Content, Send ZIP or LIPRJZIP File (Translator) Using a third-party tool or Lingo, thetranslator performs the translation work, puts the completed files into a ZIP or LIPRJZIP file,and sends it back to the author. For more information see the online Help.
NOTE: Translators must return a bundle in the same file format as the original bundle
they received. If you sent the translator a Lingo project file (*.LIPRJZIP), you should
receive an LIPRJZIP file back from the translator. Likewise, if you sent the translatora ZIP file, should receive a ZIP file back.
5. Merge Completed Bundle (Author) The author reintegrates the translator's work with the
Lingo project (by clicking the Merge Completed Bundle buttonpane). For more information see the online Help.

CHAPTER 1

in the File List window

126. Ensure Completeness (Author) There are a few ways that the author can ensure completeness of the translations. For more information see the online Help.
nStatistics You can select File > Compute Statistics. This displays a statistics reportshowing detailed information for the project and each file. Using this report, the content
developer can see exactly how many words and segments were translated.

n

Reports In addition to running a statistics report, you can also run quality assurance(QA) reports to find any discrepancies between the source and target segments in yourproject. To do this, you can select File > Project QA, then select the type of QA reportyou want to run. Using these reports, the content developer can find errors the translator may have missed, such as formatting or punctuation inaccuracies, misuse of thetermbase, or repeated segments.

n

Status The File List window pane lists each content file and various information for
each. One of the columns in this window pane is named "Status." This column displays
the translation status of each file (e.g., Untranslated, In Progress, Completed,
Reviewed, Approved). The translation status can be set manually, or when certain
actions are performed, the status is set automatically. After a translator returns abundle and you merge it back into a Lingo project, the status of each file is updated,depending on the situation. If the translator only partially translates a file, the statuschanges to "In Progress." If the translator finishes translating all segments in a file, thestatus changes to "Completed." If the translator returns the file untouched, the status
remains "Untranslated."n

Review You can export translated content to a MadCap Contributor review archive file
(LIREV) and send it to a third party for review.

7. Export Translated Projects (Author) After ensuring that everything is completely translated,
the author exports the Lingo project to the necessary file(s) (e.g., a new Flare project, a new
Word document). See "Exporting Translated Projects" on page 31.

CHAPTER 1

13

Additional Help
You can use any of the following resources for additional help not provided in this manual.

Knowledge Base
You can browse the online Knowledge Base for articles covering common support issues.
http://kb.madcapsoftware.com/

Peer-to-Peer Online Forums
You can visit the online forums to learn from other users or share your own expertise.
http://forums.madcapsoftware.com/

Contact Lingo Support
You can contact the Lingo support team and get answers to your specific support issues.
http://madcapsoftware.com/support/

CHAPTER 1

14

CHAPTER 2Starting a Lingo Project
The first step in translating a project after you launch Lingo is to start a project. You can create a
new project or open an existing one. In addition, you can update previous projects or add files to projects you are working on.
This chapter discusses the following:

CHAPTER 2

Creating New Projects

16

Opening Projects

22

Updating Projects

23

Adding Files to Projects

25

15

Creating New Projects
You can create a new Lingo translation project using the Start New Project Wizard. This wizard lets
you select from many different kinds of files (e.g., MadCap Flare projects, Doc-To-Help projects,
Microsoft Word documents, Adobe Framemaker, Adobe InDesign, XML files, DITA files), as well as
specify one or more target languages. You can also add entire folders to a project and then selectthe file types you want to translate.

HOW TO CREATE A NEW PROJECT
1. Do one of the following, depending on the part of the user interface you are using:n

Ribbon Select File > New Project.

n

Keyboard Shortcut Press CTRL+SHIFT+N.

The Start New Project Wizard opens.
2. In the Name field, type an appropriate name for your project.
EXAMPLEIf you have an English version of a Flare project called "FictionSoftPro," and you
intend to translate the project into German, you might name your Lingo projectsomething like "FictionSoftPro German."
Or maybe you are translating that project into many languages. Therefore, you
might name the project "FictionSoftPro Translated."
3. By default, a path to the Documents\My Translated Projects folder on your hard drive isentered in the Folder field. (Lingo creates the My Translated Projects folder when you install
the program.) All subfolders and files related to the translated project will be placed in thisfolder as you work on the project.
NOTE: Depending on your operating system, the folder may be called "My Documents" instead of "Documents."

CHAPTER 2

16

4. (Optional) In the Domain field, you can type a subject category for your project, or select one
from the drop-down. If you enter your own custom category in the Domain field, it will appear
in the drop-down the next time you create a new project. Domain metadata appears throughout the project, such as when you select a suggestion in the translation memory.
EXAMPLEIf you have a project called "FictionSoftPro," and it is for a company that writes
software for publishing companies, you might choose to categorize your projectusing the domain "Art/Literary" or "Tech/Engineering."

CHAPTER 2

17

Alternatively, you could also create a new domain called "Fiction" by typing Fiction in the Domain field. The next time you want to use that domain, you canselect it from the drop-down.

CHAPTER 2

18

5. (Optional) In the Client field, you can type the name of the client you are creating a translation
project for. When you enter a client name in the field, it will appear in the Client drop-down thenext time you create a new project. Client metadata appears throughout the project, such as
when you select a suggestion in the translation memory.
EXAMPLEIf you are creating a translation project for FictionSoft, the company that makes"FictionSoftPro," enter FictionSoft in the Client field. The next time you create atranslation project for FictionSoft, you can select their client name from the Client drop-down.

6. In the Source Language drop-down, select the original language that is used in the project
you are translating. Make sure this language matches the source exactly. For example, you
might select English (en) here, but the source files are actually in the English United States(en-us) language. Therefore, you should instead select English (United States) in this field.

CHAPTER 2

19

7. In the Target Languages grid, select the language(s) that you want to use for the translationand clickto move it to the Selected Languages grid. If you need to remove a language

from the Selected Languages grid, click.

EXAMPLEIf your project needs to be translated into French, Italian, and Spanish, selectthese three languages from the Target Languages grid, then click.

8. (Optional) If you want to bind the Lingo project to a source control provider, select Bind tosource control.
9. Click Next.
10. (Optional) If you have selected the "Bind to Source Control" option, click Bind Project. Then in
the Bind Project dialog, complete the fields, depending on the source control application being
used. When you are finished, click Next. For more information about binding to source control,
see the online Help.

CHAPTER 2

20

11. Click Add File or Add Folder to bring files or folders, respectively, into the new project. Alternatively, click Add From Source Control to add files or folders to a project from source control.
If you select a folder, the files within it are added. For more information about adding files andfolders to a project, see the online Help.
12. Click Next.
13. (Optional) If you are creating a project using MadCap Flare or DITA source files, select additional project settings. For more information about Flare and DITA project settings, see theonline Help.
14. Click Next.
15. (Optional) Available translation memory (TM) databases are listed in a grid, and you canselect the ones you want to use for the current project by clicking the Use check box next tothem. You can also add, create, or import TMs from this page of the wizard. For more information about the TM tasks that you can perform while creating a project, see the online Help.
16. Click Next.
17. (Optional) Available termbases are listed in a grid, and you can select the ones you want touse for the current project by clicking the Use check box next to them. You can also add, create, or import termbases from this page of the wizard. For more information about the termbase tasks that you can perform while creating a project, see the online Help.
18. Click Finish.
When you create a new Lingo project, a file with an .liprj extension is automatically generated (e.g.,
My Project Italian.liprj). This is the main file for the project and is stored at the root level of the project folder in Windows (e.g., Documents\My Translated Projects\My Project Italian\My Project Italian.liprj). You can open the project by double-clicking this file.

CHAPTER 2

21

Opening Projects
There are multiple ways to open an existing project. You can use interface options or drag files from
Windows Explorer.

HOW TO OPEN A PROJECT USING INTERFACE OPTIONS
Do one of the following, depending on the part of the user interface you are using:nStart Page On the left side of the Start Page, click Open. You can also click a recently opened
project. If you do not see the Start Page, select View > Start Page.

n

Ribbon Select File > Open. The Open dialog displays. The Lingo project file extension (.liprj)
appears in the File Type field. In the Open dialog navigate to the project you want, select it,
and click Open.

n

Keyboard Shortcut Press CTRL+O. The Open dialog displays. The Lingo project file extension(.liprj) appears in the File Type field. In the Open dialog navigate to the project you want,select it, and click Open.

HOW TO OPEN A PROJECT BY DRAGGING A FILE FROM WINDOWS EXPLORER
1. Open Windows and navigate to a folder containing a project file.
2. Launch Lingo.
3. Drag the project file from Windows to the application window and drop it on the title bar in
Lingo.

CHAPTER 2

22

Updating Projects
Let's say you have already created a Lingo project for an earlier version of a particular project or document. You have already translated it, exported it to a new project or file, and given it to the author.
Sometime after this, the author makes many changes to the project or file (in the source language).
Now the author needs you to translate those changes into the target language. To do this, you can
update your Lingo project.

HOW TO UPDATE A PROJECT
1. Open the Lingo project.
2. Select File > Update Project.
3. In the dialog that opens, navigate to the updated project or file that you want to translate, anddouble-click the appropriate file. A processing dialog temporarily displays as the changed files
are integrated into the Lingo project. This dialog closes automatically when it is finished.
4. (Optional) If you want to update the localized images in your Lingo project with the images
from the source project, select Replace localized images for this project. Click OK.
NOTE: You may want to replace the localized images if the images in the source project have changed considerably. Localized images will only be replaced if the source
image is newer (i.e., more recently updated) than the localized image; localized
images that have not changed in the source project will not be replaced.

NOTE: You will only be prompted to replace images if there are images in your Lingo
project.

NOTE: If the changed source file has segments that exactly match those in TM, the segments automatically receive those translations. If there are changes where matches do notoccur in TM, those changes are reflected in the Lingo project in a couple of ways. First, theDifference column in the File List window pane indicates whether a file has changed. Also, if
you switch to Preview mode in the Translation Editor (for files such as Word documents,
PowerPoint files, and Flare topics, which can be displayed in that mode), icons are displayednext to segments that have been changed.

CHAPTER 2

23

NOTE: When you use this feature, Lingo only scans files that have been changed, instead of
all files in the project. This results in quicker updates.

NOTE: Update Project is disabled if you created a project in either of the following ways:
1. From individual folders and individual files
2. From individual folders, and later you added additional files using the Add Project Files
Wizard

NOTE: If you make changes to a project's filtering or flattening settings in the Project Properties dialog, you do not need to update the project to apply these settings. Instead, thechanges are applied dynamically.

NOTE: If you translate a segment in Lingo and then update the source for that segment,
the source content may no longer match the translation provided by the TM or machinetranslation. If this happens, the TM Source column displays "Xliff Alternate," to indicate thata previous translation is stored in the XLIFF file.

CHAPTER 2

24

Adding Files to Projects
In many cases, you can add additional files to a project after the project has been created. This
allows you to make changes to your Lingo project at any time without needing to create a new project. It also prevents you from having to send multiple projects to a translator or a reviewer.
You can add files to any project created from other individual files, such as Word documents or
XML files. You can also add files to any project created from folders.

HOW TO ADD PROJECT FILES
1. In the local toolbar of the File List window pane, click. The Add Project Files Wizard opens.

2. Click Add.
3. In the dialog that opens, select the file(s) you want to add to the Lingo project. Click Open.
4. (Optional) If you need to remove a file, select it in the wizard and click Remove.
5. (Optional) If you are adding Word, XML, or text files to your project, you can create a file typefilter to import only certain parts of the file. For more information see the online Help.
6. When you are done adding files, click Finish. The files are added to the project.

NOTE: If you are translating a Flare project file, Mimic project file, Doc-To-Help project file,or a DITA map, you cannot add individual files to the Lingo project after it has been created.

NOTE: Update Project is disabled if you created a project in either of the following ways:
1. From individual folders and individual files
2. From individual folders, and later you added additional files using the Add Project Files
WizardCHAPTER 2

25

CHAPTER 3

Viewing Files Requiring
Translation
You can quickly open a list of all files in the project that need to be translated. For source files suchas Flare projects—which contain many unique types of files—this helps take the guessing out of localization work. All files requiring translation are displayed in the File List window pane.
A filter feature in the File List window pane allows you to list files by type (e.g., topics, snippets,
images, master pages, movies) when you are using the grid view. The All Files filter option shows allof the translatable files in your project.

CHAPTER 3

26

HOW TO VIEW FILES REQUIRING TRANSLATION
1. By default, the File List window pane opens automatically on the left side of the interface
when you first launch Lingo. If it is not open, do one of the following, depending on the part ofthe interface you are using:n

Ribbon Select the View ribbon. In the Pane section select File List.

n

Keyboard Shortcut Press CTRL+R.

2. (Optional) By default files are displayed in a grid. If instead you want to view them in a folder
structure, click
to grid view.

in the local toolbar. Clicking this button a second time switches you back3. (Optional—if using the grid view) Next to the Filter field at the top of the window pane, you canclick the down arrow and select one of the options to limit the file types shown (e.g., snippets). If you are new to Lingo, you may want to select "All Files" to view all of the translatable
files in your project.

4. To open a file for translation, simply double-click it in the list.

CHAPTER 3

27

NOTE: If you are working with a multilingual project, you can change the active target language in the Project Properties dialog (File > Project Properties). This will change the language of the files shown in the File List window pane.
The translation status displayed in the File List is shown for the active target language (forexample, a file might be translated in Spanish, untranslated in French, and already sent forreview in German).

CHAPTER 3

28

CHAPTER 4

Translating Files
Lingo's Translation Editor allows you to work in Translation (or grid) mode, with the source content
in one column and the target language in the next column. For some types of files—such as Flare
topics, snippets, and master pages; Microsoft Excel, PowerPoint, and Word documents; DITA files;
HTML files; and XML files—you can also switch to Live Preview mode, which allows you to view content in its intended context. A suggestions area at the bottom of the Translation Editor lets you
quickly select and insert matching translations from your translation memory (TM) database.
Although you do not need to use TM when translating files, it is recommended that you do so. Therefore, before following the steps below, make sure you have performed the necessary setup tasks for
TM. For more information see the online Help or the Lingo Translation Guide.

CHAPTER 4

29

HOW TO TRANSLATE FILES
1. (Optional) Before you start translating text, you may want to select Home > Translate projectwith TM. This scans your translation memory to find 100% matches for untranslated segments and applies those translations accordingly.
2. From the File List window pane, open the file you want to translate.
The file segments are shown in the Translation Editor. The source text is shown in the left
column. The right column, which is initially empty by default, is where you enter the translation.
3. Click in a target cell (the right column) of a segment row. The cell may remain empty until you
type in it, or the cell may become immediately filled with a perfectly matching translationfrom TM.
4. Do one of the following:nType your translation.
ORn

If the TM Suggestions tab below shows a match for the segment that you want to use,
double-click it. The target cell becomes filled with that translation. You can keep thetranslation as it is, or you can click in the cell and adjust it.

5. Do one of the following, depending on the part of the user interface you are using:n

Ribbon Select the Home ribbon. In the Translation section select one of the Confirm buttons.

n

Keyboard Shortcut Press Enter.
OR
Press CTRL+SHIFT+Down Arrow or CTRL+SHIFT+Up Arrow on your keyboard (to moveto the next or previous untranslated segment, respectively).

nRight-Click Right-click in the cell and from the context menu select Confirm.

The translation is confirmed and focus moves to the next appropriate cell. After a segment istranslated and confirmed, the Status cell becomes gray and a check mark is shown in it. Also,
if you are using TM, the translation is automatically uploaded to the database.
6. Clickto save your work.

For more features available in the Translation Editor, and for additional information about translating files, see the online Help or the Translation Guide PDF.

CHAPTER 430

CHAPTER 5

Exporting Translated Projects
When all of the content in a project or file is translated, you can export the work to the application,
file, or location. For example, if a Flare project was translated, you can export your work out to a new
Flare project; if a Word document was translated, you can export your work out to a new Word document. This translated project or file can then be opened, and output can be created from it.

NOTE: If you have translated files for a Flare project, you also have the option of placing
your Lingo project where the Flare author can access it. The author can then link directly to
the Lingo project. This way, you do not need to export the Lingo project back out to a new
Flare project. However, in order to use this process, the author must also have Lingo 10
installed on his computer in order to correctly build the multilingual output.

CHAPTER 5

31

HOW TO EXPORT A TRANSLATED PROJECT
1. Select File > Export. The Export Finished Translation dialog opens.
2. (Optional) If you are working with a multilingual project, from the Language drop-down, selectthe language to include in the exported project.
NOTE: You will only see this option if you are working with a multilingual project.

NOTE: You will not see this option if you are translating files in a multilingual bundle
and need to export the files to return them to the content developer. This is because
you must return all the files in the bundle, regardless of their language.
3. (Optional) In the Destination Filename field, the name you provided for the Lingo project is displayed. You can keep the same name or enter a different one for the exported project.
4. (Optional) In the Destination Folder field, either accept the folder location entered, or click
Browse to find and select a different one. Typically, you want to export the project to a location where the author can retrieve it, unless you plan to deliver the file(s) to the author insome other way (e.g., email).
5. (Optional) If you want to create an additional ZIP file when exporting the project, select Makea zip file after export. If you do not select the check box, the project files are still exported, but
a ZIP file is not created. If you do select the check box, the project files are exported and an
extra ZIP file is produced.
NOTE: When you create a ZIP file on export, the folder structure is maintained.
6. Click Export.
7. (Optional) If you have not translated all of the files in the project, a confirmation dialog asks if
you want to export the project with untranslated files. Click Continue to export the project, or
click Cancel.
8. (Optional) If the project has already been exported to the selected destination, a dialog
informs you that the destination already exists. Lingo will permanently overwrite any updated
files. Click OK to export updated and new files, or click Cancel.

CHAPTER 5

32

9. When the export completes, a dialog opens. You can click Yes to view the new project, or you
can click No.
10. (Optional) In the Exporting dialog, click one or both of the following:nOpen Exported Project Opens the exported project in the appropriate program.

n

Save Log Saves the export log to the project folder.
NOTE: You can view saved export logs from the Project Properties dialog.

11. Click Close.

CHAPTER 5

33

CHAPTER 6

Other Lingo Features
Some of the other features that you are likely to use in Lingo include translation memory, machinetranslation, termbases, a concordance, segmentation rules, dictionaries, source control, and more.
This chapter discusses the following:

CHAPTER 6

Translation Memory

35

Machine Translation

35

Termbases

35

Concordance

36

Segmentation Rules and Split/Join

36

Statistics Reports

36

Quality Assurance Reports

37

Reviews

37

Dictionaries

37

Source Control

38

Command Line Exports and Updates

38

34

Translation Memory
A translation memory (TM) system is a database that consists of content in a source language next
to the translated content in one or more target languages. The great benefit of a TM system is thatit remembers what you have already translated in previous projects and uses it to provide suggestions for future translation work. You can connect your Lingo project to one or more TM databases.
For more information see the online Help or the Lingo Translation Guide. For links to this manual andothers, see the online Help.

Machine Translation
Machine translation (MT) is translation of text by a computer or translation program, such as
Google Translate. A great benefit of MT is that it allows translators to translate a large amount ofcontent quickly using an automated translation system, and then make any necessary updates tothe translation on a case-by-case basis (e.g., using a termbase to replace certain words, fixing translations that are not accurate in context). Then, the translator can add the target segments to an
installed translation memory (TM), improving the speed for future translations as well.
For more information see the online Help or the Lingo Translation Guide. For links to this manual andothers, see the online Help.

Termbases
In Lingo you can use concept-oriented terminology databases to make your translation work easierand quicker. Termbases allow you to create, manage, and reuse multilingual terminology from asingle storage area. This system automatically displays previously translated words from your termbase during the translation process, thus improving the reliability of translations.
A termbase is more powerful than a dictionary. The idea behind a termbase is to create a databaseof words and phrases that you never need to translate again.
For more information see the online Help or the Lingo Termbase Guide. For links to this manual andothers, see the online Help.

CHAPTER 6

35

Concordance
Lingo lets you use a concordance to perform advanced searches in one or more translation
memory (TM) databases. You can also search suggestions from machine translation (MT) providers. This means you can search for words you've already translated to maintain consistency. The
concordance searches the TM and suggestions from MT; in contrast, the search filter in the Translation Editor looks only in the current file.
For more information see the online Help.

Segmentation Rules and Split/Join
If you want to control segment breaks automatically, you can create segmentation rules. Lingo follows the format specified by Segmentation Rules eXchange (SRX). Therefore, after you create segmentation rules, you can export them to an SRX file. You can also import SRX files that have been
generated in Lingo.
Similar to the alignment tool, you can split and join segments manually in the Translation Editor. Youmight choose this manual process instead of segmentation rules when you need to quickly split orjoin segments and do not anticipate the need to do so automatically in future translations.
For more information see the online Help.

Statistics Reports
You can compute statistics for your Lingo project, displaying information about the translation work.
This is a way to compare the project files against the translation memory database in order to see
how much translation work has been completed and how much still needs to be done. This report
can be useful if you are a translator and need to provide estimates to a client, or if you are a content
developer who is using Lingo to manage the translation process.
For more information see the online Help.

CHAPTER 6

36

Quality Assurance Reports
You can run quality assurance (QA) reports to review your translated projects for discrepancies
between the source and target segments. This is a way to check the quality of your translations
before sending your project for review, returning a translation to a client, or exporting the final, translated project. These reports can be useful because they can help find errors that you might not haveotherwise noticed, such as formatting inaccuracies, repeated segments, or termbase errors. By running a QA report, you can locate errors and correct them early in the translation process, preventing
unnecessary rework later.
For more information see the online Help.

Reviews
You can send translated content to individuals for review. For example, you might use this feature if
you are an author who has received files back from a translator and you want to send them to athird party (who does not have access to Lingo) to ensure the translations are correct. When you
use this feature, you can export translations as a MadCap Contributor review package.
Before you send a Contributor review package to a reviewer, be sure the reviewer has the latest version of Contributor installed. Reviewers do not need to purchase a license to use Contributor review
Lingo files; instead, they can use Contributor's free review mode to review Lingo files.
For more information see the online Help.

Dictionaries
You can see which dictionaries are installed on your computer by opening the Options dialog andselecting the Spelling tab. You can also use the Options dialog to import more dictionaries that you
have downloaded.
In addition to all of the built-in dictionaries that are installed on your computer and dictionaries thatyou have downloaded, you can also use custom global or project dictionaries.
For more information see the online Help.

CHAPTER 6

37

Source Control
Lingo provides integrated support for version control applications. Built-in support is available forMicrosoft Team Foundation Server, Perforce, Git, and Apache Subversion. Additionally, because
Lingo uses a wide open architecture and stores files as independent XML files (such as XLF), you
can manually manage your files in an external source control system.
For more information see the online Help or the Lingo Source Control Guides. For links to thesemanuals and others, see the online Help.

Command Line Exports and Updates
You can use a command line prompt to manage your projects. This allows you to use automatedprocesses (such as the Task Scheduler utility in Windows) to schedule exports or updates. Depending on the command(s) used, you can accomplish any of the following.
n

Export a Lingo projectnUpdate/sync a Lingo project with the source filenExport a Lingo project in a specific language

For more information see the online Help.

CHAPTER 6

38

APPENDIX

PDFs
The following PDFs are available for download from the online Help.
Alignment Guide
Getting Started Guide
Key Features Guide
Shortcuts Guide
Source Control Guide: Git
Source Control Guide: Perforce
Source Control Guide: Subversion
Source Control Guide: Team Foundation Server
Termbases Guide
Touring the Workspace Guide
Translation Guide
What's New Guide

APPENDIX

39