Chuyển đến nội dung chính
Ayakaleaf Pro bao gồm một module tải các trang từ một trang MediaWiki tại URL do bạn cấu hình và phục vụ chúng dưới đường dẫn /learn trên phiên bản của bạn. Bản thân Ayakaleaf Pro không đi kèm, lưu trữ hay phân phối bất kỳ nội dung wiki nào. Để bật module này, hãy thêm OVERLEAF_PROXY_LEARN=true vào tệp config/variables.env trong Toolkit và chạy lệnh bin/up. Sau đó, người dùng có thể mở các trang wiki bằng cách nhấp vào nút Documentation trong menu điều hướng, mà không cần rời khỏi phiên bản của bạn.
Theo mặc định, chỉ người dùng đã đăng nhập mới có thể mở /learn. Để cung cấp trang này cho cả khách truy cập chưa đăng nhập, hãy đặt thêm OVERLEAF_ALLOW_PUBLIC_ACCESS=true, xem Page Access.
Đối với các triển khai bằng Docker Compose, bạn cần thêm biến môi trường OVERLEAF_PROXY_LEARN: true vào phần environment của dịch vụ sharelatex trong tệp docker-compose.yml.
Khi bạn bật tùy chọn này lần đầu và khởi động lại Docker Overleaf, hệ thống cần tải xuống Wiki liên quan, quá trình này có thể mất 5 phút hoặc lâu hơn. Chỉ sau khi tải xuống hoàn tất, bạn mới có thể thấy trang đăng nhập Overleaf của mình.

Chọn nguồn wiki

Wiki cần proxy được đặt bằng WIKI_URL. Nếu bạn không đặt biến này, giá trị mặc định kế thừa từ cấu hình Overleaf upstream (services/web/config/settings.defaults.js) sẽ được sử dụng:
Đây là wiki đứng sau các trang Overleaf Learn. Phiên bản của bạn cần có kết nối internet để truy cập wiki này.
Lưu ý về bản quyền. Module chỉ tải nội dung từ URL trong WIKI_URL; nội dung thuộc về bên vận hành wiki đó. Khi được bật, phiên bản của bạn sẽ tải xuống mọi trang của wiki đó và lưu một bản sao trên máy chủ của bạn. Wiki mặc định do Overleaf vận hành, và nội dung của nó thuộc sở hữu của Overleaf, không phải của Ayakaleaf Pro. Trước khi bật module, hãy kiểm tra rằng việc tải xuống, lưu trữ và phục vụ các trang đó tuân thủ điều khoản của Overleaf, đặc biệt nếu phiên bản của bạn mở cho khách truy cập chưa đăng nhập. Nếu không chắc chắn, hãy trỏ WIKI_URL tới một wiki mà bạn sở hữu nội dung hoặc được cấp phép sử dụng.
Thay vào đó, bạn có thể trỏ WIKI_URL tới wiki của riêng mình, ví dụ một cơ sở tri thức nội bộ:
Wiki phải là một trang MediaWiki cung cấp:
  • API của nó tại <WIKI_URL>/learn-scripts/api.php, với quyền đọc ẩn danh cho action=query và action=parse
  • các hình ảnh đã tải lên dưới <WIKI_URL>/learn-scripts/images/
  • các liên kết bài viết có dạng /learn/<Page>, được module viết lại thành /learn/latex/<Page> trên phiên bản của bạn
Các đường dẫn này được cố định trong module và tuân theo cấu trúc của wiki mặc định. Một bản cài đặt MediaWiki mới sử dụng các đường dẫn khác, vì vậy hãy đặt các giá trị sau trong LocalSettings.php của nó (hoặc ánh xạ các đường dẫn trong reverse proxy của bạn):
Các trang được ánh xạ như sau:

Bộ nhớ đệm

Các trang đã tải được lưu vào bộ nhớ đệm tại /var/lib/overleaf/data/learnPages bên trong container sharelatex. Một trang trong bộ nhớ đệm sẽ được làm mới khi nó cũ hơn WIKI_MAX_CACHE_AGE mili giây (mặc định 300000, tức 5 phút). Nếu không thể truy cập wiki, bản sao trong bộ nhớ đệm sẽ tiếp tục được phục vụ.

Ghi nhận

Phần triển khai của module tham khảo learn proxy trong overleaf-go của Jakob Ackermann, một bản port Overleaf sang Golang được cấp phép theo AGPL-3.0, bao gồm cách ánh xạ trang và cách sử dụng MediaWiki API.
Lần sửa đổi cuối 2 tháng 11, 2026