Skip to content

feat(locadex): continuous i18n #1635

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed

feat(locadex): continuous i18n #1635

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
852 changes: 426 additions & 426 deletions .gt/downloaded-versions.json
View file
Open in desktop

Large diffs are not rendered by default.

8 changes: 4 additions & 4 deletions es/create/files.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ Los archivos deben ser de menos de 20 MB para imágenes y 100 MB para otros tipo
### Formatos de documentos
</div>

<Note>Los formatos de documento solo están disponibles en los planes Enterprise.</Note>
<Note>Los formatos de documentos solo están disponibles en los planes Enterprise (excepto cuando se usa autenticación).</Note>

- `.pdf`
- `.txt`
Expand All @@ -81,17 +81,17 @@ Los archivos deben ser de menos de 20 MB para imágenes y 100 MB para otros tipo
### Formatos de datos
</div>

<Note>Los formatos de datos solo están disponibles en los planes Enterprise.</Note>
<Note>Los formatos de datos están disponibles únicamente en los planes Enterprise (excepto cuando se usa autenticación).</Note>

- `.csv`
- `.tsv`
- `.xml`

<div id="archive-formats">
### Formatos de archivo comprimido
### Formatos de archivo
</div>

<Note>Los formatos de archivo comprimido solo están disponibles en los planes Enterprise.</Note>
<Note>Los formatos de archivo solo están disponibles para planes Enterprise (excepto cuando se usa autenticación).</Note>

- `.zip`
- `.rar`
Expand Down
39 changes: 19 additions & 20 deletions es/create/reusable-snippets.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,30 +1,29 @@
---
title: 'Fragmentos reutilizables'
description: 'Fragmentos personalizados reutilizables para mantener el contenido sincronizado'
title: "Fragmentos reutilizables"
description: "Fragmentos personalizados y reutilizables para mantener el contenido sincronizado"
---

Uno de los principios fundamentales del desarrollo de software es DRY (Don&#39;t Repeat Yourself), que también aplica a la documentación. Si te encuentras repitiendo el mismo contenido en varios lugares, crea un fragmento personalizado para mantener tu contenido sincronizado.
Uno de los principios fundamentales del desarrollo de software es DRY (“Don’t Repeat Yourself”), que también se aplica a la documentación. Si te encuentras repitiendo el mismo contenido en varios lugares, crea un fragmento personalizado para mantener tu contenido sincronizado.

<div id="creating-a-custom-snippet">
## Creación de un fragmento personalizado
## Creación de un snippet personalizado
</div>

**Requisito previo**: Debes crear tu archivo de fragmento en el directorio `snippets` para que la importación funcione.
**Requisito previo**: Debes crear el archivo del snippet en el directorio `snippets` para que la importación funcione.

Cualquier página en el directorio `snippets` se tratará como un fragmento y no
se renderizará como una página independiente. Si deseas crear una página independiente
a partir del fragmento, importa el fragmento en otro archivo e invócalo como un
Cualquier página en el directorio `snippets` se tratará como un snippet y no se
renderizará como una página independiente. Si deseas crear una página independiente
a partir del snippet, importa el snippet en otro archivo y utilízalo como un
componente.

<div id="default-export">
### Exportación por defecto
### Exportación predeterminada
</div>

1. Agrega contenido al archivo del fragmento que quieras reutilizar. Opcionalmente, puedes agregar variables que se puedan completar mediante props
cuando importes el fragmento. En este ejemplo, nuestra variable es word.
1. Agrega contenido al archivo de fragmento que quieras reutilizar.

```typescript snippets/my-snippet.mdx
¡Hola mundo! Este es mi contenido que quiero reutilizar en todas las páginas.
¡Hola mundo! Este es mi contenido que quiero reutilizar en varias páginas.
```

2. Importa el fragmento en tu archivo de destino.
Expand All @@ -39,7 +38,7 @@ import MySnippet from '/snippets/path/to/my-snippet.mdx';

## Encabezado

Lorem ipsum dolor sit amet.
Lorem impsum dolor sit amet.

<MySnippet/>

Expand Down Expand Up @@ -80,12 +79,12 @@ Lorem ipsum dolor sit amet.
1. Exporta una variable desde tu archivo de fragmento:

```typescript snippets/path/to/custom-variables.mdx
export const myName = 'mi nombre';
export const myName = "mi nombre";

export const myObject = { fruit: 'fresas' };
export const myObject = { fruit: "fresas" };
```

2. Importa el fragmento desde el archivo de destino y usa la variable:
2. Importa el fragmento desde tu archivo de destino y usa la variable:

```typescript destination-file.mdx
---
Expand All @@ -102,23 +101,23 @@ Hola, mi nombre es {myName} y me gusta {myObject.fruit}.
### Fragmentos de JSX
</div>

1. Exporta un componente JSX desde tu archivo de fragmento. (Consulta [Componentes de React](/es/customize/react-components) para obtener más información):
1. Exporta un componente de JSX desde tu archivo de fragmentos. (Consulta [Componentes de React](/es/customize/react-components) para obtener más información):

```js icon=square-js snippets/my-jsx-snippet.jsx
export const MyJSXSnippet = () => {
return (
<div>
<h1>¡Hola, mundo!</h1>
</div>
)
}
);
};
```

<Note>
Importante: Al crear fragmentos de JSX, usa la sintaxis de funciones flecha (`=>`) en lugar de declaraciones de función. La palabra clave `function` no es compatible en este contexto.
</Note>

2. Importa el fragmento desde tu archivo de destino y utiliza el componente:
2. Importa el fragmento desde tu archivo de destino y usa el componente:

```typescript destination-file.mdx
---
Expand Down
6 changes: 3 additions & 3 deletions fr/create/files.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ Les fichiers doivent peser moins de 20 Mo pour les images et moins de 100 Mo pou
### Formats de documents
</div>

