Vai al contenuto principale
Ayakaleaf Pro include un modulo che scarica le pagine da un sito MediaWiki all’URL che configuri e le serve sotto /learn sulla tua istanza. Ayakaleaf Pro di per sé non include, ospita né distribuisce alcun contenuto wiki. Per abilitare il modulo, aggiungi OVERLEAF_PROXY_LEARN=true al file config/variables.env nel Toolkit ed esegui il comando bin/up. Gli utenti possono quindi aprire le pagine della wiki facendo clic sul pulsante Documentation nel menu di navigazione, senza uscire dalla tua istanza.
Per impostazione predefinita solo gli utenti che hanno effettuato l’accesso possono aprire /learn. Per renderla disponibile anche ai visitatori non autenticati, imposta anche OVERLEAF_ALLOW_PUBLIC_ACCESS=true; vedi Accesso alle pagine.
Per le installazioni con Docker Compose, dovrai aggiungere la variabile d’ambiente OVERLEAF_PROXY_LEARN: true alla sezione environment del servizio sharelatex nel tuo file docker-compose.yml.
Quando abiliti questa opzione per la prima volta e riavvii il tuo Docker di Overleaf, il sistema deve scaricare la Wiki corrispondente, operazione che può richiedere fino a 5 minuti o più. Solo dopo il completamento del download potrai visualizzare correttamente la pagina di accesso di Overleaf.

Scegliere la sorgente della wiki

La wiki da inoltrare tramite proxy si imposta con WIKI_URL. Se non la imposti, viene usato il valore predefinito ereditato dalla configurazione upstream di Overleaf (services/web/config/settings.defaults.js):
Questa è la wiki alla base delle pagine Overleaf Learn. La tua istanza deve avere accesso a Internet per raggiungerla.
Attenzione al copyright. Il modulo scarica contenuti solo dall’URL indicato in WIKI_URL; i contenuti appartengono a chi gestisce quella wiki. Quando il modulo è abilitato, la tua istanza scarica ogni pagina di quella wiki e ne conserva una copia sul tuo server. La wiki predefinita è gestita da Overleaf e i suoi contenuti sono di proprietà di Overleaf, non di Ayakaleaf Pro. Prima di abilitare il modulo, verifica che scaricare, conservare e servire queste pagine sia conforme ai termini di Overleaf, soprattutto se la tua istanza è aperta ai visitatori non autenticati. In caso di dubbio, imposta WIKI_URL su una wiki di cui possiedi i contenuti o per cui disponi di una licenza d’uso.
In alternativa, puoi impostare WIKI_URL sulla tua wiki, ad esempio una knowledge base interna:
La wiki deve essere un sito MediaWiki che serva:
  • la propria API in <WIKI_URL>/learn-scripts/api.php, con accesso in lettura anonimo a action=query e action=parse
  • le immagini caricate sotto <WIKI_URL>/learn-scripts/images/
  • i link agli articoli nella forma /learn/<Page>, che il modulo riscrive in /learn/latex/<Page> sulla tua istanza
Questi percorsi sono fissi nel modulo e seguono la struttura della wiki predefinita. Una nuova installazione di MediaWiki ne usa di diversi, quindi imposta quanto segue nel suo LocalSettings.php (oppure mappa i percorsi nel tuo reverse proxy):
Le pagine vengono mappate come segue:

Cache

Le pagine scaricate vengono memorizzate nella cache in /var/lib/overleaf/data/learnPages all’interno del container sharelatex. Una pagina in cache viene aggiornata quando è più vecchia di WIKI_MAX_CACHE_AGE millisecondi (predefinito 300000, 5 minuti). Se la wiki non è raggiungibile, continua a essere servita la copia in cache.

Riconoscimenti

L’implementazione del modulo fa riferimento al proxy learn di overleaf-go di Jakob Ackermann, un port in Golang di Overleaf con licenza AGPL-3.0, inclusa la mappatura delle pagine e l’uso dell’API MediaWiki.
Ultima modifica il 2 novembre 2026