This article aims to assist you in comprehending how to effectively utilize tags in Bureau Works.

Tags - Definition and usage

Tags serve as the fundamental formatting tool employed in HTML and various other markup languages like XML.

Within Bureau Works, you will encounter various tag types, including formatting tags and structural tags.

• A tag is a metadata that is included in a content/file

• There are different reasons for having tags within a file, such as: Content formatting (bold, Italic, superscript, etc), creating hyperlinks to redirect users to a certain URL (https://app.bureauworks.com/) and other tags are structural tags/entity references that are required for certain applications/software to read/process the content properly (XML tags, for example).

When we talk about the .XML extension, for example, some characters have a special meaning, so if we place a character like "<" inside an XML element, it will generate an error because the parser interprets it as the start of a new element.

Below there is an example of a text with a special character that is part of an XML file:

<message>Words < 1000</message>

To avoid errors, in the XML file, the < character was replaced with an entity reference < so that the parser could interpret the content correctly. In the XML file, the content will show as:

<message>Words &lt; 1000</message>

The following table shows some examples of entity references in XML to prevent similar errors from occurring with other special characters:

As you can see, there are numerous reasons for a tag to be added to a file, and there are hundreds of different tags that could be used. When it comes to content localization, it is important to ensure that existing tags in the source language have also been added to the translation.

⚠️ It's worth noting that there are a few exceptional cases where certain tag types may not hinder the file's download or cause corruption. Nevertheless, the overarching guideline emphasizes that tags from the source should consistently be integrated into the target content.

How to handle tags in Bureau Works Editor

Having gained a deeper understanding of tags, their functionality, and their significance within a file, let's now delve into the topic of tags within Bureau Works Editor.

2.1. Expanded tags option

Bureau Works offers two methods for displaying tags within the editor, each with its own set of advantages. However, when it comes to dealing with tags, we strongly recommend enabling the "Expanded Tags" option.

To activate the "Expanded Tags" option, follow these simple steps: Open the Editor Menu and click on the "Document" tab. Located just beneath the "Viewing Preferences" section, you will find the "Expanded Tags" option:



If disabled, the tags will solely display their index number, providing information only regarding the order they should follow. On the other hand, when they are expanded, additional context will be presented, giving linguists a clearer understanding of the tag's purpose.

Below is an example of how the tags appear with this option turned off:

Here, you can observe the distinction between the two choices:

2.2. Tag mismatches

When there is a tag mismatch due to tag differences between source and target, the user will receive a warning message when trying to confirm the segment:

Then, the user has two options:

Click on the Red button ❌  to go back to the segment and make the adjustments needed before trying to confirm it again or click on the Green button ✅ to mark the segment as confirmed, ignoring the mismatch alert

2.3. Fixing missing tags

To fix missing tags, the user has two options:

• Manually drag and drop the missing tags from the source to the target, and drop the tags in the correct position in the translation.

In the example above, it is certain that the tags should be around "A:". With that in mind, the user can easily identify where to add the tags to keep them in the same position as in the source content.

You can manually drag them or use the Fix Tags feature from our Augmented Actions menu:

• The user can also use the keyboard shortcuts below (the shortcuts will be automatically adjusted for MAC users)

3. Takeaways

• Tags are important and should always be added/kept in the translation (in some occasions, some formatting tags are not applicable for certain languages)

• Missing tags can impact the text formatting, and URLs or even prevent an application from running properly

• Users will always be alerted when there are missing tags in the translation

• Fixing missing tags is simple as dragging and dropping the tags to the correct position in the target content
  
  

   

  ---

  If any questions were not answered in this article, please don't hesitate to contact our support team at help@bureauworks.com.