Langsung ke konten utama
Ayakaleaf Pro menyertakan sebuah modul yang mengunduh halaman dari situs MediaWiki pada URL yang Anda konfigurasi dan menyajikannya di bawah /learn pada instans Anda. Ayakaleaf Pro sendiri tidak menyertakan, meng-host, atau mendistribusikan konten wiki apa pun. Untuk mengaktifkan modul ini, tambahkan OVERLEAF_PROXY_LEARN=true ke file config/variables.env di Toolkit dan jalankan perintah bin/up. Pengguna kemudian dapat membuka halaman wiki dengan mengklik tombol Documentation di menu navigasi, tanpa harus meninggalkan instans Anda.
Secara default, hanya pengguna yang sudah login yang dapat membuka /learn. Agar halaman ini tersedia bagi pengunjung yang belum login, atur juga OVERLEAF_ALLOW_PUBLIC_ACCESS=true, lihat Page Access.
Untuk deployment Docker Compose, Anda perlu menambahkan variabel lingkungan OVERLEAF_PROXY_LEARN: true ke bagian environment pada layanan sharelatex di file docker-compose.yml Anda.
Saat Anda pertama kali mengaktifkan opsi ini dan me-reboot Docker Overleaf Anda, sistem perlu mengunduh Wiki terkait, yang dapat memakan waktu hingga 5 menit atau lebih. Halaman login Overleaf Anda baru akan berhasil ditampilkan setelah unduhan selesai.

Memilih sumber wiki

Wiki yang akan di-proxy diatur dengan WIKI_URL. Jika Anda tidak mengaturnya, nilai default yang diwarisi dari konfigurasi Overleaf upstream (services/web/config/settings.defaults.js) akan digunakan:
Ini adalah wiki di balik halaman Overleaf Learn. Instans Anda memerlukan akses internet untuk menjangkaunya.
Perhatikan hak cipta. Modul ini hanya mengambil konten dari URL di WIKI_URL; kontennya milik siapa pun yang menjalankan wiki tersebut. Saat diaktifkan, instans Anda mengunduh setiap halaman wiki tersebut dan menyimpan salinannya di server Anda. Wiki default dijalankan oleh Overleaf, dan kontennya dimiliki oleh Overleaf, bukan oleh Ayakaleaf Pro. Sebelum mengaktifkan modul ini, pastikan bahwa mengunduh, menyimpan, dan menyajikan halaman-halaman tersebut sesuai dengan ketentuan Overleaf, terutama jika instans Anda terbuka bagi pengunjung yang belum login. Jika ragu, arahkan WIKI_URL ke wiki yang kontennya Anda miliki atau yang Anda punya lisensi untuk menggunakannya.
Sebagai gantinya, Anda dapat mengarahkan WIKI_URL ke wiki Anda sendiri, misalnya basis pengetahuan internal:
Wiki tersebut harus berupa situs MediaWiki yang menyajikan:
  • API-nya di <WIKI_URL>/learn-scripts/api.php, dengan akses baca anonim ke action=query dan action=parse
  • gambar yang diunggah di bawah <WIKI_URL>/learn-scripts/images/
  • tautan artikel dengan format /learn/<Page>, yang ditulis ulang oleh modul menjadi /learn/latex/<Page> pada instans Anda
Path-path ini sudah ditetapkan di dalam modul dan mengikuti tata letak wiki default. Instalasi MediaWiki baru menggunakan path yang berbeda, jadi atur hal berikut di LocalSettings.php-nya (atau petakan path tersebut di reverse proxy Anda):
Halaman dipetakan sebagai berikut:

Cache

Halaman yang diambil di-cache di /var/lib/overleaf/data/learnPages di dalam kontainer sharelatex. Halaman yang di-cache akan diperbarui jika usianya lebih dari WIKI_MAX_CACHE_AGE milidetik (default 300000, 5 menit). Jika wiki tidak dapat dijangkau, salinan cache tetap disajikan.

Kredit

Implementasi modul ini merujuk pada learn proxy di overleaf-go oleh Jakob Ackermann, port Overleaf dalam Golang yang berlisensi AGPL-3.0, termasuk pemetaan halamannya dan penggunaan API MediaWiki.
Terakhir diubah pada 2 November 2026