Translating Your Docs

by Jarratt Isted

Once you've enabled multilingual HelpDocs, you can translate all your docs into as many languages as you like. 

A flag icon will appear in the left sidebar. If you're currently editing an article, the flag will appear in the upper left menu. This lets you change the language you're currently editing

Language switcher on sidebar menu
Language switcher on article menu

Once you select a language you'll find little grey labels next to everything that's localizable. i.e. everything that is specific to your current language.

You'll need to enable Multilingual HelpDocs to translate your docs

Translating Categories

  1. Head to Articles
  2. Select a language from the dropdown
  3. Click the pencil icon on a category row to pull out the editor
  4. Translate the Title and Description
  5. Hit Save

Translating Articles

  1. Head to Articles
  2. Select a language from the dropdown
  3. Click on a category to expand it's articles
  4. Click the title of the article you'd like to translate
  5. Start translating the article, title and tags in the secondary language
  6. Check Translation Complete when you're done
  7. Hit Save

Pro tip
Quickly switch between your default and secondary languages using the dropdown

Changing Common Default Strings

After you've translated your articles, you'll want to translate the common default strings (i18n) in HelpDocs, like Author, and How Did We Do?

We provide default translations out of the box for French, German, Dutch, and Spanish
  1. Head to Settings i18n
  2. Select the language in the dropdown you'd like to translate into
  3. Write your new strings and hit Save

How Did We Do?