Skip to content

Commit d89b3ca

Browse files
docs(locadex): update translations (#1912)
Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>
1 parent 6f0cf51 commit d89b3ca

File tree

4 files changed

+623
-630
lines changed

4 files changed

+623
-630
lines changed

es/deploy/ci.mdx

Lines changed: 51 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -45,37 +45,38 @@ Para ver los resultados de esta verificación, visita la página de resultados d
4545
### Vale
4646
</div>
4747

48-
[Vale](https://vale.sh/) es un linter de prosa de código abierto basado en reglas que admite una variedad de tipos de documentos, incluidos Markdown y MDX.
48+
[Vale](https://vale.sh/) es un linter de prosa de código abierto basado en reglas que admite una variedad de tipos de documentos, incluidos Markdown y MDX. Usa Vale para comprobar la coherencia del estilo y el tono en tu documentación.
4949

50-
Mintlify permite ejecutar Vale automáticamente en una verificación de CI y mostrar los resultados como un estado de comprobación.
50+
Mintlify admite ejecutar Vale automáticamente en una comprobación de CI y mostrar los resultados como un estado de comprobación.
5151

5252
<div id="configuration">
5353
#### Configuración
5454
</div>
5555

56-
Si tienes un archivo `.vale.ini` en el directorio raíz de contenido de tu implementación, la verificación de Vale CI utiliza ese archivo de configuración y cualquier archivo de configuración en el `stylesPath` que especifiques.
56+
Si tienes un archivo `.vale.ini` en el directorio raíz de contenido de tu implementación, la verificación de Vale CI usa ese archivo de configuración y cualquier archivo de configuración en el `stylesPath` que especifiques.
5757

5858
Si no tienes un archivo de configuración de Vale, se cargará automáticamente la configuración predeterminada.
5959

6060
```mdx Default vale.ini configuration expandable
6161
# Estilos de nivel superior
6262
StylesPath = /app/styles
6363
MinAlertLevel = suggestion
64+
# Etiquetas HTML en línea a ignorar (code/tt para fragmentos de código, img/url para enlaces/imágenes, a para etiquetas ancla)
6465
IgnoredScopes = code, tt, img, url, a
65-
SkippedScopes = script, style, pre, figure, code
66+
SkippedScopes = script, style, pre, figure
6667

6768
# Vocabularios
6869
Vocab = Mintlify
6970

70-
# Esto es necesario ya que Vale no soporta oficialmente MDX
71-
[formats]
72-
mdx = md
71+
# Paquetes
72+
Packages = MDX
7373

74-
# Soporte para MDX
74+
# Coincidir solo con MDX
7575
[*.mdx]
7676
BasedOnStyles = Vale
7777
Vale.Terms = NO # Aplica reglas de mayúsculas muy estrictas, mantener desactivado
7878

79+
# Ignorar patrones de sintaxis específicos de JSX/MDX
7980
# `import ...`, `export ...`
8081
# `<Component ... />`
8182
# `<Component>...</Component>`
@@ -84,14 +85,14 @@ TokenIgnores = (?sm)((?:import|export) .+?$), \
8485
(?<!`)(<\w+ ?.+ ?\/>)(?!`), \
8586
(<[A-Z]\w+>.+?<\/[A-Z]\w+>)
8687

87-
# Excluir:
88+
# Excluir JSX multilínea y llaves
8889
# `<Component \n ... />`
8990
BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
9091
(?sm)^({.+.*})
91-
92-
CommentDelimiters = {/*, */}
9392
```
9493

94+
El vocabulario predeterminado de Vale incluye las siguientes palabras.
95+
9596
```text Default Vale vocabulary expandable
9697
Mintlify
9798
mintlify
@@ -362,64 +363,67 @@ next
362363
toc
363364
```
364365

366+
Para agregar tu propio vocabulario a la configuración predeterminada, crea un directorio `styles/config/vocabularies/Mintlify` con los archivos `accept.txt` y `reject.txt`.
367+
368+
* `accept.txt`: Palabras que deben ser ignoradas por el linter Vale. Por ejemplo, nombres de productos o términos poco comunes.
369+
* `reject.txt`: Palabras que deben marcarse como errores. Por ejemplo, jerga o palabras que no son apropiadas para el tono de tu documentación.
370+
365371
```text Example Vale file structure
366-
- docs.json
367-
- .vale.ini
368-
- styles/...
369-
- text.md
372+
/your-project
373+
|- docs.json
374+
|- .vale.ini
375+
|- styles/
376+
|- config/
377+
|- vocabularies/
378+
|- Mintlify/
379+
|- accept.txt
380+
|- reject.txt
381+
|- example-page.mdx
370382
```
371383

372384
```text Example monorepo Vale file structure
373-
- main.ts
374-
- docs/
375-
- docs.json
376-
- .vale.ini
377-
- styles/...
378-
- text.md
379-
- test/
385+
/your-monorepo
386+
|- main.ts
387+
|- docs/
388+
|- docs.json
389+
|- .vale.ini
390+
|- styles/
391+
|- config/
392+
|- vocabularies/
393+
|- Mintlify/
394+
|- accept.txt
395+
|- reject.txt
396+
|- example-page.mdx
397+
|- test/
380398
```
381399

382400
<Note>
383-
Ten en cuenta que, por razones de seguridad, no se admiten `stylesPath` absolutos ni `stylesPath` que incluyan `..`. Usa rutas relativas e incluye el `stylesPath` en tu repositorio.
401+
Por razones de seguridad, no se admite el uso de un `stylesPath` absoluto ni de un `stylesPath` que incluya `..`.
402+
403+
Usa rutas relativas e incluye el `stylesPath` en tu repositorio.
384404
</Note>
385405

386406
<div id="packages">
387407
#### Paquetes
388408
</div>
389409

390-
Vale admite una variedad de [paquetes](https://vale.sh/docs/keys/packages) que se pueden usar para detectar errores ortográficos y de estilo.
391-
Cualquier paquete que incluyas en tu repositorio dentro del `stylesPath` correcto se instalará automáticamente y se usará en tu configuración de Vale.
410+
Vale es compatible con una variedad de [paquetes](https://vale.sh/docs/keys/packages), que puedes usar para detectar errores ortográficos y de estilo. Cualquier paquete que incluyas en tu repositorio bajo el `stylesPath` correcto se instala automáticamente y se utiliza en tu configuración de Vale.
392411

393-
Para los paquetes que no estén incluidos en tu repositorio, puedes especificar cualquiera del [registro de paquetes de Vale](https://vale.sh/explorer); se descargarán automáticamente y se usarán en tu configuración de Vale.
412+
Para los paquetes que no estén incluidos en tu repositorio, puedes especificar cualquiera del [registro de paquetes de Vale](https://vale.sh/explorer); se descargarán automáticamente y se utilizarán en tu configuración de Vale.
394413

395414
<Note>
396-
Ten en cuenta que, por razones de seguridad, no se admite la descarga automática de paquetes que no provengan del [registro de paquetes de Vale](https://vale.sh/explorer).
415+
Por motivos de seguridad, **no** se admite la descarga automática de paquetes que no provengan del [registro de paquetes de Vale](https://vale.sh/explorer).
397416
</Note>
398417

399418
<div id="vale-with-mdx">
400419
#### Vale con `MDX`
401420
</div>
402421

403-
Vale no admite `MDX` de forma nativa, pero el autor de Vale ha proporcionado una [extensión personalizada](https://github.com/errata-ai/MDX) para darle soporte.
404-
405-
Si prefieres no usar esta extensión, puedes agregar las siguientes líneas al archivo `.vale.ini` configurado:
406-
407-
```ini
408-
[formats]
409-
mdx = md
410-
411-
[*.mdx]
412-
CommentDelimiters = {/*, */}
413-
414-
TokenIgnores = (?sm)((?:import|export) .+?$), \
415-
(?<!`)(<\w+ ?.+ ?\/>)(?!`), \
416-
(<[A-Z]\w+>.+?<\/[A-Z]\w+>)
417-
418-
BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
419-
(?sm)^({.+.*})
420-
```
422+
<Note>
423+
La compatibilidad nativa con MDX requiere Vale 3.10.0 o posterior. Comprueba tu versión de Vale con `vale --version`.
424+
</Note>
421425

422-
Para usar los comentarios en el documento de Vale, utiliza comentarios con estilo MDX `{/* ... */}`. Si en tu configuración usas el [ajuste](https://vale.sh/docs/keys/commentdelimiters) `CommentDelimiters = {/*, */}`, Vale interpretará automáticamente estos comentarios durante el análisis. Esto significa que puedes aprovechar fácilmente las funciones integradas de Vale, como omitir líneas o secciones.
426+
Para usar los comentarios dentro del documento de Vale en archivos MDX, utiliza comentarios al estilo MDX `{/* ... */}`:
423427

424428
```mdx
425429
{/* vale off */}
@@ -429,14 +433,4 @@ Este texto es ignorado por Vale
429433
{/* vale on */}
430434
```
431435

432-
Si decides no usar `CommentDelimiters` pero aun así usar los comentarios de Vale, debes envolver cualquier comentario de Vale en comentarios de MDX `{/* ... */}`. Por ejemplo:
433-
434-
```mdx
435-
{/* <!-- vale off --> */}
436-
437-
Este texto es ignorado por Vale
438-
439-
{/* <!-- vale on --> */}
440-
```
441-
442-
Estas etiquetas de comentario no son compatibles dentro de los componentes de Mintlify, pero funcionan correctamente en cualquier lugar del nivel base de un documento.
436+
Vale reconoce y respeta automáticamente estos comentarios en los archivos MDX sin necesidad de configuración adicional. Usa los comentarios para omitir líneas o secciones que el linter deba ignorar.

fr/deploy/ci.mdx

Lines changed: 52 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -45,37 +45,38 @@ Pour consulter les résultats de cette vérification, rendez-vous sur la page de
4545
### Vale
4646
</div>
4747

48-
[Vale](https://vale.sh/) est un linter de prose open source basé sur des règles, compatible avec divers types de documents, dont Markdown et MDX.
48+
[Vale](https://vale.sh/) est un linter de prose open source basé sur des règles qui prend en charge un large éventail de types de documents, y compris Markdown et MDX. Utilisez Vale pour vérifier la cohérence du style et du ton de votre documentation.
4949

50-
Mintlify prend en charge l’exécution automatique de Vale dans une vérification CI et l’affichage des résultats sous forme d’état de vérification.
50+
Mintlify permet d’exécuter automatiquement Vale dans un contrôle CI et d’afficher les résultats comme statut de contrôle.
5151

5252
<div id="configuration">
5353
#### Configuration
5454
</div>
5555

56-
Si vous avez un fichier `.vale.ini` à la racine du répertoire content de votre déploiement, le contrôle Vale CI utilise ce fichier de configuration ainsi que tout fichier de configuration présent dans le `stylesPath` que vous avez spécifié.
56+
Si vous avez un fichier `.vale.ini` à la racine du répertoire de contenu de votre déploiement, la vérification Vale CI utilise ce fichier de configuration ainsi que tous les fichiers de configuration présents dans le `stylesPath` que vous avez spécifié.
5757

58-
Si vous n’avez pas de fichier de configuration Vale, la configuration par défaut est chargée automatiquement.
58+
Si vous n’avez pas de fichier de configuration Vale, la configuration par défaut est automatiquement chargée.
5959

6060
```mdx Default vale.ini configuration expandable
6161
# Styles de niveau supérieur
6262
StylesPath = /app/styles
6363
MinAlertLevel = suggestion
64+
# Balises HTML en ligne à ignorer (code/tt pour les extraits de code, img/url pour les liens/images, a pour les balises d'ancrage)
6465
IgnoredScopes = code, tt, img, url, a
65-
SkippedScopes = script, style, pre, figure, code
66+
SkippedScopes = script, style, pre, figure
6667

6768
# Vocabulaires
6869
Vocab = Mintlify
6970

70-
# Requis car Vale ne prend pas officiellement en charge MDX
71-
[formats]
72-
mdx = md
71+
# Packages
72+
Packages = MDX
7373

74-
# Prise en charge de MDX
74+
# Correspondre uniquement aux fichiers MDX
7575
[*.mdx]
7676
BasedOnStyles = Vale
7777
Vale.Terms = NO # Applique des règles de capitalisation très strictes, laisser désactivé
7878

79+
# Ignorer les motifs de syntaxe spécifiques à JSX/MDX
7980
# `import ...`, `export ...`
8081
# `<Component ... />`
8182
# `<Component>...</Component>`
@@ -84,14 +85,14 @@ TokenIgnores = (?sm)((?:import|export) .+?$), \
8485
(?<!`)(<\w+ ?.+ ?\/>)(?!`), \
8586
(<[A-Z]\w+>.+?<\/[A-Z]\w+>)
8687

87-
# Exclure :
88+
# Exclure le JSX multiligne et les accolades
8889
# `<Component \n ... />`
8990
BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
9091
(?sm)^({.+.*})
91-
92-
CommentDelimiters = {/*, */}
9392
```
9493

94+
Le vocabulaire par défaut de Vale comprend les mots suivants.
95+
9596
```text Default Vale vocabulary expandable
9697
Mintlify
9798
mintlify
@@ -362,64 +363,67 @@ next
362363
toc
363364
```
364365

366+
Pour ajouter votre propre vocabulaire à la configuration par défaut, créez un répertoire `styles/config/vocabularies/Mintlify` contenant les fichiers `accept.txt` et `reject.txt`.
367+
368+
* `accept.txt` : Mots à ignorer par le linter Vale. Par exemple, des noms de produits ou des termes peu courants.
369+
* `reject.txt` : Mots qui doivent être signalés comme des erreurs. Par exemple, du jargon ou des mots qui ne sont pas appropriés au ton de votre documentation.
370+
365371
```text Example Vale file structure
366-
- docs.json
367-
- .vale.ini
368-
- styles/...
369-
- text.md
372+
/votre-projet
373+
|- docs.json
374+
|- .vale.ini
375+
|- styles/
376+
|- config/
377+
|- vocabularies/
378+
|- Mintlify/
379+
|- accept.txt
380+
|- reject.txt
381+
|- page-exemple.mdx
370382
```
371383

372384
```text Example monorepo Vale file structure
373-
- main.ts
374-
- docs/
375-
- docs.json
376-
- .vale.ini
377-
- styles/...
378-
- text.md
379-
- test/
385+
/your-monorepo
386+
|- main.ts
387+
|- docs/
388+
|- docs.json
389+
|- .vale.ini
390+
|- styles/
391+
|- config/
392+
|- vocabularies/
393+
|- Mintlify/
394+
|- accept.txt
395+
|- reject.txt
396+
|- example-page.mdx
397+
|- test/
380398
```
381399

382400
<Note>
383-
Pour des raisons de sécurité, les `stylesPath` absolus ou contenant `..` ne sont pas pris en charge. Utilisez des chemins relatifs et incluez le `stylesPath` dans votre référentiel.
401+
Pour des raisons de sécurité, les `stylesPath` absolus ou les `stylesPath` contenant `..` ne sont pas pris en charge.
402+
403+
Utilisez des chemins relatifs et incluez le `stylesPath` dans votre référentiel.
384404
</Note>
385405

386406
<div id="packages">
387407
#### Packages
388408
</div>
389409

390-
Vale prend en charge un éventail de [packages](https://vale.sh/docs/keys/packages), qui peuvent être utilisés pour détecter les fautes d’orthographe et les erreurs de style.
391-
Tous les packages que vous incluez dans votre référentiel sous le `stylesPath` approprié sont automatiquement installés et pris en compte dans votre configuration Vale.
410+
Vale prend en charge une gamme de [packages](https://vale.sh/docs/keys/packages), qui peuvent être utilisés pour détecter les fautes d’orthographe et les erreurs de style. Tous les packages que vous ajoutez à votre référentiel sous le `stylesPath` approprié sont automatiquement installés et utilisés dans votre configuration Vale.
392411

393-
Pour les packages qui ne figurent pas dans votre référentiel, vous pouvez spécifier n’importe quels packages depuis le [registre de packages Vale](https://vale.sh/explorer) ; ils sont alors automatiquement téléchargés et utilisés dans votre configuration Vale.
412+
Pour les packages qui ne sont pas inclus dans votre référentiel, vous pouvez spécifier n’importe quel package du [registre de packages Vale](https://vale.sh/explorer), qui sera automatiquement téléchargé et utilisé dans votre configuration Vale.
394413

395414
<Note>
396-
Veuillez noter que, pour des raisons de sécurité, le téléchargement automatique de packages ne provenant pas du [registre de packages Vale](https://vale.sh/explorer) n’est pas pris en charge.
415+
Pour des raisons de sécurité, le téléchargement automatique de packages qui ne proviennent pas du [registre de packages Vale](https://vale.sh/explorer) n’est **pas** pris en charge.
397416
</Note>
398417

399418
<div id="vale-with-mdx">
400419
#### Vale avec `MDX`
401420
</div>
402421

403-
Vale ne prend pas en charge `MDX` nativement, mais l’auteur de Vale a fourni une [extension personnalisée](https://github.com/errata-ai/MDX) pour l’ajouter.
404-
405-
Si vous préférez ne pas utiliser cette extension, vous pouvez ajouter les lignes suivantes au fichier `.vale.ini` configuré :
406-
407-
```ini
408-
[formats]
409-
mdx = md
410-
411-
[*.mdx]
412-
CommentDelimiters = {/*, */}
413-
414-
TokenIgnores = (?sm)((?:import|export) .+?$), \
415-
(?<!`)(<\w+ ?.+ ?\/>)(?!`), \
416-
(<[A-Z]\w+>.+?<\/[A-Z]\w+>)
417-
418-
BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
419-
(?sm)^({.+.*})
420-
```
422+
<Note>
423+
La prise en charge native de MDX nécessite Vale 3.10.0 ou une version ultérieure. Vérifiez votre version de Vale avec `vale --version`.
424+
</Note>
421425

422-
Pour utiliser les commentaires dans le document de Vale, utilisez des commentaires au format MDX `{/* ... */}`. Si vous utilisez le [paramètre](https://vale.sh/docs/keys/commentdelimiters) `CommentDelimiters = {/*, */}` dans votre configuration, Vale interprétera automatiquement ces commentaires lors de l’analyse. Cela signifie que vous pouvez facilement utiliser les fonctionnalités intégrées de Vale, comme ignorer des lignes ou des sections.
426+
Pour utiliser les commentaires intégrés de Vale dans les fichiers MDX, utilisez les commentaires au format MDX `{/* ... */}` :
423427

424428
```mdx
425429
{/* vale off */}
@@ -429,14 +433,4 @@ Ce texte est ignoré par Vale
429433
{/* vale on */}
430434
```
431435

432-
Si vous choisissez de ne pas utiliser `CommentDelimiters` tout en utilisant les commentaires de Vale, vous devez entourer tous les commentaires de Vale de commentaires MDX `{/* ... */}`. Par exemple :
433-
434-
```mdx
435-
{/* <!-- vale off --> */}
436-
437-
Ce texte est ignoré par Vale
438-
439-
{/* <!-- vale on --> */}
440-
```
441-
442-
Ces balises de commentaire ne sont pas prises en charge dans les composants Mintlify, mais elles fonctionneront correctement partout au niveau de base d’un document.
436+
Vale reconnaît et respecte automatiquement ces commentaires dans les fichiers MDX sans configuration supplémentaire. Utilisez les commentaires pour ignorer les lignes ou sections qui doivent être ignorées par le linter.

0 commit comments

Comments
 (0)