# Introducción

Onedocs es un conjunto de diseños, componentes y funciones auxiliares para sitios de documentación creados con Next.js y Fumadocs. Escribes Markdown, describes tu sitio en un único archivo de configuración y Onedocs proporciona la estructura de documentación, una página de inicio y las rutas SEO.

Está pensado para sitios de documentación independientes, no para añadir documentación a una aplicación existente.

## Qué añade Onedocs

Además de Fumadocs, el paquete `onedocs` ofrece:

- **Diseños** - `DocsLayout` y `DocsPage` envuelven el diseño de documentación Fumadocs UI, con barra lateral, búsqueda, selector de tema y tabla de contenido. `HomePage` muestra una página de inicio con contenido destacado, comandos de instalación, funciones y pie de página.
- **Un archivo de configuración** - `onedocs.config.ts` contiene el título, la descripción, el logotipo, el favicon, los enlaces de navegación, el pie de página y el contenido de la página de inicio.
- **Componentes MDX** - `mdxComponents` registra avisos, pestañas, tarjetas, pasos, acordeones, árboles de archivos, zoom de imágenes y tablas de tipos para usarlos en las páginas sin importarlos.
- **Ajuste preestablecido de CSS** - una importación incorpora Tailwind CSS v4, el tema Fumadocs UI y los estilos de diseño Onedocs.
- **Funciones auxiliares de SEO** - funciones para `sitemap.xml`, `robots.txt`, `llms.txt`, `llms-full.txt`, metadatos de página e imágenes Open Graph.

## Lo que debes configurar tú

Onedocs no incluye Next.js ni Fumadocs. Son dependencias de pares que debes instalar junto con él:

```bash
npm install onedocs fumadocs-core fumadocs-mdx fumadocs-ui lucide-react@0.562 next react react-dom
```

También necesitas Tailwind CSS v4, Node.js 20.9 o posterior y unos diez archivos pequeños: el archivo de configuración de Next.js y Fumadocs MDX, una fuente de contenido, el diseño raíz, el diseño de documentación y la ruta de la página de documentación. [Primeros pasos](https://onedocs.inline0.dev/es/docs/getting-started) muestra cada uno.

## Dónde se configura cada cosa

| Qué | Dónde |
|------|-------|
| Título del sitio, logotipo, navegación y pie de página | `onedocs.config.ts`; consulta [Configuración](https://onedocs.inline0.dev/es/docs/configuration) |
| Contenido destacado y funciones de la página de inicio | `homepage` en `onedocs.config.ts`, que muestra `HomePage` en `src/app/page.tsx` |
| Diseño y páginas de documentación | `src/app/docs/layout.tsx` y `src/app/docs/[[...slug]]/page.tsx`; consulta [Primeros pasos](https://onedocs.inline0.dev/es/docs/getting-started) |
| Carpeta de contenido y orden de la barra lateral | `source.config.ts` y `content/docs/meta.json` |
| Componentes MDX | `mdxComponents`; consulta [Componentes](https://onedocs.inline0.dev/es/docs/components) |
| Búsqueda, mapa del sitio, robots.txt, llms.txt | Archivos de ruta en `src/app/`; consulta [SEO y búsqueda](https://onedocs.inline0.dev/es/docs/seo-search) |
| Metadatos e imágenes Open Graph | `onedocs/metadata` y `onedocs/og`; consulta la [referencia de API](https://onedocs.inline0.dev/es/docs/api-reference) |

## Filosofía

- **Markdown primero** - Escribe `.md` o `.mdx` y obtén documentación
- **Un archivo de configuración** - Los ajustes de todo el sitio están en `onedocs.config.ts`
- **Opciones para ampliar** - ¿Necesitas más control? Usa Fumadocs directamente

## Empieza aquí

- [Primeros pasos](https://onedocs.inline0.dev/es/docs/getting-started)
- [Componentes](https://onedocs.inline0.dev/es/docs/components)
- [SEO y búsqueda](https://onedocs.inline0.dev/es/docs/seo-search)
- [Configuración](https://onedocs.inline0.dev/es/docs/configuration)
- [Referencia de API](https://onedocs.inline0.dev/es/docs/api-reference)