<Note>Les formats de documents ne sont disponibles que pour les offres Enterprise.</Note>
<Note>Les formats de documents ne sont disponibles que pour les offres Enterprise (sauf lors de l’authentification).</Note>

- `.pdf`
- `.txt`
Expand All @@ -81,7 +81,7 @@ Les fichiers doivent peser moins de 20 Mo pour les images et moins de 100 Mo pou
### Formats de données
</div>

<Note>Les formats de données sont uniquement disponibles pour les offres Enterprise.</Note>
<Note>Les formats de données sont uniquement disponibles avec les offres Enterprise (sauf en cas d’authentification).</Note>

- `.csv`
- `.tsv`
Expand All @@ -91,7 +91,7 @@ Les fichiers doivent peser moins de 20 Mo pour les images et moins de 100 Mo pou
### Formats d’archive
</div>

<Note>Les formats d’archive sont uniquement disponibles avec les offres Enterprise.</Note>
<Note>Les formats d’archive ne sont disponibles que pour les plans Enterprise (sauf en cas d’authentification).</Note>

- `.zip`
- `.rar`
Expand Down
42 changes: 22 additions & 20 deletions fr/create/reusable-snippets.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,33 +1,33 @@
---
title: 'Extraits réutilisables'
description: 'Extraits personnalisés réutilisables pour garder le contenu synchronisé'
title: "Extraits réutilisables"
description: "Extraits personnalisés et réutilisables pour maintenir le contenu synchronisé"
---

