Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


TypeNameUsageOnly available with listed pluginMandatory


(proofRead is deprecated)

Contains a files and/or a folder tree with the files, that should be imported into the segment table of translate5. The folder tree inside of workfiles will be mirrored as folder tree inside of translate5.
DirectoryrelaisContains a structure that mirrors the structure in workfiles. This means, all directory and filenames must be identical with the names in the workfiles directory. All contained files are imported as relais/pivot content for the files in workfiles. Files existing in "workfiles" but missing in "relais" are skipped.
DirectoryreferenceFilesReference files that are attached to a task for download. Additional information for the user working on the task.


(visualReview is deprecated)

More information about the visual plug-in of translate5 (paid plug-in, only viewable for users with appropriate rights)

The contained files are used to generate a layout for visual translation or visual review (with "What you see is what you get").
Possible contents of the directory visual are:

  • A file "reviewHtml.txt", that contains one or multiple URLs (one URL by line and nothing else). The order of the URLs should be the same as the order of the corresponding files in workfiles.
  • OR: A number of PDF files OR HTML files (mixing PDF with HTML is currently not supported - please contact translate5s developers, if you need this)
    • The PDFs / HTMLs contain the same text as the text that is contained in the files in the workfiles directory.
    • If the workfiles directory contains bilingual files, the PDFs / HTMLs can either be in source or target language
    • if the PDFs / HTMLs are in the target language, the import option "Connect layout to" should be set to "target"
    • The order of the PDF / HTML files on the file system should be the same as the order of the contents in the workfiles directory. Yet it is not necessary that the PDFs / HTMLs are the same number of files or have the same file names.
    • The naming of the files in the visual folder does not matter at all. Only their order should reflect the order of the contents in the workfiles folder.
    • multiple PDFs are merged to a single PDF and result in a single review file containing several pages/chapters whilst multiple HTML files or downloaded URLs will be accessible through a pager in the frontend
  • OR: A number of XML/XSL combinations.  These combinations will be processed to HTML files which then will be used as the visual source as described above. This incorporates the standard, text-based segmentation and thus these XML/XSLT files are not aligned to the bilingual files in the "workfiles" folder like when adding XML/XSL via the "alignLayout" folder (see below). The stylesheet(s) have to be in the /visual folder as well and must be referenced with a XML preprocessing instruction e.g.  <?xml-stylesheet type="text/xsl" href="stylesheet.xsl"?>
Directoryvisual/imageMore information about the visual plug-in of translate5 (paid plug-in, only viewable for users with appropriate rights)

Subdirectory in /visual. The contained files/images are used to generate the layout for the visual. You can add one or more images here (file-extensions: *.jpg, *.jpeg, *.gif, *.png, *.bmp, *.gif, *.tiff, *.webp) alongside with an optional web-font (file-extension: *.woff) to generate the visual with OCR-analysis of the image. The web-font will be used for all detected text if given. Please note, that a valid Google Cloud Vision API key is needed for this, see here

More information about the visual plug-in of translate5 (paid plug-in, only viewable for users with appropriate rights)

Subdirectory in /visual. If a Video is supplied here, a visual video can be generated. Only in conjunction with a workfile with timecodes, that connect the segments to frames in the video, which currently must be a .xslx or .srt file. The prequesites are:

  • Video: Filetype mp4, codec h264, max. size 250MB, max. Resolution FullHD (1920x1080), max. Bitrate 1MB/s
  • Excel Workfile: Filetype xslx, 3 columns, first column "Timecode from", second column "Timecode to", third column "Segment text"; The first row may be a header row "from", "to", "text"
  • SRT Workfile: SubRip subtitle file, filetype srt as defined here:
  • Supported Timecode formats; The timecodes in the workfiles must be in one of the following formats: "HH:MM:SS:FF", "HH:MM:SS,mmm" (srt), "HH:MM:SS.mmm" (vtt) or "v" (plain milliseconds)
File*.xslMore information about the visual plug-in of translate5 (paid plug-in, only viewable for users with appropriate rights)

Xml files in the directories "workfiles" and "alignLayout" can contain an xml-type reference to an xsl file, that is able to transform the XML to a layouted HTML version. This reference to xsl can either be an http(s) link or can be a path relative to the xml file pointing to an xsl file within the zip package
DirectoryalignLayoutMore information about the visual plug-in of translate5 (paid plug-in, only viewable for users with appropriate rights)

Similar to the concept of a pivot language it is possible to use an aligned XML with a referenced XSL stylesheet (see above) as source for the visual review. This XML will be aligned to a matching bilingual file in the workfiles folder, meaning that it is expected to hold the same segments (what is validated). The filename of the aligned layout must be identical to the bilingual that contains the same contents,  except the fileextension. So "xyz.xml" matches "xyz.xml.sdlxliff" and it also matches "xyz.sdlxliff" and "xyz.xml.mxliff" or "xyz.mxliff". The aligned XML must be provided in a folder "alignLayout" and define a stylesheet via processing instruction as described above. It is possible of using multiple aligned XML/XSLT files for multiple bilingual files in "workfiles". The stylesheet has to be in the same folder and must be referenced with a XML preprocessing instruction e.g.  <?xml-stylesheet type="text/xsl" href="stylesheet.xsl"?>
File*.tbxContains the terminology for the task. The contained terminology is used to mark terms in the task. Must reside on the top level of the zip-file. Only the first tbx-file in the zip file is used. Please see here for information, which terms are used for a task.
FileQM_Subsegment_Issues.xmlContains the MQM issue types, that should be used for the task. If present, overrides the default MQM issue types for this task. An example file you find here.
Filetask-template.xmlContains a task template. Can be used to configure translate5 in an task-specific way.

Only for import packages, that contain STAR Transit NXT files.
The first three letters of the file name must contain the transit-specific source-language file extension (in the example "DEU" for German).
The last three letters of the file name (before the file extension ".transitConfig") must contain the transit-specific target-language file extension (in the example "ENG" for English).

The file itself can be empty. It is a flag file.

File*.bconfThis is a batch configuration file as exported from Okapi Rainbow. With Okapi Rainbow you can create your own custom file filters, for example for special kind of xml or txt-files. If you use the Okapi plugin for translate5, you can seamlessly use Okapi in the background to convert files on import time - and convert them back on export (without the user having to touch Okapi). Please see details on the translate5 file format page and on the translate5 Okapi Plug-in pagenoFilepixel-mapping.xlsxThis optional file can be provided to define the pixel-length for a pixel-based length check in translate5. It defines the pixel-width for each character of a font for a certain font-size.