Spring til hovedindhold
Ayakaleaf Pro indeholder et modul, der downloader sider fra et MediaWiki-websted på en URL, du konfigurerer, og serverer dem under /learn på din instans. Ayakaleaf Pro leverer, hoster eller distribuerer ikke selv noget wiki-indhold. For at aktivere modulet skal du tilføje OVERLEAF_PROXY_LEARN=true til filen config/variables.env i Toolkit og køre kommandoen bin/up. Brugerne kan derefter åbne wiki-siderne ved at klikke på knappen Documentation i navigationsmenuen uden at forlade din instans.
Som standard kan kun indloggede brugere åbne /learn. For at gøre siden tilgængelig for besøgende, der ikke er logget ind, skal du også sætte OVERLEAF_ALLOW_PUBLIC_ACCESS=true, se Sideadgang.
Ved Docker Compose-udrulninger skal du tilføje miljøvariablen OVERLEAF_PROXY_LEARN: true til environment-sektionen for tjenesten sharelatex i din docker-compose.yml-fil.
Når du første gang aktiverer denne indstilling og genstarter din Overleaf-docker, skal systemet downloade den relevante wiki, hvilket kan tage op til 5 minutter eller mere. Først når downloadet er færdigt, vil du kunne se din Overleaf-loginside.

Valg af wiki-kilde

Den wiki, der skal proxies, angives med WIKI_URL. Hvis du lader den være usat, bruges standardværdien, der er arvet fra upstream-Overleaf-konfigurationen (services/web/config/settings.defaults.js):
Dette er wikien bag Overleaf Learn-siderne. Din instans skal have internetadgang for at kunne nå den.
Vær opmærksom på ophavsretten. Modulet henter kun fra URL’en i WIKI_URL; indholdet tilhører den, der driver den pågældende wiki. Når modulet er aktiveret, downloader din instans hver side i den wiki og gemmer en kopi på din server. Standardwikien drives af Overleaf, og indholdet ejes af Overleaf, ikke af Ayakaleaf Pro. Før du aktiverer modulet, skal du kontrollere, at download, lagring og visning af disse sider overholder Overleafs vilkår, især hvis din instans er åben for besøgende, der ikke er logget ind. Er du i tvivl, så lad WIKI_URL pege på en wiki, hvis indhold du ejer eller har licens til at bruge.
Du kan i stedet lade WIKI_URL pege på din egen wiki, for eksempel en intern vidensbase:
Wikien skal være et MediaWiki-websted, der serverer:
  • sit API på <WIKI_URL>/learn-scripts/api.php med anonym læseadgang til action=query og action=parse
  • uploadede billeder under <WIKI_URL>/learn-scripts/images/
  • artikellinks på formen /learn/<Page>, som modulet omskriver til /learn/latex/<Page> på din instans
Disse stier er fastlagt i modulet og følger standardwikiens layout. En ny MediaWiki-installation bruger andre stier, så angiv følgende i dens LocalSettings.php (eller map stierne i din reverse proxy):
Sider mappes på følgende måde:

Cache

Hentede sider caches i /var/lib/overleaf/data/learnPages i sharelatex-containeren. En cachet side opdateres, når den er ældre end WIKI_MAX_CACHE_AGE millisekunder (standard 300000, 5 minutter). Hvis wikien ikke kan nås, fortsætter den cachede kopi med at blive serveret.

Tak

Modulets implementering bygger på learn-proxyen i overleaf-go af Jakob Ackermann, en Golang-port af Overleaf under AGPL-3.0-licensen, herunder dens sidemapping og dens brug af MediaWiki-API’et.
Sidst ændret 2. november 2026