Adding Style Guides
Every person and every brand has a voice that’s unique to them. To help ensure translations are consistent with your brand across all languages, Transifex lets you provide style guides for your translators. But what’s a style guide? It’s simply a set of guidelines about how your brand ought to be presented. Later in this article, we’ll go over some things you might want to include in your style guide.
To create a style guide:
Head to your Organization Settings from the main navigation.
On the left menu, click on Style Guides.
Click on Add a Style Guide.
Give your style guide a title, then put in your style guide content. Whenever you create a new style guide in Transifex, you’ll see a style guide outline in the content box. You can use it as a reference or create a style guide following your own structure.
Hit Save to finish creating your style guide.
A Table of Contents will be automatically generated for translators using the Heading 1's and Heading 2's in your style guide.
Things you might include in a style guide
It’s up to you how much or how little information you include in your style guide. If you’re working with a translation agency, they can often work with you to create a style guide specific to your company. In general though, style guides contain some variation of the following:
- Background information on your company, product, and target market
- Information about your brand’s personality, tone, and voice
- Guidelines for grammar, written syntax (e.g. how should dates be written), and stylistic preferences
- Language/culture-specific information or instructions
Examples of style guides
Below are a few public style guides you can look at for reference:
Once you’ve created a style guide, you can assign it to one or more of your projects:
From the Style Guides overview page, click on the style guide you want to assign to a project.
In the Assign project dropdown, use the checkboxes to select the project(s) you want to assign the style guide to. When done, click outside of the dropdown.
To unlink a style guide and project, simply uncheck the project in the dropdown.
A project can only have one style guide assigned to it at a time.
Translators and Reviewers can access and view style guides in several ways:
- By clicking the Style guide button in the header of the Editor
- By clicking View style guide from the top of the Languages page of a project