Ana içeriğe atla
Ayakaleaf Pro, yapılandırdığınız bir URL’deki MediaWiki sitesinden sayfaları indiren ve bunları örneğinizde /learn altında sunan bir modül içerir. Ayakaleaf Pro’nun kendisi herhangi bir wiki içeriği sağlamaz, barındırmaz veya dağıtmaz. Modülü etkinleştirmek için Toolkit içindeki config/variables.env dosyanıza OVERLEAF_PROXY_LEARN=true ekleyin ve bin/up komutunu çalıştırın. Ardından kullanıcılar, gezinme menüsündeki Documentation düğmesine tıklayarak örneğinizden ayrılmadan wiki sayfalarını açabilir.
Varsayılan olarak /learn sayfasını yalnızca oturum açmış kullanıcılar açabilir. Oturum açmamış ziyaretçilerin de erişebilmesi için ayrıca OVERLEAF_ALLOW_PUBLIC_ACCESS=true değerini ayarlayın; bkz. Page Access.
Docker Compose dağıtımlarında, OVERLEAF_PROXY_LEARN: true ortam değişkenini docker-compose.yml dosyanızdaki sharelatex hizmetinin environment bölümüne eklemeniz gerekir.
Bu seçeneği ilk kez etkinleştirip Overleaf Docker’ınızı yeniden başlattığınızda, sistemin ilgili Wiki’yi indirmesi gerekir; bu işlem 5 dakika veya daha uzun sürebilir. Overleaf giriş sayfanızı ancak indirme tamamlandıktan sonra başarıyla görebilirsiniz.

Wiki kaynağını seçme

Proxy üzerinden sunulacak wiki WIKI_URL ile ayarlanır. Bunu ayarlamadan bırakırsanız, upstream Overleaf yapılandırmasından (services/web/config/settings.defaults.js) devralınan varsayılan değer kullanılır:
Bu, Overleaf Learn sayfalarının arkasındaki wiki’dir. Örneğinizin buna ulaşabilmesi için internet erişimi gerekir.
Telif haklarına dikkat edin. Modül yalnızca WIKI_URL içindeki URL’den içerik çeker; içerik, o wiki’yi işleten kişiye aittir. Modül etkinleştirildiğinde örneğiniz o wiki’nin her sayfasını indirir ve sunucunuzda bir kopyasını saklar. Varsayılan wiki Overleaf tarafından işletilir ve içeriği Ayakaleaf Pro’ya değil, Overleaf’e aittir. Modülü etkinleştirmeden önce, bu sayfaların indirilmesinin, saklanmasının ve sunulmasının Overleaf’in koşullarına uygun olduğunu kontrol edin; özellikle örneğiniz oturum açmamış ziyaretçilere açıksa. Emin değilseniz, WIKI_URL değerini içeriğine sahip olduğunuz veya kullanım lisansına sahip olduğunuz bir wiki’ye yönlendirin.
Bunun yerine WIKI_URL değerini kendi wiki’nize, örneğin dahili bir bilgi tabanına yönlendirebilirsiniz:
Wiki, aşağıdakileri sunan bir MediaWiki sitesi olmalıdır:
  • action=query ve action=parse için anonim okuma erişimine sahip, <WIKI_URL>/learn-scripts/api.php adresindeki API’si
  • <WIKI_URL>/learn-scripts/images/ altındaki yüklenmiş görseller
  • modülün örneğinizde /learn/latex/<Page> biçimine dönüştürdüğü /learn/<Page> biçimindeki makale bağlantıları
Bu yollar modülde sabittir ve varsayılan wiki’nin düzenini izler. Yeni bir MediaWiki kurulumu farklı yollar kullanır; bu nedenle LocalSettings.php dosyasında aşağıdakileri ayarlayın (veya yolları reverse proxy’nizde eşleyin):
Sayfalar aşağıdaki gibi eşlenir:

Önbellek

Çekilen sayfalar, sharelatex konteyneri içindeki /var/lib/overleaf/data/learnPages dizininde önbelleğe alınır. Önbellekteki bir sayfa, WIKI_MAX_CACHE_AGE milisaniyeden (varsayılan 300000, 5 dakika) daha eski olduğunda yenilenir. Wiki’ye ulaşılamıyorsa önbellekteki kopya sunulmaya devam eder.

Katkıda bulunanlar

Modülün uygulaması, sayfa eşlemesi ve MediaWiki API kullanımı dahil olmak üzere, Jakob Ackermann tarafından geliştirilen ve AGPL-3.0 lisanslı bir Overleaf Golang portu olan overleaf-go içindeki learn proxy’sine dayanmaktadır.
Son değiştirilme tarihi 2 Kasım 2026