L’un des principes fondamentaux du développement logiciel est DRY (Don&#39;t Repeat Yourself), qui s’applique aussi à la documentation. Si vous répétez le même contenu à plusieurs endroits, créez un extrait personnalisé pour garder votre contenu synchronisé.
L’un des principes fondamentaux du développement logiciel est DRY (Don’t Repeat
Yourself), qui s’applique aussi à la documentation. Si vous vous retrouvez à répéter le même contenu à plusieurs endroits, créez un extrait personnalisé pour maintenir votre contenu synchronisé.

<div id="creating-a-custom-snippet">
## Créer un extrait personnalisé
</div>

**Prérequis** : vous devez créer votre fichier d’extrait dans le répertoire `snippets` pour que l’import fonctionne.
**Condition préalable** : vous devez créer votre fichier d’extrait dans le répertoire `snippets` pour que l’import fonctionne.

Toute page située dans le répertoire `snippets` sera traitée comme un extrait et ne sera pas
rendue en page autonome. Si vous souhaitez créer une page autonome
à partir de l’extrait, importez l’extrait dans un autre fichier et utilisez-le comme
rendue en tant que page autonome. Si vous souhaitez créer une page autonome
à partir de l’extrait, importez l’extrait dans un autre fichier et appelez-le en tant que
composant.

<div id="default-export">
### Export par défaut
</div>

1. Ajoutez du contenu au fichier d’extrait que vous souhaitez réutiliser. Vous pouvez éventuellement ajouter des variables qui seront renseignées via des props
lors de l’import de l’extrait. Dans cet exemple, notre variable est word.
1. Ajoutez du contenu à votre fichier d’extrait que vous souhaitez réutiliser.

```typescript snippets/my-snippet.mdx
Bonjour le monde ! Voici mon contenu que je souhaite réutiliser sur plusieurs pages.
Bonjour le monde ! Voici mon contenu que je souhaite réutiliser sur plusieurs pages.
```

2. Importez l’extrait dans le fichier de destination.
2. Importez le snippet dans votre fichier de destination.

```typescript destination-file.mdx
---
Expand Down Expand Up @@ -77,15 +77,15 @@ Lorem ipsum dolor sit amet.
### Variables réutilisables
</div>

1. Exportez une variable depuis votre fichier d’extrait :
1. Exportez une variable depuis votre fichier de fragment :

```typescript snippets/path/to/custom-variables.mdx
export const myName = 'mon nom';
export const myName = "mon nom";

export const myObject = { fruit: 'fraises' };
export const myObject = { fruit: "fraises" };
```

2. Importez l’extrait depuis votre fichier cible et utilisez la variable :
2. Importez l’extrait depuis votre fichier de destination et utilisez la variable :

```typescript destination-file.mdx
---
Expand All @@ -102,23 +102,25 @@ Bonjour, je m'appelle {myName} et j'aime {myObject.fruit}.
### Extraits JSX
</div>

1. Exportez un composant JSX depuis votre fichier d’extraits. (Voir [Composants React](/fr/customize/react-components) pour plus d’informations)
1. Exportez un composant JSX depuis votre fichier d’extraits. (Voir [Composants React](/fr/customize/react-components) pour en savoir plus) :

```js icon=square-js snippets/my-jsx-snippet.jsx
export const MyJSXSnippet = () => {
return (
<div>
<h1>Bonjour le monde !</h1>
<h1>Bonjour, monde !</h1>
</div>
)
}
);
};
```

<Note>
Important : Lors de la création d’extraits JSX, utilisez la syntaxe de fonction fléchée (`=>`) plutôt que des déclarations de fonction. Le mot-clé `function` n’est pas pris en charge dans ce contexte.
Important : lors de la création d&#39;extraits JSX, utilisez la syntaxe de fonction fléchée (`=>`)
plutôt que des déclarations de fonction. Le mot‑clé `function` n&#39;est pas pris en charge dans ce
contexte.
</Note>

2. Importez l’extrait depuis votre fichier cible et utilisez le composant :
2. Importez l&#39;extrait depuis votre fichier de destination et utilisez le composant :

```typescript destination-file.mdx
---
Expand Down
16 changes: 8 additions & 8 deletions zh/create/files.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,31 +67,31 @@ Mintlify 会自动从你的文档存储库在你的 domain 的相应路径提供
### 文档格式
</div>

<Note>文档格式仅在 Enterprise 方案中提供。</Note>
<Note>文档格式仅限企业版计划使用（启用认证时除外）。</Note>

- `.pdf`
- `.txt`
- `.doc`、`.docx`
- `.xls`、`.xlsx`
- `.ppt`、`.pptx`
- `.doc`, `.docx`
- `.xls`, `.xlsx`
- `.ppt`, `.pptx`
- `.rtf`
- `.odt`、`.ods`、`.odp`
- `.odt`, `.ods`, `.odp`

<div id="data-formats">
### 数据格式
</div>

<Note>数据格式仅适用于企业版计划。</Note>
<Note>数据格式仅适用于企业版计划（启用认证时除外）。</Note>

- `.csv`
- `.tsv`
- `.xml`

<div id="archive-formats">
### 归档格式
### 压缩归档格式
</div>

<Note>归档格式仅适用于 Enterprise 方案。</Note>
<Note>压缩归档格式仅适用于企业版方案（启用认证时除外）。</Note>

- `.zip`
- `.rar`
Expand Down
43 changes: 21 additions & 22 deletions zh/create/reusable-snippets.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,42 +1,41 @@
---
title: '可复用片段'
description: '可复用的自定义片段，帮助内容保持一致'
title: "可复用片段"
description: "通过可复用的自定义片段保持内容一致"
---

软件开发的核心原则之一是 DRY（Don&#39;t Repeat Yourself，勿重复），这同样适用于文档。如果你发现自己在多个位置重复相同的内容，建议创建自定义片段，以保持内容一致。
软件开发的核心原则之一是 DRY（不要重复自己），这一点同样适用于文档。如果你发现自己在多个位置重复相同的内容，应创建自定义片段，以保持内容一致。

<div id="creating-a-custom-snippet">
## 创建自定义代码片段
## 创建自定义片段
</div>

**前置条件**：必须在 `snippets` 目录下创建片段文件，导入才能生效。
**前置条件**：必须在 `snippets` 目录中创建片段文件，导入才能生效。

位于 `snippets` 目录中的任何页面都会被视为片段，不会渲染为独立页面。若要从该片段创建独立页面，请将其导入到另一个文件中，并以组件的方式调用。
`snippets` 目录中的任何页面都会被视为片段，不会渲染为独立页面。若要将该片段作为独立页面，请将其导入到另一个文件中，并以组件的形式调用。

<div id="default-export">
### 默认导出
</div>

1. 在代码片段文件中添加你希望复用的内容。你还可以选择添加变量，并在导入该片段时通过 props 进行填充。
在此示例中，我们的变量是 word。
1. 在你的代码片段文件中添加你想要复用的对象。

```typescript snippets/my-snippet.mdx
你好世界！这是我想要在页面间重复使用的内容。
你好,世界!这是我想在多个页面中重复使用的内容。
```

2. 将该代码片段导入到目标文件中。

```typescript destination-file.mdx
---
title: 我的标题
description: 我的描述
description: 我的说明
---

import MySnippet from '/snippets/path/to/my-snippet.mdx';

## 标题

Lorem ipsum dolor sit amet.
Lorem impsum dolor sit amet.

<MySnippet/>

Expand Down Expand Up @@ -74,15 +73,15 @@ Lorem ipsum dolor sit amet.
### 可复用变量
</div>

1. 从片段文件中导出一个变量：
1. 从你的代码片段（snippet）文件中导出一个变量：

```typescript snippets/path/to/custom-variables.mdx
export const myName = '我的名字';
export const myName = "我的名字";

export const myObject = { fruit: '草莓' };
export const myObject = { fruit: "草莓" };
```

2. 从目标文件中导入该代码片段，并使用该变量：
2. 从目标文件中导入该代码片段并使用该变量：

```typescript destination-file.mdx
---
Expand All @@ -92,30 +91,30 @@ description: 我的说明

import { myName, myObject } from '/snippets/path/to/custom-variables.mdx';

你好，我的名字是 {myName}，我喜欢 {myObject.fruit}。
你好,我的名字是 {myName},我喜欢 {myObject.fruit}。
```

<div id="jsx-snippets">
### JSX 代码片段
</div>

1. 从代码片段文件中导出一个 JSX 组件。（更多信息请参见 [React 组件](/zh/customize/react-components)）
1. 从片段文件中导出一个 JSX 组件。（有关更多信息，参见 [React 组件](/zh/customize/react-components)：）

```js icon=square-js snippets/my-jsx-snippet.jsx
export const MyJSXSnippet = () => {
return (
<div>
<h1>你好，世界！</h1>
<h1>你好,世界!</h1>
</div>
)
}
);
};
```

<Note>
重要：创建 JSX 代码片段时，请使用箭头函数语法（`=>`），不要使用函数声明。此处不支持 `function` 关键字。
重要：创建 JSX 代码片段时，请使用箭头函数语法（`=>`），而不要使用函数声明。在此上下文中不支持 `function` 关键字。
</Note>

2. 从目标文件中导入该片段并使用该组件：
2. 从目标文件中导入该代码片段并使用该组件：

```typescript destination-file.mdx
---
Expand Down