Saltar al contenido principal
Ayakaleaf Pro incluye un módulo que descarga páginas de un sitio MediaWiki en una URL que tú configuras y las sirve bajo /learn en tu instancia. Ayakaleaf Pro no incluye, aloja ni distribuye por sí mismo ningún contenido de wiki. Para habilitar el módulo, añade OVERLEAF_PROXY_LEARN=true al archivo config/variables.env del Toolkit y ejecuta el comando bin/up. Así, los usuarios pueden abrir las páginas de la wiki haciendo clic en el botón Documentation del menú de navegación, sin salir de tu instancia.
De forma predeterminada, solo los usuarios que han iniciado sesión pueden abrir /learn. Para que esté disponible para visitantes sin sesión iniciada, establece también OVERLEAF_ALLOW_PUBLIC_ACCESS=true; consulta Acceso a páginas.
En los despliegues con Docker Compose, tendrás que añadir la variable de entorno OVERLEAF_PROXY_LEARN: true a la sección environment del servicio sharelatex en tu archivo docker-compose.yml.
La primera vez que habilites esta opción y reinicies tu Docker de Overleaf, el sistema tendrá que descargar la Wiki correspondiente, lo que puede tardar 5 minutos o más. Solo cuando la descarga haya finalizado podrás ver correctamente la página de inicio de sesión de Overleaf.

Elegir la fuente de la wiki

La wiki que se va a usar como proxy se define con WIKI_URL. Si no la defines, se usa el valor predeterminado heredado de la configuración de Overleaf upstream (services/web/config/settings.defaults.js):
Esta es la wiki que hay detrás de las páginas de Overleaf Learn. Tu instancia necesita acceso a internet para llegar a ella.
Ten en cuenta los derechos de autor. El módulo solo descarga contenido de la URL indicada en WIKI_URL; el contenido pertenece a quien gestiona esa wiki. Cuando está habilitado, tu instancia descarga todas las páginas de esa wiki y guarda una copia en tu servidor. La wiki predeterminada la gestiona Overleaf, y su contenido es propiedad de Overleaf, no de Ayakaleaf Pro. Antes de habilitar el módulo, comprueba que descargar, almacenar y servir esas páginas cumple los términos de Overleaf, sobre todo si tu instancia está abierta a visitantes sin sesión iniciada. En caso de duda, apunta WIKI_URL a una wiki cuyo contenido sea tuyo o para el que tengas licencia de uso.
En su lugar, puedes apuntar WIKI_URL a tu propia wiki, por ejemplo una base de conocimiento interna:
La wiki debe ser un sitio MediaWiki que sirva:
  • su API en <WIKI_URL>/learn-scripts/api.php, con acceso de lectura anónimo a action=query y action=parse
  • las imágenes subidas bajo <WIKI_URL>/learn-scripts/images/
  • enlaces a artículos con el formato /learn/<Page>, que el módulo reescribe como /learn/latex/<Page> en tu instancia
Estas rutas están fijadas en el módulo y siguen la estructura de la wiki predeterminada. Una instalación nueva de MediaWiki usa otras, así que configura lo siguiente en su LocalSettings.php (o asigna las rutas en tu proxy inverso):
Las páginas se asignan de la siguiente manera:

Caché

Las páginas descargadas se almacenan en caché en /var/lib/overleaf/data/learnPages dentro del contenedor sharelatex. Una página en caché se actualiza cuando tiene más de WIKI_MAX_CACHE_AGE milisegundos de antigüedad (por defecto 300000, 5 minutos). Si la wiki no está accesible, se sigue sirviendo la copia en caché.

Créditos

La implementación del módulo toma como referencia el proxy de Learn de overleaf-go, de Jakob Ackermann, un port de Overleaf a Golang con licencia AGPL-3.0, incluida su asignación de páginas y su uso de la API de MediaWiki.
Última modificación el 2 de noviembre de 2026