{"schemaVersion":1,"title":"Primeros pasos con Docsy","url":"https://appgram.github.io/docsy/versions/current/es/guides/getting-started","markdownUrl":"https://appgram.github.io/docsy/format-md/versions/current/es/guides/getting-started","jsonUrl":"https://appgram.github.io/docsy/agent/pages/versions/current/es/guides/getting-started.json","version":"current","locale":"es","markdown":"# Primeros pasos con Docsy\n\nCrea un portal para personas y agentes, genera un proyecto y toma el control de su código.\n\nWritten by: [nedimf](https://github.com/nedimf), [AppGram](https://appgram.dev)\n\nDocsy es una herramienta de documentación para personas y agentes de programación. Tus lectores consultan guías y referencias de API o SDK en un portal de documentación. Tus agentes pueden leer el mismo contenido en Markdown y ayudarte a mantener los artículos, la configuración YAML y la interfaz Astro.\n\n> Prueba los dos selectores\n>\n> Estás leyendo la traducción al español de la guía actual. Selecciona **Preview (demo)** para abrir un artículo distinto y después **English** o **Français** para cambiar de idioma sin salir de esta página.\n\n## Ejecutar este portal\n\nUsa Node 22.22 o una versión posterior y clona el repositorio:\n\n```bash\ngit clone https://github.com/AppGram/docsy.git\ncd docsy\nnpm ci\nnpm run dev\n```\n\nAbre `http://localhost:4321/docsy/`. Los artículos, la configuración y el código de la interfaz están en tu repositorio.\n\n## Generar un proyecto independiente\n\nEste comando crea un proyecto Astro editable con la interfaz predeterminada y una guía inicial:\n\n```bash\nnpm run create -- ../acme-docs \\\n  --name \"Acme API\" \\\n  --base /docs\n```\n\nSi quieres generar también una referencia de la API, proporciona una especificación OpenAPI:\n\n```bash\nnpm run create -- ../acme-docs \\\n  --name \"Acme API\" \\\n  --openapi https://api.example.com/openapi.json \\\n  --api-base https://api.example.com \\\n  --base /docs\n```\n\n## Organizar el contenido\n\n| Ubicación | Responsabilidad |\n| --- | --- |\n| `docsy.config.yaml` | Identidad, navegación, artículos, fuentes, idiomas, versiones y permisos |\n| `content/` y `sources/` | Artículos Markdown y metadatos de API o SDK |\n| `src/` | Interfaz Astro y estilos que puedes modificar |\n\nUsa YAML para la configuración y Markdown para las explicaciones. Edita Astro o CSS cuando necesites cambiar la propia interfaz. Tu agente puede trabajar en los mismos archivos, siguiendo las instrucciones de `AGENTS.md` y `DOCSY_BRIEF.md`.\n\n## Validar y publicar\n\n```bash\nnpm run validate\nnpm run build\n```\n\nEl modo abierto con `agent.query: false` genera un sitio estático compatible con GitHub Pages. El modo bloqueado o `agent.query: true` requiere el servidor Node para comprobar permisos o ejecutar búsquedas en cada solicitud.\n\n> No publiques tus secretos\n>\n> Los artículos y los ejemplos de un sitio estático son públicos. Guarda las credenciales privadas en el entorno del servidor, nunca en archivos Markdown o YAML publicados.\n\n## Probar las traducciones\n\nLas guías **Primeros pasos**, **Artículos enriquecidos** y **Versiones e idiomas** están traducidas al español. Abre **Configuración YAML** para comprobar el contenido alternativo: la navegación sigue en español, pero un aviso explica que el artículo se muestra en inglés porque aún no tiene traducción.\n\nLa búsqueda respeta el idioma y la versión seleccionados. Prueba a buscar **avisos** para encontrar la sección correspondiente de los artículos enriquecidos.\n\n","contentLocale":"es","isFallback":false,"authorship":{"authors":[{"name":"nedimf","kind":"human","github":"nedimf","avatar":"/docsy/assets/authors/nedimf.png","role":"AppGram","id":"nedimf","url":"https://github.com/nedimf"},{"name":"AppGram","kind":"organization","github":"AppGram","url":"https://appgram.dev","avatar":"/docsy/assets/ag-logo.svg","id":"appgram"}],"contributors":[],"reviewedBy":[]},"editUrl":"https://github.com/AppGram/docsy/edit/main/content/es/getting-started.md"}