Skip to content

Commit

Permalink
improve a bit the Crowdin doc
Browse files Browse the repository at this point in the history
  • Loading branch information
slorber committed Jan 15, 2021
1 parent c62c343 commit 92c037c
Showing 1 changed file with 18 additions and 0 deletions.
18 changes: 18 additions & 0 deletions website/docs/i18n/i18n-crowdin.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,12 @@ Refer to the **[Crowdin documentation](https://support.crowdin.com/)** and **[Cr

:::

:::tip

Use this **[community-driven GitHub issue](https://github.com/facebook/docusaurus/discussions/4052)** to discuss anything related to Docusaurus + Crowdin.

:::

## Crowdin overview

Crowdin is a translation SaaS, offering a [free plan for open-source projects](https://crowdin.com/page/open-source-project-setup-request).
Expand Down Expand Up @@ -391,6 +397,18 @@ In practice, **it didn't work very reliably** for a few reasons:
- 2 users concurrently editing on Git and Crowdin can lead to a translation loss
- It requires the `crowdin.yml` file to be at the root of the repository

### In-Context localization

Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.

:::caution

Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.

Crowdin replaces markdown strings with technical ids such as `crowdin:id12345`, but it does so too aggressively, including hidden strings, and mess-up with the frontmatter, admonitions, jsx...

:::

### Example configuration

The **Docusaurus v2 configuration file** is a good example of using versioning and multi-instance:
Expand Down

0 comments on commit 92c037c

Please sign in to comment.