Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 13 additions & 8 deletions guides/internationalization.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,32 +13,37 @@

Create a separate directory for each language using [ISO 639-1 language codes](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes). Place translated files in these directories with the same structure as your default language.

Mintlify supports 37 locale codes across 33 unique languages.

<Expandable title="supported language codes">
- `ar` - Arabic
- `ca` - Catalan
- `cs` - Czech
- `zh` or `zh-Hans` - Chinese (Simplified)
- `cn` or `zh` - Chinese
- `zh-Hans` - Chinese (Simplified)
- `zh-Hant` - Chinese (Traditional)
- `de` - German
- `cs` - Czech
- `da` - Danish
- `nl` - Dutch
- `en` - English
- `es` - Spanish
- `fi` - Finnish
- `fr` - French
- `fr-CA` - French (Canadian)
- `fr-CA` or `fr-ca` - French (Canadian)
- `de` - German
- `he` - Hebrew
- `hi` - Hindi
- `hu` - Hungarian
- `id` - Indonesian
- `it` - Italian
- `ja` - Japanese
- `ja`, `jp`, or `ja-jp` - Japanese
- `ko` - Korean
- `lv` - Latvian
- `nl` - Dutch
- `no` - Norwegian
- `pl` - Polish
- `pt` or `pt-BR` - Portuguese
- `pt` - Portuguese
- `pt-BR` - Portuguese (Brazilian)
- `ro` - Romanian
- `ru` - Russian
- `es` - Spanish
- `sv` - Swedish
- `tr` - Turkish
- `uk` - Ukrainian
Expand Down Expand Up @@ -661,11 +666,11 @@

```
images/
├── dashboard.png # English version

Check warning on line 669 in guides/internationalization.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/internationalization.mdx#L669

Use 'PNG' instead of 'png'.
├── fr/
│ └── dashboard.png # French version

Check warning on line 671 in guides/internationalization.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/internationalization.mdx#L671

Use 'PNG' instead of 'png'.
└── es/
└── dashboard.png # Spanish version

Check warning on line 673 in guides/internationalization.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/internationalization.mdx#L673

Use 'PNG' instead of 'png'.
```

Reference images using relative paths in your translated content.
Expand Down Expand Up @@ -739,10 +744,10 @@
</Accordion>

<Accordion title="How do I handle code examples in translated content?">
Code itself should not be translated—variable names, function calls, and syntax are language-agnostic. Comments within code blocks can be translated if they explain concepts users need to understand. Instructions surrounding code blocks should be fully translated.

Check warning on line 747 in guides/internationalization.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/internationalization.mdx#L747

In general, use active voice instead of passive voice ('be translated').

Check warning on line 747 in guides/internationalization.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/internationalization.mdx#L747

In general, use active voice instead of passive voice ('be translated').
</Accordion>

<Accordion title="Does Mintlify support right-to-left languages like Arabic or Hebrew?">
Yes. Arabic (`ar`) and Hebrew (`he`) are in the supported language codes list. Mintlify handles RTL layout automatically when these language codes are configured. Test your documentation in RTL to verify that navigation, tables, and code blocks display correctly.

Check warning on line 751 in guides/internationalization.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/internationalization.mdx#L751

In general, use active voice instead of passive voice ('are configured').
</Accordion>
</AccordionGroup>
Loading