Importar desde Mintlify

¿Te mudas desde Mintlify? DeveloperHub lee tu documentación directamente desde GitHub y la trae contigo: tus páginas, tus imágenes, tus referencias de API y el aspecto de tu sitio.

Antes de empezar

• Necesitas el rol de Publisher o superior.

• Tu documentación debe estar en un repositorio de GitHub. Los repositorios privados son válidos.

Importar desde Mintlify

1. Abre Project Settings → Import & Export.

2. En Bring content in, haz clic en Mintlify.

3. Pega la dirección de tu repositorio, por ejemplo github.com/acme/docs.

4. Haz clic en Start import.

Pega cualquier página del repositorio y nosotros deducimos el resto. Si tu documentación está en otra rama o en una carpeta propia, abre Advanced e indica dónde.

Antes de crear nada

DeveloperHub lee primero tu sitio e informa de lo que ha encontrado: cuántas páginas hay, y las secciones, versiones e idiomas en los que se encuentran. En esta fase no se crea nada.

También obtienes What will change on the way in, una lista de todo lo que no puede importarse exactamente tal cual. Conviene leerla antes de empezar.

Elegir versiones e idiomas

Si tu sitio tiene más de una versión o idioma, eliges cuáles se importan. Cada uno se convierte en una versión propia en DeveloperHub.

Marca los que quieras y deja el resto. Puedes volver a ejecutar la importación más tarde para traer los demás.

Qué se importa

Tus páginas llegan como páginas, con tus secciones y grupos alrededor. Los avisos, las pestañas, los acordeones, las tarjetas, los pasos y los ejemplos de código tienen un equivalente aquí, y lo que no lo tiene conserva su texto.

Las imágenes se alojan de nuevo en nuestra red de distribución de contenido, por lo que siguen funcionando cuando Mintlify se desactive. Los enlaces entre tus páginas se reescriben con sus nuevas direcciones y tus archivos OpenAPI se convierten en referencias de API.

Qué cambia en tu proyecto

Una importación trae consigo la apariencia de tu sitio de Mintlify: título, colores, logotipo, favicon, fuente, enlaces de la barra superior, pie de página y redirecciones. Esto sustituye lo que tiene ahora tu proyecto. Importa a un proyecto nuevo si prefieres conservar el aspecto del tuyo.

Después de la importación

Conviene revisar antes de publicar:

• Advertencias. Todo lo que cambió durante la importación se muestra en una lista cuando termina la ejecución.

• Dónde han quedado tus páginas. Una importación añade versiones nuevas en lugar de completar la que tienes abierta.

• Estructura. Mintlify organiza el contenido de forma distinta a DeveloperHub, así que quizá quieras reestructurar las páginas.

Detener una importación

Haz clic en Stop import mientras se esté ejecutando. Todo lo importado hasta ese momento permanece en tu proyecto.