File Import Tweak: Filter and modify text, keys, and metadata

This app is specifically designed to help you modify your keys, context information, labels, maximum length or the text itself on the file import event. It also allows you to hide or show some strings depending on certain rules. The application listens to “file upload” or “file update” events and processes every new key, allowing you to make changes to each key and its properties.

App Demo

Quick Help

The application allows you to create one or more rules. Each rule consists of Filter and Alter parts.

First, you filter the keys you need to alter by its property (like string visibility or another boolean properties like hasPlurals) or using regular expressions executed on multiple properties (like key, context, text). Then you select the action and configure it to change boolean properties (e.g. make string visible or hidden for translators) or transform text properties by performing search and replace operations with regular expressions.

After installation, the application can be found in the Tools section of your project. Click the “Plus” button to add your first rule.

Features

The following is a list of filtering options available in the app:

• Key (regexp)
• Text (regexp)
• Context (regexp)
• Has Defined Max. Length (boolean)
• Does Not Have Max. Length (boolean)
• Is Hidden (boolean)
• Is Not Hidden (boolean)
• Has Plurals (boolean)
• Does not have plurals (boolean)
• Has Labels (comma separated list)
• Does not have labels (comma separated list)
• Does not have any labels

And the list of actions that can be performed on the matching key objects:

1. Hide
2. Make visible
3. Set Max Length
4. Remove Max Length
5. Replace In Key
6. Replace In Text
7. Replace In Context
8. Add Label
9. Remove Label
10. Do not import (skip)

Note

It is strongly recommended to install the application only for projects where it will be used. Processing all keys in each project (which is the default behavior) may cause unnecessary delays in processing your project files.

Be sure to check the in-app help before you start.

Screenshot

Use Cases

Normalizing Spaces Between Segments

With this app, users can add spaces between segments in source languages that don’t use spaces, such as Chinese. This creates a well-formatted translated document in other languages like English.

To achieve this, users can create a rule with a filter that matches all segments using the regular expression ^(.*)$. The parentheses capture the matched string as a group.

The replacement expression $1   (there should be a space after $1) inserts a space after the captured group from the previous regular expression. $1 refers to the first (and only) captured group in the search expression.

Using these regular expressions together will add spaces between segments in the translated documents.