Volver al blog

Leer documentación técnica sin conexión en iPad

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.

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.

  1. Copia la carpeta de exportación en Archivos o en iCloud Drive.
  2. Ábrela con Pagira.
  3. 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é secciones vas a consultar, guárdalas en la lista de lectura antes de salir. Cada elemento se conserva como una instantánea completa y no como un marcador, así que sigue legible aunque la carpeta de origen se mueva. Ver la lista de lectura.

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, y los elementos recientes permiten retomar un documento empezado en el otro dispositivo.

¿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.