Preguntas frecuentes
¿Cómo añadir un documento nuevo?
- Crea un archivo
.mden el directoriodocs; - Registra la ruta de la página en
sidebardedocs/.vitepress/config.mjs; - Actualiza el navegador y ya verás la página nueva.
Consulta Inicio rápido.
¿Cómo cambiar el título del sitio y el color del tema?
- Título: modifica
titleendocs/.vitepress/config.mjs; - Color del tema: modifica las variables
--vp-c-brand-*endocs/.vitepress/theme/custom.css.
¿Cómo activar o desactivar la búsqueda de texto completo?
La configuración de búsqueda se encuentra en el campo themeConfig.search de docs/.vitepress/config.mjs; establece provider: 'local' para activar la búsqueda local, y elimina ese campo para desactivarla.
¿La documentación admite modo oscuro?
Sí. El sitio sigue por defecto la apariencia del sistema, y también se puede cambiar manualmente con el botón de la esquina superior derecha, sin configuración adicional.
¿Cómo desplegar en tu propio servidor?
Aloja el directorio docs/.vitepress/dist generado por npm run docs:build en cualquier servidor estático (Nginx, almacenamiento de objetos, etc.). Consulta Despliegue y publicación.
¿Cómo añadir un conmutador de versiones a la documentación?
La solución de versionado de la documentación oficial de VitePress se implementa mediante múltiples builds estáticos + navegación personalizada; también puedes integrar rápidamente plugins de la comunidad (como vitepress-versioning).
¿Qué hago si falla la construcción?
Pasos habituales de depuración:
- Comprueba que la versión de Node sea 18 o superior:
node -v; - Elimina la caché y reconstruye:
rm -rf docs/.vitepress/cache docs/.vitepress/dist; - Reinstala las dependencias:
rm -rf node_modules && npm install; - Revisa el stack trace completo para localizar el archivo concreto.
¿Cómo personalizar el pie de página?
Modifica los campos message y copyright de themeConfig.footer en docs/.vitepress/config.mjs.
¿No encuentras la respuesta?
- Envía un Issue para notificar el problema;
- Edita esta página en GitHub para aportar tu respuesta.