Skip to content

Commit a376618

Browse files
locadex-agent[bot]locadex-agent[bot]
authored
docs(locadex): add translations (#2385)
Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>
1 parent e676798 commit a376618

File tree

13 files changed

+991
-711
lines changed

13 files changed

+991
-711
lines changed

‎es/create/reusable-snippets.mdx‎

Lines changed: 113 additions & 78 deletions
Original file line numberDiff line numberDiff line change
@@ -4,134 +4,169 @@ description: "Crea fragmentos reutilizables para mantener la coherencia entre p
44
keywords: ["content snippets", "reusable content", "variables"]
55
---
66

7-
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 mantenerlo sincronizado.
7+
Uno de los principios fundamentales del desarrollo de software es DRY (Don&#39;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 ese contenido. Los fragmentos incluyen contenido que puedes importar en otros archivos para reutilizarlo. Tú controlas dónde aparece el fragmento en una página. Si alguna vez necesitas actualizar el contenido, solo tendrás que editar el fragmento en lugar de cada archivo donde se use.
88

9-
<div id="creating-a-custom-snippet">
10-
## Creación de un snippet personalizado
9+
Los fragmentos no se renderizan como páginas independientes. Debes importarlos en otros archivos.
10+
11+
<div id="configure-snippet-folders">
12+
## Configurar carpetas de snippets
13+
</div>
14+
15+
De forma predeterminada, cualquier archivo en una carpeta llamada `snippets` se considera un snippet. Puedes configurar carpetas personalizadas adicionales para que contengan snippets con el campo `snippets` en tu `docs.json`.
16+
17+
Añade [patrones glob](https://code.visualstudio.com/docs/editor/glob-patterns) al array `snippets` en `docs.json` para especificar qué carpetas contienen snippets.
18+
19+
```json docs.json
20+
{
21+
"snippets": [
22+
"components/**",
23+
"shared/reusable/**",
24+
"shared/common-component.mdx"
25+
]
26+
}
27+
```
28+
29+
<div id="create-snippets">
30+
## Crear snippets
1131
</div>
1232

13-
**Requisito previo**: Debes crear el archivo del snippet en el directorio `snippets` para que la importación funcione.
33+
Crea un archivo en una carpeta de snippets con el contenido que quieras reutilizar. Los snippets pueden contener todos los tipos de contenido compatibles con Mintlify y pueden importar otros snippets.
34+
35+
<div id="import-snippets-into-pages">
36+
## Importar fragmentos en páginas
37+
</div>
38+
39+
Para usar fragmentos, impórtalos en las páginas usando una ruta absoluta o relativa.
40+
41+
* **Importaciones absolutas**: Comienzan con `/snippets/` o con tu ubicación personalizada para fragmentos, para importaciones desde la raíz de tu proyecto.
42+
* **Importaciones relativas**: Usa `./` o `../` para importar fragmentos en relación con la ubicación del archivo actual.
1443

1544
<Tip>
16-
Los snippets admiten tanto importaciones absolutas (que comienzan con `/snippets/`) como
17-
importaciones relativas (que comienzan con `./` o `../`).
45+
Las importaciones relativas habilitan la navegación en el IDE. Pulsa <kbd>CMD</kbd> y haz clic en el nombre de un fragmento en tu editor para ir directamente a su definición.
1846
</Tip>
1947

20-
Cualquier página en el directorio `snippets` se tratará como un snippet y no se
21-
renderizará como una página independiente. Si deseas crear una página independiente
22-
a partir del snippet, importa el snippet en otro archivo y utilízalo como un
23-
componente.
24-
25-
<div id="default-export">
26-
### Exportación predeterminada
48+
<div id="import-text">
49+
### Importar texto
2750
</div>
2851

29-
1. Agrega contenido al archivo de fragmento que quieras reutilizar.
52+
1. Añade al archivo de fragmento el contenido que quieras reutilizar.
3053

31-
```typescript snippets/my-snippet.mdx
32-
¡Hola mundo! Este es mi contenido que quiero reutilizar en varias páginas.
54+
```mdx snippets/my-snippet.mdx
55+
Hello world! This is my content I want to reuse across pages.
3356
```
3457

35-
2. Importa el fragmento en tu archivo de destino.
58+
2. Importa el snippet en tu archivo de destino utilizando una ruta absoluta o relativa.
3659

37-
```typescript destination-file.mdx
38-
---
39-
title: Mi título
40-
description: Mi descripción
41-
---
60+
<CodeGroup>
61+
```mdx Importación absoluta
62+
---
63+
title: "Una página de ejemplo"
64+
description: "Esta es una página de ejemplo que importa un snippet."
65+
---
4266

43-
import MySnippet from '/snippets/path/to/my-snippet.mdx';
67+
import MySnippet from '/snippets/my-snippet.mdx';
4468

45-
## Encabezado
69+
El contenido del snippet aparece debajo de esta frase.
4670

47-
Lorem impsum dolor sit amet.
71+
<MySnippet/>
72+
```
4873

49-
<MySnippet/>
74+
```mdx Importación relativa
75+
---
76+
title: "Una página de ejemplo"
77+
description: "Esta es una página de ejemplo que importa un snippet."
78+
---
5079

51-
```
80+
import MySnippet from '../snippets/my-snippet.mdx';
5281

53-
<div id="exporting-with-variables">
54-
### Exportación con variables
55-
</div>
82+
El contenido del snippet aparece debajo de esta frase.
5683

57-
1. Opcionalmente, puedes añadir variables que se puedan completar mediante props cuando importes el fragmento. En este ejemplo, nuestra variable es word.
84+
<MySnippet/>
85+
```
86+
</CodeGroup>
5887

59-
```typescript snippets/my-snippet.mdx
60-
Mi palabra clave del día es {word}.
61-
```
88+
<div id="import-variables">
89+
### Importar variables
90+
</div>
6291

63-
2. Importa el fragmento en tu archivo de destino con la variable. La propiedad se completará según tu configuración.
92+
Haz referencia a variables de un fragmento en una página.
6493

65-
```typescript destination-file.mdx
66-
---
67-
title: Mi título
68-
description: Mi descripción
69-
---
94+
1. Exporta variables desde un archivo de fragmento.
7095

71-
import MySnippet from '/snippets/path/to/my-snippet.mdx';
96+
```mdx snippets/custom-variables.mdx
97+
export const myName = "Ronan";
7298

73-
## Encabezado
99+
export const myObject = { fruit: "fresas" };
100+
```
74101

75-
Lorem ipsum dolor sit amet.
102+
2. Importa el fragmento desde tu archivo de destino y usa la variable.
76103

77-
<MySnippet word="bananas" />
104+
```mdx destination-file.mdx
105+
---
106+
title: "Una página de ejemplo"
107+
description: "Esta es una página de ejemplo que importa un fragmento con variables."
108+
---
78109

110+
import { myName, myObject } from '/snippets/custom-variables.mdx';
111+
112+
Hello, my name is {myName} and I like {myObject.fruit}.
79113
```
80114

81-
<div id="reusable-variables">
82-
### Variables reutilizables
115+
<div id="import-snippets-with-variables">
116+
### Importar fragmentos con variables
83117
</div>
84118

85-
1. Exporta una variable desde tu archivo de fragmento:
119+
Usa variables para pasar datos a un fragmento cuando lo importes.
86120

87-
```typescript snippets/path/to/custom-variables.mdx
88-
export const myName = "mi nombre";
121+
1. Añade variables a tu fragmento y pásales propiedades cuando lo importes. En este ejemplo, la variable es `{word}`.
89122

90-
export const myObject = { fruit: "fresas" };
123+
```mdx snippets/my-snippet.mdx
124+
Mi palabra clave del día es {word}.
91125
```
92126

93-
2. Importa el fragmento desde tu archivo de destino y usa la variable:
127+
2. Importa el fragmento en tu archivo de destino con la variable. La propiedad pasada reemplaza la variable en la definición del fragmento.
94128

95-
```typescript destination-file.mdx
96-
---
97-
title: Mi título
98-
description: Mi descripción
99-
---
129+
```mdx destination-file.mdx
130+
---
131+
title: "Una página de ejemplo"
132+
description: "Esta es una página de ejemplo que importa un fragmento con una variable."
133+
---
100134

101-
import { myName, myObject } from '/snippets/path/to/custom-variables.mdx';
135+
import MySnippet from '/snippets/my-snippet.mdx';
136+
137+
<MySnippet word="bananas" />
102138

103-
Hola, mi nombre es {myName} y me gusta {myObject.fruit}.
104139
```
105140

106-
<div id="jsx-snippets">
107-
### Fragmentos de JSX
141+
<div id="import-react-components">
142+
### Importar componentes de React
108143
</div>
109144

110-
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):
145+
1. Crea un fragmento con un componente JSX. Consulta [Componentes de React](/es/customize/react-components) para obtener más información.
111146

112-
```js icon=square-js snippets/my-jsx-snippet.jsx
113-
export const MyJSXSnippet = () => {
114-
return (
115-
<div>
116-
<h1>¡Hola, mundo!</h1>
117-
</div>
118-
);
119-
};
147+
```js snippets/my-jsx-snippet.jsx
148+
export const MyJSXSnippet = () => {
149+
return (
150+
<div>
151+
<h1>¡Hola, mundo!</h1>
152+
</div>
153+
);
154+
};
120155
```
121156

122157
<Note>
123-
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.
158+
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 los fragmentos.
124159
</Note>
125160

126-
2. Importa el fragmento desde tu archivo de destino y usa el componente:
161+
2. Importa el fragmento.
127162

128-
```typescript destination-file.mdx
129-
---
130-
title: Mi título
131-
description: Mi descripción
132-
---
163+
```mdx destination-file.mdx
164+
---
165+
title: "Una página de ejemplo"
166+
description: "Esta es una página de ejemplo que importa un fragmento con un componente de React."
167+
---
133168

134-
import { MyJSXSnippet } from '/snippets/my-jsx-snippet.jsx';
169+
import { MyJSXSnippet } from '/snippets/my-jsx-snippet.jsx';
135170

136-
<MyJSXSnippet />
171+
<MyJSXSnippet />
137172
```

‎es/customize/react-components.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ El contador se representa como un componente interactivo de React.
9898
## Importar componentes
9999
</div>
100100

101-
Para importar componentes de React en tus archivos MDX, los archivos de los componentes deben estar ubicados en la carpeta `snippets`. Luego puedes importarlos en cualquier página MDX de tu documentación. Más información sobre [snippets reutilizables](/es/create/reusable-snippets).
101+
Para importar componentes de React en tus archivos MDX, los archivos de los componentes deben estar ubicados en una carpeta de snippets. De forma predeterminada, esta es la carpeta `/snippets/`. Puedes [configurar directorios adicionales](/es/create/reusable-snippets#configure-snippet-folders) para que contengan snippets en tu `docs.json`. Más información sobre [snippets reutilizables](/es/create/reusable-snippets).
102102

103103
### Ejemplo
104104

‎es/editor.mdx‎

Lines changed: 31 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ Así es como normalmente trabajarás en el editor web:
4040
</Step>
4141

4242
<Step title="Publish your changes">
43-
Si estás trabajando en tu rama de implementación, publica tus cambios directamente desde el editor web. En otras branches, crea una solicitud de extracción para revisión antes de publicar.
43+
Publica tus cambios directamente en tu sitio de documentación en producción o crea una solicitud de extracción para revisar los cambios antes de hacer el merge.
4444
</Step>
4545
</Steps>
4646

@@ -200,10 +200,18 @@ Consulta [Formatear texto](/es/create/text) y [Formatear código](/es/create/cod
200200
## Publica tus cambios
201201
</div>
202202

203-
La rama en la que trabajes determina cómo el editor publica tus cambios:
203+
El flujo de publicación del editor depende de la rama en la que trabajes y de las reglas de protección de ramas de tu repositorio.
204204

205-
* **Rama de implementación**: Al publicar, tu sitio en producción se actualiza de inmediato.
206-
* **Otras ramas**: Al publicar, se crea una solicitud de extracción para que puedas revisar los cambios antes de implementarlos en producción.
205+
| Tipo de rama | Protección de rama | Qué ocurre cuando publicas |
206+
| :---------- | :----------------- | :------------------------------ |
207+
| Rama de implementación | Ninguna | Los cambios se fusionan y se publican de inmediato |
208+
| Rama de implementación | Solicitudes de extracción obligatorias | Se crea una solicitud de extracción para revisión |
209+
| Otra rama | Ninguna | Los cambios se fusionan en la rama de implementación y se publican de inmediato |
210+
| Otra rama | Solicitudes de extracción obligatorias | Se crea una solicitud de extracción para revisión |
211+
212+
<Tip>
213+
Configura reglas de protección de ramas en tu proveedor de Git para exigir revisiones de solicitudes de extracción antes de fusionar. Consulta [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) en la documentación de GitHub o [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/) en la documentación de GitLab para obtener más información.
214+
</Tip>
207215

208216
<Frame>
209217
<img src="/images/editor/publish-flow-light.png" alt="El botón Publicar resaltado en el editor web de Mintlify." className="block dark:hidden" />
@@ -269,6 +277,25 @@ Una vez creada tu solicitud de extracción:
269277
4. **Aprobar**: Aprueba la solicitud de extracción cuando estés satisfecho con los cambios.
270278
5. **Fusionar**: Fusiona la solicitud de extracción cuando estés listo para implementar tus cambios en producción.
271279

280+
<div id="share-preview-deployments">
281+
### Compartir implementaciones de vista previa
282+
</div>
283+
284+
Comparte las implementaciones de vista previa con tu equipo para recopilar comentarios antes de publicar los cambios.
285+
286+
1. Haz clic en el botón **Share** en la barra de herramientas del editor.
287+
2. Haz clic en el botón **Preview** para abrir la implementación de vista previa en una nueva pestaña del navegador.
288+
<Frame>
289+
<img src="/images/editor/share-preview-light.png" alt="Panel de compartir vista previa abierto en la barra de herramientas del editor." className="block dark:hidden" />
290+
291+
<img src="/images/editor/share-preview-dark.png" alt="Panel de compartir vista previa abierto en la barra de herramientas del editor." className="hidden dark:block" />
292+
</Frame>
293+
3. Comparte la URL de la vista previa con cualquier persona que necesite revisar tus cambios.
294+
295+
Cuando hagas cambios, la implementación de vista previa se actualizará automáticamente. Es posible que los cambios tarden unos instantes en aparecer.
296+
297+
Las URL de vista previa son de acceso público de forma predeterminada. Cualquiera que tenga el enlace puede ver tu implementación de vista previa. Para restringir el acceso solo a miembros autenticados de tu organización, habilita la autenticación de vista previa en tu [dashboard](https://dashboard.mintlify.com/products/addons).
298+
272299
<div id="keyboard-shortcuts">
273300
## Atajos de teclado
274301
</div>

‎es/organize/settings.mdx‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -720,6 +720,16 @@ Esta sección contiene la referencia completa del archivo `docs.json`.
720720
</Expandable>
721721
</ResponseField>
722722

723+
<ResponseField name="snippets" type="array of strings">
724+
Especifica carpetas adicionales para fragmentos reutilizables usando [patrones glob](https://code.visualstudio.com/docs/editor/glob-patterns). Cualquier archivo ubicado en carpetas que coincidan con estos patrones se considera un fragmento, además de la carpeta predeterminada `/snippets/`.
725+
726+
```json Ejemplo de configuración de snippets
727+
{
728+
"snippets": ["components/**", "shared/shared-file.mdx"]
729+
}
730+
```
731+
</ResponseField>
732+
723733
<ResponseField name="contextual" type="object">
724734
Menú contextual para contenido e integraciones optimizados con IA.
725735

0 commit comments

Comments
 (0)