Usar GitHub Codespace

La forma más sencilla de probar Ayakaleaf Pro es usar GitHub Codespace, donde todas las variables de entorno están preconfiguradas para que puedas usarlo nada más empezar.

Cuando ejecutas contenedores de Docker con GitHub Codespaces, el Codespace no se apagará automáticamente y se te seguirá facturando. Para conocer las reglas de facturación de GitHub Codespaces, consulta las reglas de facturación de GitHub Codespaces.

Para gestionar tus GitHub Codespaces, visita https://github.com/codespaces. Cuando ya no lo necesites, elimina tu Codespace a tiempo.

Hemos preconfigurado las siguientes funciones:

• Compilación de LaTeX en sandbox con TeXLive Basic (2024-2026)
• Importación/exportación con Pandoc (funciones de la plataforma SaaS)
• Ejecutor de scripts de Python (funciones de la plataforma SaaS)
• Compatibilidad con Git-Bridge (funciones de Server Pro)
• Búsqueda avanzada de referencias (funciones de la plataforma SaaS)
• Panel de administración (gestión global de usuarios y proyectos)
• Control de cambios (con panel de revisión y comentarios)
• Historial completo del proyecto (con restauración y descarga)
• Paleta de símbolos (funciones de Server Pro/plataforma SaaS)

Los GitHub Codespaces estándar ofrecen 32 GB de almacenamiento. Esto es insuficiente para nuestra instalación de texlive-full. Para probar la imagen completa, envía una solicitud de soporte a GitHub para obtener un Codespace con runners grandes (8 núcleos o más).

La sincronización con GitHub, LDAP, OAuth, SSO, la integración con Zotero y otras funciones no están configuradas en este entorno de pruebas. Puedes consultar la configuración del Toolkit para obtener más detalles sobre cómo configurar estas funciones en tu propio despliegue.

1. Crear tu GitHub Codespace

   Haz clic en el siguiente botón para crear tu GitHub Codespace. En cuanto a la configuración del servidor, 2 núcleos con 8 GB de RAM suelen ser suficientes para una prueba. Si piensas usar TeX Live Full, te recomendamos elegir una configuración de 8 núcleos y 64 GB.

   

2. Inicializar la instancia de Overleaf

   Cuando tu codespace esté listo, ejecuta el siguiente comando en tu terminal bash para inicializar tu instancia de Overleaf.

   bash

   ./init.sh
   

   Es posible que tengas que esperar al menos 3 minutos hasta que se descarguen todas las imágenes de Docker necesarias.

   
3. Hacer público el puerto 80

   Cambia a la pestaña Ports y sigue estos pasos para hacer público el puerto 80.

   

   Después, puedes hacer clic en Forwarded Address para visitar tu instancia de Overleaf. Es posible que tengas que añadir /launchpad para acceder a la página de bienvenida de Overleaf.

4. Crear tu cuenta de administrador

   Introduce la cuenta y la contraseña de administrador y haz clic en el botón Register.

   
5. Disfruta escribiendo

   ¡Ahora ya puedes disfrutar escribiendo en $\LaTeX$!

   

​

Usar la imagen TeXLive Full

Si tienes acceso a GitHub Codespaces de 8 núcleos y 64 GB, puedes usar la imagen TeXLive Full en este entorno de pruebas. Puedes cambiar las siguientes variables de entorno en el archivo toolkit/config/variables.env para usar la imagen TeXLive Full en lugar de la imagen TeXLive Basic.

ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1, ghcr.io/ayaka-notes/texlive-full:2024.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025, Texlive 2024
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1

Después de cambiar las variables de entorno, debes reiniciar el Toolkit para aplicar los cambios. Puedes ejecutar el siguiente comando para reiniciarlo.

cd toolkit && bin/up -d