diff --git a/es.json b/es.json index 241008091c..64a519cbeb 100644 --- a/es.json +++ b/es.json @@ -65,15 +65,18 @@ "group": "Editor web", "pages": [ "es/editor/index", + "es/editor/tutorial", + "es/editor/git-essentials", "es/editor/pages", "es/editor/media", "es/editor/navigation", - "es/editor/configurations", "es/editor/live-preview", - "es/editor/collaborate", + "es/editor/branching-and-publishing", "es/editor/publish", - "es/editor/keyboard-shortcuts", - "es/editor/settings" + "es/editor/agent", + "es/editor/configurations", + "es/editor/settings", + "es/editor/keyboard-shortcuts" ] }, "es/create/text", diff --git a/es/changelog.mdx b/es/changelog.mdx index 5f344bf2ea..6348612449 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -1114,7 +1114,7 @@ Visualiza el feedback desglosado por páginas individuales en tu dashboard de [a ## Mejoras en el editor web - * Se añadieron [enlaces de vista previa compartibles](/es/editor/collaborate#share-previews) en la barra de herramientas del editor. + * Se añadieron [enlaces de vista previa compartibles](/es/editor/branching-and-publishing#access-and-share-a-preview) en la barra de herramientas del editor. * Se actualizó el [flujo de publicación](/es/editor/publish) para permitir la publicación con un solo clic o la creación de solicitudes de extracción. * Trabajar en el editor web ya no requiere que inicies sesión con GitHub. diff --git a/es/editor/agent.mdx b/es/editor/agent.mdx new file mode 100644 index 0000000000..f2dc6e8b48 --- /dev/null +++ b/es/editor/agent.mdx @@ -0,0 +1,142 @@ +--- +title: "Preguntar al agente" +description: "Use el agente de IA integrado del editor para escribir contenido, editar páginas, buscar en su sitio, subir archivos y configurar ajustes desde una interfaz de chat." +keywords: ["editor", "AI", "assistant", "agent", "chat", "code mode", "file upload"] +--- + +El editor incluye un agente integrado que puede editar páginas, reorganizar la navegación, actualizar `docs.json`, buscar en todo su repositorio y gestionar la configuración del panel. + +El agente del editor realiza los cambios directamente en la branch actual. + +
+ +## Abrir el agente + +
+ +Haga clic en **Ask agent** en la barra de herramientas del editor, o presione Cmd + I (macOS) o Ctrl + I (Windows). + +Para cerrar el panel, haga clic en el botón **X** del encabezado del panel o vuelva a presionar Cmd + I. + +
+ +## Enviar un mensaje + +
+ +Escriba su solicitud en el cuadro de chat en la parte inferior del panel y presione Enter o haga clic en el botón de envío . + +Escriba @ para mencionar una página específica. El agente se centra en esa página al procesar su solicitud. Si no menciona ninguna página, el agente utiliza la página que tiene abierta en ese momento. + +Ejemplos de prompts: + +- `simplify the introduction page` +- `fix all grammar errors across my content` +- `add a new page that explains authentication` +- `rename every mention of "Acme Pro" to "Acme Team" across all pages` +- `update docs.json to add a new group called "Guides"` + +
+ +## Adjuntar archivos + +
+ +Haga clic en el icono del clip en el cuadro de chat, o arrastre y suelte archivos en el panel. El agente lee los archivos adjuntos como contexto para su solicitud. + +Tipos de archivo admitidos: +- **Imágenes**: JPG, PNG, GIF, WebP, SVG +- **Documentos**: PDF +- **Código y texto**: `.js`, `.ts`, `.jsx`, `.tsx`, `.mdx`, `.md`, `.json`, `.yaml`, `.html`, `.css`, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, scripts de shell y más + +Tamaño máximo: 5 MB por archivo. Máximo: 10 archivos por mensaje. + +
+ +## Añadir una selección al agente + +
+ +En modo visual, seleccione texto en una página. Aparece una barra de herramientas flotante sobre la selección. Haga clic en **Add to agent** para enviar el texto seleccionado al agente como contexto. + +
+ +## Revisar lo que cambió el agente + +
+ +A medida que el agente edita sus páginas, aparece un panel **Changed files** en el chat. Expándalo para ver una lista de cada archivo modificado en la sesión. Haga clic en cualquier archivo para abrirlo en la vista de diff y comparar los cambios del agente con el original. + +
+ +## Lo que el agente puede hacer + +
+ +
+ +### Editar páginas + +
+ +El agente puede escribir, reescribir, ampliar y reorganizar contenido en cualquier página. Lee su contenido existente para adaptarse a su estilo y estructura. + +
+ +### Buscar y navegar por su contenido + +
+ +El agente puede buscar en todo su repositorio, no solo en la página que tiene abierta. Úselo para encontrar información, comprobar inconsistencias o verificar que el contenido existe antes de añadirlo. + +
+ +### Actualizar la navegación y docs.json + +
+ +El agente puede añadir, renombrar, reordenar y eliminar elementos de navegación, los mismos cambios que haría manualmente en el panel de navegación. También puede actualizar la configuración de `docs.json` directamente, incluyendo añadir nuevos grupos, ajustar opciones y configurar redirecciones. + +Ejemplo: `add a "Quickstart" group under the Getting Started tab and move the quickstart page into it` + +
+ +### Ejecutar comandos bash + +
+ +El agente puede ejecutar `grep`, `rg` y otros comandos bash sobre su repositorio. Úselo para operaciones masivas que abarquen muchos archivos. + +Ejemplo: `find every page that mentions the deprecated /v1/auth endpoint` + +
+ +### Configurar su sitio (code mode) + +
+ +Para solicitudes que van más allá de editar páginas (configurar autenticación, gestionar workflows o cambiar ajustes de despliegue), el agente cambia a code mode. Escribe y ejecuta un script contra su panel de Mintlify en su nombre. + +Code mode respeta sus permisos del panel. Si no tiene acceso a un ajuste en el panel, el agente tampoco puede cambiarlo. + +Ejemplos de prompts que usan code mode: + +- `enable JWT authentication for my site` +- `create a workflow that updates my site when I merge a PR` +- `add a custom domain` + +
+ +## Historial de sesiones + +
+ +Haga clic en el icono del reloj en el encabezado del panel para ver sus sesiones de chat anteriores. Haga clic en cualquier sesión para volver a abrirla y ver lo que cambió el agente. + +
+ +## Instrucciones de IA + +
+ +Para dar al agente pautas persistentes como reglas de voz, terminología o convenciones de formato, configure las instrucciones de IA en la [configuración del editor](/es/editor/settings#ai-instructions). El agente sigue estas instrucciones en cada solicitud sin que tenga que repetirlas. diff --git a/es/editor/branching-and-publishing.mdx b/es/editor/branching-and-publishing.mdx new file mode 100644 index 0000000000..e19a30a980 --- /dev/null +++ b/es/editor/branching-and-publishing.mdx @@ -0,0 +1,249 @@ +--- +title: "Branches y publicación" +description: "Comprenda cómo las branches y las reglas de protección determinan lo que sucede al publicar, y cómo gestionar el flujo completo de revisión y despliegue." +keywords: ["editor", "branch", "publish", "pull request", "preview", "git", "merge", "deploy"] +--- + +El editor web guarda todo automáticamente mientras escribe, pero sus cambios solo están en producción cuando decide publicarlos. + +Lo que sucede al publicar depende de dos cosas: **en qué branch se encuentre** y **si esa branch requiere pull requests**. + +
+ +## Guardar frente a publicar + +
+ +**Guardar** ocurre automáticamente. Mintlify almacena sus ediciones en sus servidores y las conserva entre pestañas del navegador, dispositivos e interrupciones de red. + +**Publicar** confirma sus cambios en su repositorio de Git. Haga clic en **Publish** en la barra de herramientas para abrir el menú de publicación, guardar sus cambios como un commit de Git y crear una pull request. + +El editor registra lo siguiente como cambios pendientes: + +- Ediciones de contenido en páginas +- Páginas nuevas o eliminadas +- Cambios en la estructura de navegación +- Cargas de medios +- Actualizaciones de configuración + +
+ +## Lo que sucede al publicar + +
+ +Las acciones disponibles al hacer clic en el botón de publicar dependen de la branch actual y de si tiene reglas de protección de branch que exigen pull requests. + +| Tipo de branch | Protección de branch | Acciones disponibles | +|-------------|-------------------|-------------------| +| Deployment branch | Ninguna | **Publish** directamente en su sitio en producción | +| Deployment branch | Se requieren pull requests | **Create branch** para mover los cambios a una nueva branch | +| Feature branch | Ninguna | **Save in branch**, **Create pull request** | +| Feature branch | Se requieren pull requests | **Save in branch**, **Create pull request** | + +- **Publish**: Confirma y despliega sus cambios en su sitio en producción de inmediato. +- **Save in branch**: Confirma sus cambios en la feature branch sin fusionarlos con su deployment branch. +- **Create branch**: Mueve sus cambios pendientes a una nueva feature branch cuando se encuentra en una deployment branch protegida. +- **Create pull request**: Abre una pull request dirigida a su deployment branch. + +Si no hay cambios pendientes, el editor desactiva las acciones de publicar y guardar. + + + Su sitio en producción se actualiza después de que Mintlify compile y despliegue sus cambios. Esto suele tardar de 30 segundos a unos pocos minutos. Compruebe el estado del despliegue en su [panel](https://app.mintlify.com). + + +
+ +## Cuándo usar una branch + +
+ +**Edite directamente en su deployment branch** si no utiliza un flujo de trabajo basado en Git. + +**Cree una branch** cuando utilice un flujo de trabajo basado en branches en el que realiza cada cambio en su contenido en una branch separada. + +
+ +## Crear y cambiar de branch + +
+ +
+ +### Crear una branch + +
+ +1. Haga clic en el nombre de la branch en la barra de herramientas del editor. +1. Haga clic en **Create new branch**. +1. Si tiene cambios pendientes, elija si llevarlos a la nueva branch o dejarlos en la branch actual. +1. Introduzca un nombre y haga clic en **Create branch**. + + + Use nombres descriptivos para las branches de modo que pueda identificarlas fácilmente y otras personas comprendan para qué sirve cada una. + + +
+ +### Cambiar de branch + +
+ +1. Haga clic en el nombre de la branch en la barra de herramientas. +1. Busque o desplácese hasta la branch que desee. +1. Haga clic en la branch para cambiar a ella. + + + Si cambia de branch cuando tiene cambios sin publicar, se le pedirá que lleve esos cambios a la nueva branch o que los deje atrás. Los cambios dejados atrás permanecen en su branch original. + + + + Para copiar el nombre de una branch, pase el cursor sobre la branch en el menú desplegable y haga clic en el icono de copiar. Esto resulta útil al compartir la branch con sus compañeros de equipo o al referenciarla en una pull request. + + +
+ +## Previsualizar sus cambios + +
+ +Cada vez que guarda cambios en una feature branch, Mintlify compila un despliegue de vista previa, una URL temporal donde sus cambios se renderizan exactamente como cuando se publican. + +
+ +### Acceder y compartir una vista previa + +
+ +1. Haga clic en **Publish** en la barra de herramientas del editor. +1. En el menú de publicación, haga clic en la URL de vista previa. El formato de la URL es `organization-branch-name.mintlify.app`. + + URL de vista previa destacada en el menú de publicación. + URL de vista previa destacada en el menú de publicación. + + +Copie la URL y envíela a los revisores. La vista previa se actualiza automáticamente cada vez que guarda en la branch. + +
+ +### Restringir el acceso a las vistas previas + +
+ +Las URLs de vista previa son públicamente accesibles por defecto. Para restringir el acceso a los miembros de su organización en Mintlify, habilite la autenticación de vista previa en la página [Add-ons](https://app.mintlify.com/products/addons) de su panel. + + + +Para invitar a un compañero de equipo a una página específica en una branch, copie la URL de la barra de direcciones de su navegador y compártala. Cualquier persona con acceso a su organización de Mintlify puede abrir el enlace directamente en su sesión del editor. + +El formato de la URL es: + +```text +https://app.mintlify.com/{org}/{project}/editor/{branch}/~/{filepath} +``` + +Por ejemplo: `https://app.mintlify.com/acme/docs/editor/main/~/guides/quickstart.mdx` + +
+ +## Revisar y fusionar pull requests + +
+ +Cuando hay una pull request abierta para la branch actual, el menú de publicación muestra un panel de revisión con: + +- El título y la descripción de la pull request, y si es un borrador. +- Las branches de origen y de destino. +- El número de archivos modificados. +- El requisito de aprobación en la deployment branch: **Approval required**, **Code owner required** o sin requisito. +- El estado actual de la revisión: **Approved**, **Changes requested** o **Awaiting review**. + +Haga clic en **Open in GitHub** o **Open in GitLab** para ver la pull request en su proveedor de Git. + +Después de que un revisor apruebe una pull request, haga clic en **Merge and publish** para fusionar y desplegar directamente desde el editor. El editor cambia a su deployment branch después de fusionar. + +
+ +### Aprobar pull requests desde el editor + +
+ +Para los repositorios de GitHub, los revisores pueden aprobar pull requests abiertas en el editor. Cuando hay una pull request abierta, aparece el botón **Approve pull request** en el panel de revisión si su cuenta tiene permiso para revisarla. Haga clic en **Approve pull request** cuando los cambios estén listos para fusionarse. El estado de la revisión cambia a **Approved** y la acción **Merge and publish** queda disponible. + +La acción de aprobar no está disponible para pull requests en borrador, pull requests que ya ha aprobado o merge requests de GitLab. Haga clic en **Open in GitLab** para aprobar una merge request en GitLab. + + + Configure reglas de protección de branches en su proveedor de Git para exigir pull requests. Consulte [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) en la ayuda de GitHub o [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/) en la ayuda de GitLab. + + +
+ +### Revisar los cambios antes de fusionar + +
+ +Haga clic en cualquier archivo modificado en el menú de publicación para abrirlo en la vista de diff y comparar su branch con la versión publicada. En modo visual verá un diff visual; en modo source verá un diff de texto. Los archivos que no pueden mostrar un diff, como imágenes o archivos eliminados, aparecen en la lista pero no se pueden abrir. + +
+ +### Publicaciones simultáneas + +
+ +Solo puede haber una publicación a la vez por branch. Si otro miembro del equipo publica en la misma branch, espere a que termine la publicación actual antes de volver a intentarlo. + +
+ +### Mensajes de commit + +
+ +Al publicar, puede introducir un mensaje de commit antes de confirmar. Si lo deja en blanco, el editor usa un mensaje predeterminado que enumera los archivos que ha creado, actualizado, movido o eliminado. + +
+ +## Resolver conflictos + +
+ +Los conflictos ocurren cuando su branch y la deployment branch tienen cambios incompatibles en los mismos archivos. Por ejemplo, cuando usted y un compañero de equipo han editado las mismas líneas en un archivo o han movido un archivo a ubicaciones diferentes. + +El editor muestra una advertencia cuando los conflictos bloquean la publicación. Siga las indicaciones para elegir qué versión de cada sección en conflicto conservar. + +
+ +## Colaborar en tiempo real + +
+ +Cuando varias personas abren la misma página en la misma branch, editan juntas en tiempo real. El cursor y las ediciones de cada persona son visibles para todos, con avatares mostrados en la barra de herramientas. + +- Los cambios de todos los colaboradores se fusionan automáticamente. Dos personas editando la misma sección no generarán conflictos. +- Deshacer solo afecta a sus propias ediciones. +- Si pierde la conexión, las ediciones se guardan localmente y se sincronizan cuando se vuelve a conectar. + +Cuando el [agente de Mintlify](/es/agent) edita una página a través de la API o MCP, aparece en el editor como cualquier otro colaborador. Verá el avatar del agente en la barra de herramientas y un cursor en vivo en su edición más reciente. El cursor desaparece automáticamente después de que el agente termina. + +
+ +## Sincronización con Git + +
+ +Cuando alguien envía cambios a su repositorio desde fuera del editor, el editor incorpora esos cambios automáticamente. + +Los cambios que no se solapan se aplican automáticamente. Si un cambio remoto y su edición local afectan a la misma parte de una página, el editor resalta el conflicto para que pueda resolverlo. + +
+ +## Firma de commits + +
+ +Firme commits con su cuenta de GitHub autorizándola en la [configuración de su cuenta](https://app.mintlify.com/settings/account). Sin autorización, la app de GitHub de Mintlify firma los commits realizados en el editor web. + +Para una referencia de cómo las acciones del editor se corresponden con las operaciones de Git, consulte [Conceptos básicos de Git](/es/editor/git-essentials#how-the-editor-maps-to-git). diff --git a/es/editor/collaborate.mdx b/es/editor/collaborate.mdx deleted file mode 100644 index 3d0b42a8ab..0000000000 --- a/es/editor/collaborate.mdx +++ /dev/null @@ -1,125 +0,0 @@ ---- -title: "Colaborar en el editor web" -sidebarTitle: "Colaborar" -description: "Edita la documentación con tu equipo mediante colaboración en tiempo real, cursores en vivo, enlaces compartibles del editor, branches y flujos de revisión con pull requests." -keywords: ["editor", "collaboration", "real-time", "live editing", "branches", "pull requests", "preview deployments", "share links"] ---- - -Colabora con tu equipo en la documentación usando edición en tiempo real y flujos de trabajo basados en branches. - -
- ## Colaboración en tiempo real -
- -Varias personas pueden editar la misma página al mismo tiempo. Los cambios de cada persona aparecen para todos los que están en la página. - -Para colaborar en una página en tiempo real, comparte el enlace del editor de esa página con tus compañeros. Consulta [Compartir enlaces del editor](#share-editor-links) más abajo. - - - Editor web mostrando colaboración en tiempo real con varios cursores - Editor web mostrando colaboración en tiempo real con varios cursores - - -
- ### Cómo funciona la edición en tiempo real -
- -Cuando varios miembros del equipo editan la misma branch, los cambios se sincronizan en tiempo real. Las actualizaciones de contenido de la página, la estructura de navegación y la configuración del sitio aparecen automáticamente para todos los colaboradores sin necesidad de actualizar. - -- El cursor y las ediciones de cada persona son visibles para todos los que están en la página, con los avatares y nombres de los usuarios mostrados en la barra de herramientas. -- Los cambios se fusionan automáticamente. Que dos personas editen la misma sección no provoca conflictos. -- Deshacer solo afecta a tus propios cambios; deshacer no revierte las ediciones de otra persona. -- Si pierdes la conexión de red, tus ediciones se guardan localmente y se sincronizan cuando vuelves a conectarte. - -
- ## Ver las ediciones del agente en tiempo real -
- -Cuando el [agente de Mintlify](/es/agent) edita una página mediante la API o MCP, aparece en el editor web como cualquier otro colaborador. Si tienes la página abierta en la misma branch, verás el avatar y el nombre del agente en la parte superior del editor y un cursor en vivo en la ubicación de su edición más reciente. - -Úsalo para: - -- Ver cómo los cambios del agente se transmiten a la página en tiempo real. -- Saber qué párrafo o bloque acaba de actualizar el agente sin tener que hacer un diff del archivo. -- Coordinarte con tus compañeros y el agente en la misma branch sin sobrescribir el trabajo de los demás. - -El cursor del agente se borra automáticamente poco después de que el agente termina de editar. - -
- ## Colaboración basada en branches -
- -Utiliza branches para trabajar en paralelo en actualizaciones de la documentación sin afectar tu sitio en producción. Si no conoces Git, consulta [Conceptos básicos de Git para el editor web](/es/editor/git-essentials). - -
- ### Por qué usar branches -
- -- **Aislar cambios**: Trabaja en actualizaciones sin afectar tu documentación en producción. -- **Revisar antes de publicar**: Obtén comentarios del equipo antes de publicar los cambios. -- **Trabajo en paralelo**: Varios miembros del equipo pueden trabajar en diferentes branches al mismo tiempo. - - - -Las solicitudes de extracción te permiten proponer cambios y colaborar con tu equipo antes de fusionarlos con tu documentación en producción. Este flujo de trabajo garantiza que tu equipo revise los cambios antes de publicarlos y mantiene un historial claro de actualizaciones. - - - - Crea una solicitud de extracción desde el editor cuando estés listo para publicar tus cambios. Consulta [Branching and publishing](/es/editor/publish) para obtener más información. - - - - Revisa las solicitudes de extracción en tu proveedor de Git como GitHub o GitLab. - - - - Cuando los revisores soliciten cambios, realiza los cambios solicitados en el editor. Los cambios adicionales se envían automáticamente a la solicitud de extracción existente. - - - - Fusiona tu solicitud de extracción cuando se hayan abordado todos los cambios solicitados, los revisores obligatorios la hayan aprobado y se hayan superado todas las comprobaciones automatizadas. - - - -
- ## Implementaciones de vista previa -
- -Las implementaciones de vista previa crean URL temporales donde puedes ver tus cambios antes de que se publiquen. Usa las implementaciones de vista previa para recopilar comentarios sobre tus cambios. - -Cada vez que publicas cambios en una branch, la implementación de vista previa se actualiza automáticamente. - -
- ### Acceder a las implementaciones de vista previa -
- -1. Haz clic en **Publish** en la barra de herramientas del editor. -2. Haz clic en la URL de vista previa para abrir la implementación de vista previa en una pestaña nueva. El formato de la URL es `organization-branch-name.mintlify.app`. - -
- ### Compartir vistas previas -
- -Comparte la URL de la implementación de vista previa con los miembros del equipo para recopilar comentarios. Las vistas previas se actualizan automáticamente cuando publicas cambios adicionales. - -
- ### Autenticación en vista previa -
- -Las URL de vista previa son de acceso público de forma predeterminada. Habilita la autenticación en vista previa en la página de [Add-ons](https://dashboard.mintlify.com/products/addons) de tu dashboard para restringir el acceso a los miembros autenticados de la organización. - - - -Comparte un enlace directo a una página específica del editor con tu equipo. Usa enlaces del editor para colaborar en actualizaciones en tiempo real o para dirigir a tus compañeros a una página específica. - -La URL del editor se actualiza automáticamente a medida que navegas entre páginas. Copia la URL de la barra de direcciones de tu navegador para compartirla con los compañeros que tengan acceso al editor. - -El formato de la URL es: `https://dashboard.mintlify.com/{org}/{project}/editor/{branch}/~/{filepath}` - -Por ejemplo, `https://dashboard.mintlify.com/acme/docs/editor/main/~/guides/quickstart.mdx` abre `quickstart.mdx` en la branch `main`. - -Cualquier persona con acceso a tu organización de Mintlify puede usar el enlace para abrir el archivo directamente en el editor. diff --git a/es/editor/configurations.mdx b/es/editor/configurations.mdx index 7280eb1c8c..e8f92b2ed5 100644 --- a/es/editor/configurations.mdx +++ b/es/editor/configurations.mdx @@ -1,127 +1,213 @@ --- title: "Configuraciones" -description: "Edita los metadatos de las páginas, los elementos de navegación y la configuración multimedia usando las hojas de configuración visuales en la barra lateral del editor web de Mintlify." -keywords: ["editor", "configurations", "settings"] +description: "Edite la marca del sitio, la apariencia, la navegación y los ajustes de funciones desde el panel Configurations en el editor web de Mintlify, con sincronización en tiempo real con el equipo." +keywords: ["editor", "configurations", "settings", "branding", "theme"] boost: 3 --- -Configura la marca, la apariencia y las funcionalidades de tu sitio de documentación desde el panel **Configurations** en el editor web. +Configure la marca, la apariencia y las funciones de su sitio desde el panel **Site configurations** en el editor web. Los cambios de configuración se sincronizan en tiempo real con otros editores en la misma branch, de modo que su equipo siempre ve los ajustes más recientes. - Opciones de Configurations en la barra lateral en modo claro. - - Opciones de Configurations en la barra lateral en modo oscuro. + Menú de Configurations en el editor. + Menú de Configurations en el editor. -
- ## Define la marca de tu sitio +El panel está organizado en secciones que se corresponden con las propiedades de nivel superior de su [`docs.json`](/es/organize/settings). + +
+ +## General +
-Configura la identidad de tu sitio y cómo aparece para los visitantes. +Establezca la identidad de su sitio y cómo aparece para los visitantes. -* **Título de la documentación**: El nombre de tu documentación. Aparece en las pestañas del navegador y en los resultados de búsqueda. -* **Descripción**: Breve resumen de tu documentación. Se utiliza para SEO y los metadatos del sitio. -* **Favicon**: Pequeño icono que aparece en las pestañas del navegador. Carga archivos ICO, PNG, GIF o JPG. -* **Tema**: Elige un [tema](/es/customize/themes) para la apariencia general de tu documentación. +- **Name**: El nombre de su proyecto. Aparece en las pestañas del navegador y en los resultados de búsqueda. +- **Description**: Breve descripción de su proyecto. Se utiliza para SEO y AEO. + +
+ +## Marca -
- ## Personaliza los colores y la apariencia
-Controla la identidad visual y la paleta de colores de tu sitio. +Suba las marcas que identifican su sitio. + +- **Logo**: El logo de su marca. Suba archivos PNG o JPG. Establezca versiones separadas para modo claro y oscuro y una URL opcional al hacer clic. Para usar un logo SVG, añada el archivo a su repositorio y referencie su ruta en su [`docs.json`](/es/organize/settings-appearance#logos). +- **Favicon**: Pequeño icono que aparece en las pestañas del navegador. Suba archivos ICO, PNG, GIF o JPG. Establezca versiones separadas para modo claro y oscuro si es necesario. + +
+ +## Estilo + +
+ +Controle la identidad visual y la paleta de colores de su sitio. + +- **Theme**: Elija un [tema](/es/customize/themes) para la apariencia general de su sitio. +- **Primary color**: El color de acento principal usado en todo su sitio para enlaces, botones y elementos destacados. +- **Light color**: Color de acento usado en modo oscuro. La forma en que los temas lo aplican varía según el tema. +- **Dark color**: Color de acento usado en modo claro. La forma en que los temas lo aplican varía según el tema. +- **Background color**: Colores de fondo personalizados para modo claro y oscuro. +- **Icon library**: Biblioteca de iconos usada para todas las propiedades de iconos. El valor predeterminado es `fontawesome`. +- **Strict appearance**: Bloquea el sitio en un único modo de apariencia y oculta el conmutador de tema. +- **Default appearance**: Indica si su sitio se carga en modo `system`, `light` o `dark` por defecto. +- **Background decoration**: Aplica un estilo visual (`gradient`, `grid` o `windows`) al fondo. +- **Background image**: Imagen de fondo opcional. Establezca una sola imagen o versiones separadas para modo claro y oscuro. -* **Color primario**: El color de acento principal que se usa en todo tu sitio para enlaces, botones y elementos destacados. -* **Color del modo claro**: Variación del color de acento para el modo claro. La forma en que se aplica depende de cada tema. -* **Color del modo oscuro**: Variación del color de acento para el modo oscuro. La forma en que se aplica depende de cada tema. -* **Logo**: El logo de tu marca. Sube archivos PNG o JPG. Puedes establecer logos distintos para los modos claro y oscuro. Para usar un logo SVG, añade el archivo a tu repositorio a través de Git y haz referencia a su ruta en tu configuración de docs.json. -* **Enlace del logo**: Adónde van los usuarios cuando hacen clic en tu logo. Normalmente es tu página de inicio o tu sitio de marketing. -* **Colores de fondo**: Configura colores de fondo personalizados por separado para los modos claro y oscuro. -* **Imagen de fondo**: Añade una imagen de fondo a tu sitio. Sube archivos PNG, GIF o JPG. -* **Decoración de fondo**: Aplica estilos visuales a tu imagen de fondo. -* **Selector de tema**: Muestra u oculta el interruptor de modo claro/oscuro para los usuarios. -* **Tema predeterminado**: Define si tu sitio se carga en modo claro u oscuro de forma predeterminada. +
+ +## Tipografía -
- ## Configurar fuentes personalizadas
-Reemplaza las fuentes predeterminadas con la tipografía de tu marca. +Reemplace las fuentes predeterminadas con la tipografía de su marca. + +- **Font family**: Cualquier familia de [Google Fonts](https://fonts.google.com/) funciona sin configuración adicional. Para una fuente alojada por usted mismo, proporcione una URL de origen y un formato (`woff` o `woff2`). +- **Weight**: Normalmente `400` para regular y `700` para negrita. Las fuentes variables admiten pesos precisos como `550`. +- **Heading font**: Anulación opcional aplicada a todos los encabezados (`h1` a `h6`). +- **Body font**: Anulación opcional aplicada al cuerpo de texto y al resto de la página. -* **Fuente predeterminada**: La familia tipográfica y el peso base para todo el texto. Proporciona una URL de origen y el formato (WOFF o WOFF2). -* **Fuente de encabezados**: Familia tipográfica y peso específicamente para encabezados (h1, h2, etc.). Se configura por separado del cuerpo de texto. -* **Fuente del cuerpo**: Familia tipográfica y peso para el cuerpo de texto y los párrafos. +