End users

Page tree

Versions Compared

Key

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

Table of Contents

Versioning

Excerpt Include
Version and versioning
Version and versioning
nopaneltrue

Change History
limit3

In order to To be able to use the functions described here, the the Visual plug-in needs to be installed.

Exchanging a Visual file
Anchor
change_visual
change_visual

In the event that If the layout template of a file to be translated has changed in a running project with Visual integration, you can replace the corresponding file for the Visual as follows:

  1. Switch to the task list.
  2. Open the task menu on the line of the relevant project () and select the “Exchange Visual” option.
  3. The “Visual file upload and configuration” window appears.
  4. In the upper part of the window, keycap: 1 you can see the Visual files currently used in the project with indication of file name, file type as well as date and time when the file was added. The list can be sorted according to the contents of the three columns.
  5. Use the drop-down at the bottom of the window to select keycap: 2 whether the Visual should be connected to the source or to the target.
  6. In the lower area of the window, keycap: 3 you can now upload the new Visual file(s) to replace the existing file(s) using drag and drop or the “Add” button.
  7. After uploading, the new Visual files are visible in the lower part of the window, with indication of file name, file type and size. The list can be sorted according to the contents of the three columns.
  8. If you have inadvertently uploaded one or more incorrect Visual files, you can delete them by ticking the corresponding line and then clicking on the “Remove file” button keycap: 4.
  9. Confirm via the “Exchange visual” button in the bottom right keycap: 5.

The view carries you back to the task list, and you can see from the status “visualexchange” and the progress bar that the exchange is running and when it is complete.

The replaced Visual file(s) are moved to the reference files and, depending on the connection type, “Visual replaced source replacement date_replacement time” or “Visual replaced target replacement date_replacement time” is added at the beginning of the file name.

The “Exchange visual” option is only available in the task menu if the project has been set up with a Visual file. If not, the option “Add visual” appears in the same place instead. For projects whose Visual is a video or an XML file with an XSLT stylesheet, neither option is offered, as the Visual cannot be exchanged in these cases (see File formats).

The new Visual file must be in the same format as the original Visual file for which it is being exchanged. If a Visual file is uploaded whose format differs from that of the existing Visual file(s), its information is coloured red and an error is flaggedflagged. What matters here is the Visual type (PDF, image, HTML/website): images, for example, can also be replaced by images in a different image format, e.g. PNG by JPG.

Attention: If more than one Visual file is involved, all Visual files must be uploaded (again) – even if only one of them needs to be exchanged. The file(s) that are uploaded for the Visual exchange will replace the previously used Visual files.

You can also upload several Visual files together or provide them in a zip package that contains the .zip folder structure according to an import zip archive. Only a single zip file can be uploaded at a time, and it cannot be combined with any other files.

Only files of the same file type can be added when dealing with multiple Visual files. What matters is the file extension: different image formats (e.g. PNG and JPG) cannot be combined in the same upload either. Web fonts (WOFF) belonging to PDF files must therefore be uploaded together with the PDF files in a zip file.

PDF visual files can also be exchanged for several projects at the same time via the batch operations option in the project list.

Error messages during Visual exchange

In the following cases, an uploaded Visual file is highlighted in red and an error is displayed:

  • The file format of the new Visual file(s) does not correspond to that of the previous Visual file(s).
  • The file format provided is not supported.
  • Files with different file extensions have been combined in the same upload.
  • More than one zip file, or a zip file together with other files, has been uploaded.
  • A video file has been uploaded. Videos can only be added as a Visual when the project is created.

The type of error becomes apparent when you hover over the “Type” column on the line of the affected file with your mouse.


Adding a Visual file
Anchor
add_visual
add_visual

In the event that Visual files need to be included in a running project that had been set up without any Visual files, you can still add the Visual files to the project later:

  1. Switch to the task list.
  2. Open the task menu on the line of the relevant project () and select the “Add visual” option.
  3. The “Visual file upload and configuration” window appears.
  4. Use the drop-down at the bottom of the window to select keycap: 1 whether the Visual should be connected to the source or to the target.
  5. Now upload the new visual file(s) keycap: 2 via drag and drop or via the “Add” button.
  6. If you have inadvertently uploaded one or more incorrect exchange files, you can delete them by ticking the corresponding line and then clicking on the “Remove file” button keycap: 3.
  7. Confirm via the “Exchange visual” button the “Add visual” button in the bottom right keycap: 4.

For this functionality, the Visual plug-in must be active in your translate5 system.

The “Add visual” option is only available in the task menu if the project was not set up using a Visual file. If there already is a Visual file, the option “Exchange Visual” will appear in the same place instead.

Only files of the same file type can be added when dealing with multiple Visual files. What matters is the file extension: different image formats (e.g. PNG and JPG) cannot be combined in the same upload either. Web fonts (WOFF) belonging to PDF files must therefore be uploaded together with the PDF files in a zip file.


File formats

File formats permitted for Visual exchangeFile formats not permitted for Visual exchange

PDF files

Video files: Due to the associated time codes of the subtitles, there could be shifts so that the alignment between video and text content is no longer guaranteed or meaningful.

Pixel-based images (e.g. screenshots of apps for app translation).

Image Removed
Pixel-based images can be combined with work files in JSON format, for example. translate5 then matches the texts appearing in the images to the strings in the JSON file.XSLT stylesheets that are linked with the imported XLIFF or XML source files.

HTML files in a zip folder that contains the .zip folder structure according to an import zip archive.

Website URLs

Website URLs as a “reviewHtml.txt” file in a zip folder.

...

Which files are accepted when exchanging or adding a Visual depends on the Visual type with which the project was created. The Visual type is shown in the “Visual file upload and configuration” window in the “Type” column of the Visual files currently available. For the formats permitted when creating a project, please refer to the page The Visual plug-in.

Current Visual typePermitted for the exchangeNotes

PDF file

Several PDF files are merged into one Visual. If web fonts (WOFF) are to be uploaded together with the PDF files, both must be provided in a single zip file. PDF Visual files can also be exchanged in the project list for several projects at the same time via the batch operations option.

Image with character recognition (pixel-based images, e.g. screenshots for app translations)

  • JPG, JPEG, GIF, PNG, BMP, TIFF, WEBP
  • Zip file with the correct .zip folder structure

The image format may change, e.g. PNG files can be replaced by JPG files. Within a single upload, however, all images must have the same file extension.

HTML page, website download (URLs), XML with HTML

  • Zip file with the correct .zip folder structure (HTML files including CSS, images and web fonts, or a “reviewHtml.txt” file with website URLs)
  • Website URLs in the “URL” tab

Individual HTML files or a single “reviewHtml.txt” file cannot be uploaded directly, only within a zip file.

Video with subtitles

No exchange possible

The “Exchange visual” option is not offered in the task menu. Reason: due to the time codes associated with the subtitles, shifts could occur, so that the alignment between video and text content would no longer be guaranteed.

XML with XSLT

No exchange possible

The “Exchange visual” option is not offered in the task menu.

No Visual (“Add visual” option)

  • PDF (web fonts in WOFF format only together with the PDF files in a zip file)
  • JPG, JPEG, GIF, PNG, BMP, TIFF, WEBP
  • Zip file with the correct .zip folder structure
  • Website URLs in the “URL” tab

Videos (MP4) cannot be added subsequently, only when the project is created.

Image Added

If the Visual is connected to the target, every Visual file (except PDF) must be assignable to a work file via its file name.