Descripción general de la configuración del proyecto

Todos los sitios de Jamdesk empiezan de la misma manera: un proyecto en el dashboard, un repositorio de GitHub detrás y un archivo docs.json que describe tu navegación. Esta sección cubre esa configuración inicial, además de las decisiones estructurales que vale la pena tomar desde el principio. La estructura de las URL, los idiomas y el control de acceso son mucho más fáciles de definir antes de tener cincuenta páginas que después.

¿Migras desde otra plataforma? Ve directamente a la Guía de migración. Jamdesk puede automatizar la mayor parte de la conversión.

Del repositorio al sitio en producción

Crea un proyecto

Empieza desde una plantilla o conecta un repositorio de GitHub existente. Tu sitio se publica en yourproject.jamdesk.app.

Conecta GitHub

Instala la GitHub App para que cada push se despliegue automáticamente.

Organiza el repositorio

Un archivo docs.json más páginas MDX. Eso es todo el contrato.

Configuración básica

Crear un proyecto

De una plantilla o un repositorio existente a un sitio en producción

Conectar GitHub

Instalación de la app, acceso al repositorio y despliegues automáticos con cada push

Estructura de directorios

Archivos requeridos, directorios de páginas, imágenes y snippets

Guía de migración

Migra desde otra plataforma de documentación, de forma automática o manual

Soporte para monorepo

Mantén la documentación junto a tu código cuando no está en la raíz del repositorio

Compatibilidad con múltiples idiomas

Ofrece la documentación en varios idiomas con un selector de idioma

Estructura del sitio

Navegación

Pestañas, grupos y páginas que organizan tu documentación

Redirecciones

Redirecciones exactas y basadas en patrones para páginas movidas o renombradas

Privacidad y acceso

Control de acceso

Totalmente público, protegido con contraseña, mixto o SSO. Compara las opciones.

Protección con contraseña

Bloquea todo el sitio o solo un puñado de páginas con una contraseña compartida

Inicio de sesión único (SSO)

SAML u OIDC a través de tu proveedor de identidad