La mayoría de herramientas de documentación exportan HTML estático. MkDocs, Sphinx, Docusaurus, Hugo, una referencia de API generada: el resultado es una carpeta autónoma, pensada para funcionar sin conexión. Es justo lo que necesitas en un avión, en el sótano de un centro de datos o en un cliente cuyo wifi rechaza tu portátil.
Queda abrirla en la tableta que has llevado.
Por qué el PDF no es la respuesta
El reflejo es exportar la documentación a PDF. Funciona, y para un documento corto suele ser la elección correcta. Pero una documentación técnica pierde mucho en la conversión.
- La navegación lateral desaparece, sustituida por un desplazamiento de varios cientos de páginas.
- Los enlaces entre secciones se convierten en el mejor caso en referencias de página, en el peor en texto muerto.
- El resaltado de sintaxis y los bloques de código plegables no siempre sobreviven.
- Cada actualización obliga a rehacer la exportación.
Y sin embargo la exportación HTML ya existe, y contiene todo eso.
Conservar la documentación tal como se generó
Pagira abre la carpeta de exportación como lo haría un navegador: la barra lateral, los enlaces entre páginas, el resaltado del código. Consultas la documentación, no una fotografía de ella.
- Copia la carpeta de exportación en Archivos o en iCloud Drive.
- Ábrela con Pagira.
- Navega como en el sitio: la barra de herramientas da atrás, adelante y recargar.
iCloud Drive y la cuestión del sin conexión
Una documentación generada pesa a menudo varios cientos de megabytes, imágenes y tipografías incluidas. Puesta en iCloud Drive, se descarga mientras lees, sin espera antes de que aparezca la primera página.
Antes de un viaje, descarga una copia sin conexión permanente. La descarga es reanudable, así que un corte no vuelve a empezar, y un aviso deja claro qué sigue disponible sin red. Ver transmitir desde iCloud Drive o guardar sin conexión.
Preparar las páginas que vas a necesitar
Hay un sin conexión sufrido y otro preparado. Si ya sabes qué documentos vas a consultar, descárgalos para leer sin conexión antes de salir, y añade los más útiles a tus favoritos: te esperan en el Inicio, y cada uno se vuelve a abrir en la página donde lo dejaste. Ver los favoritos.
El caso de las documentaciones mixtas
Una documentación de empresa casi siempre mezcla páginas HTML y PDF: una especificación, un esquema de arquitectura, un anexo contractual. Ambos se abren en la misma app, y un enlace de una página a un PDF se abre ahí mismo.
Preguntas frecuentes
¿Y una documentación de varios gigabytes?
La transmisión desde iCloud evita tener que descargarlo todo de golpe. Para el sin conexión completo, el límite es el espacio disponible en el dispositivo.
Mi documentación es confidencial
No se envía nada. Todo se representa localmente, que es justamente el argumento frente a un servicio en línea de visualización de documentos.
¿Puedo consultarla también en iPhone?
Sí, una sola app cubre ambos. Con iCloud, la página por la que vas y tus favoritos te siguen de un dispositivo a otro, para los documentos guardados en iCloud Drive.
¿Cómo la abro desde otra herramienta?
Por la hoja de compartir, con Abrir con Pagira, desde Archivos o desde cualquier app. Ver abrir desde cualquier sitio.
