基本問題
Q01:Ayakaleaf Pro 是免費試用版嗎?需要授權嗎?
Q01:Ayakaleaf Pro 是免費試用版嗎?需要授權嗎?
Q02:Ayakaleaf Pro 是否包含 Overleaf Server Pro 的所有功能?
Q02:Ayakaleaf Pro 是否包含 Overleaf Server Pro 的所有功能?
Q03:Overleaf Server Pro 的價格是多少?
Q03:Overleaf Server Pro 的價格是多少?
Q04:為什麼 Overleaf Server Pro 不包含 GitHub 同步或 AI 功能?
Q04:為什麼 Overleaf Server Pro 不包含 GitHub 同步或 AI 功能?
Q05:Ayakaleaf Pro 安全可靠嗎?
Q05:Ayakaleaf Pro 安全可靠嗎?
Q06:Ayakaleaf Pro 會長期維護嗎?
Q06:Ayakaleaf Pro 會長期維護嗎?
Q07:Ayakaleaf Pro 是否合規?
Q07:Ayakaleaf Pro 是否合規?
Q08:為什麼這個專案叫做 Ayakaleaf Pro?
Q08:為什麼這個專案叫做 Ayakaleaf Pro?
Q09:Ayakaleaf Pro 與較新的 AI 打造 LaTeX 編輯器有何不同?
Q09:Ayakaleaf Pro 與較新的 AI 打造 LaTeX 編輯器有何不同?
Q10:GitHub 儲存庫 ayaka-notes/overleaf-pro 怎麼了?
Q10:GitHub 儲存庫 ayaka-notes/overleaf-pro 怎麼了?
ayaka-notes/overleaf-pro 連結與 Git 遠端重新導向至新名稱。Docker 映像檔則維持原名 ghcr.io/ayaka-notes/overleaf-pro,因此您不需要變更 config/overleaf.rc 或 config/version。功能
Q01:Ayakaleaf Pro 提供哪些功能?我可以提出新功能需求嗎?
Q01:Ayakaleaf Pro 提供哪些功能?我可以提出新功能需求嗎?
Q02:我開發了一些功能,可以提交 PR 嗎?一定會被接受嗎?
Q02:我開發了一些功能,可以提交 PR 嗎?一定會被接受嗎?
Q03:如何設定特定功能?
Q03:如何設定特定功能?
Q04:Python Runner 可以使用哪些 Python 函式庫?
Q04:Python Runner 可以使用哪些 Python 函式庫?
pip 安裝的套件及其他套件均無法使用。伺服器端不需要任何設定。Q05:拼字檢查可以檢查日文或中文嗎?
Q05:拼字檢查可以檢查日文或中文嗎?
Q06:我可以新增外掛嗎?
Q06:我可以新增外掛嗎?
services/web/modules 內的模組,會建置進 Docker 映像檔,並透過本文件中的設定啟用。若要新增您自己的功能,請在原始碼中新增模組並建置您自己的映像檔。部署
Q01:Ayakaleaf Pro 是否支援在 k8s 中進行分散式部署?
Q01:Ayakaleaf Pro 是否支援在 k8s 中進行分散式部署?
Q02:在服務數千名使用者時,如何確保可用性?
Q02:在服務數千名使用者時,如何確保可用性?
Q03:你們可以協助我部署或遷移嗎?
Q03:你們可以協助我部署或遷移嗎?
Q04:我可以將 Ayakaleaf Pro 架設在 URL 子路徑下嗎,例如 https://example.com/overleaf?
Q04:我可以將 Ayakaleaf Pro 架設在 URL 子路徑下嗎,例如 https://example.com/overleaf?
https://overleaf.example.com。Q05:我可以在 Windows 或 macOS 上執行 Ayakaleaf Pro,或不使用 Toolkit 嗎?
Q05:我可以在 Windows 或 macOS 上執行 Ayakaleaf Pro,或不使用 Toolkit 嗎?
docker-compose.yml。若要查看 Toolkit 所使用的 Compose 設定,請在 Toolkit 目錄中執行 bin/docker-compose config。Q06:如何解除安裝 Ayakaleaf Pro?
Q06:如何解除安裝 Ayakaleaf Pro?
- 使用
bin/docker-compose down停止並移除容器。 - 刪除資料。預設情況下,資料位於 Toolkit 的
data/目錄中。如果您在config/overleaf.rc中變更過OVERLEAF_DATA_PATH、MONGO_DATA_PATH、REDIS_DATA_PATH或GIT_BRIDGE_DATA_PATH,也請刪除這些目錄。此操作無法復原,因此若您可能還需要這些資料,請先進行備份。 - 刪除 Toolkit 目錄。
- 移除 Docker 映像檔(可使用
docker images列出):ghcr.io/ayaka-notes/overleaf-pro、git-bridge 映像檔、mongo、redis以及 TeX Live 映像檔。
Q07:如何停止、啟動或重新啟動 Ayakaleaf Pro?
Q07:如何停止、啟動或重新啟動 Ayakaleaf Pro?
bin/stop會停止所有容器,bin/start則會再次啟動它們。容器會被保留,因此使用者會維持登入狀態。bin/up -d會建立容器並在背景中啟動。變更config/variables.env、config/overleaf.rc或config/version後請執行此指令:它會重新建立設定有所變更的容器,變更也只有在此時才會生效。bin/stop與bin/start不會套用這些變更。bin/docker-compose restart sharelatex只會重新啟動 Overleaf 容器,不會套用設定變更。
bin/up 重新建立容器時使用者都會被登出,請設定 OVERLEAF_SESSION_SECRET,請參閱環境變數中的問與答。Q08:OAuth 回呼 URL 要填在哪裡?
Q08:OAuth 回呼 URL 要填在哪裡?
config/variables.env 中都沒有回呼設定:Ayakaleaf Pro 會根據 OVERLEAF_SITE_URL 組出每個回呼 URL 並傳送給供應商,若與應用程式所登錄的 URL 不符,供應商便會拒絕。因此您只需要在供應商處登錄回呼 URL,並將 OVERLEAF_SITE_URL 設為使用者開啟的位址即可。OVERLEAF_SITE_URL(例如改用新網域),也請在每個供應商處更新 URL,否則連結會失敗。Q09:資料儲存在哪裡?我需要多少磁碟空間?
Q09:資料儲存在哪裡?我需要多少磁碟空間?
data/ 目錄中:data/overleaf(專案檔案、歷程記錄與編譯輸出)、data/mongo 與 data/redis。對於使用者少於 1000 人的執行個體,我們建議使用本機磁碟並定期進行備份。Ayakaleaf Pro 映像檔約佔 5 GB。簡介中提到的 40 GB 最低需求是針對沙箱編譯,其每個 texlive-full 映像檔約佔 28 GB。若未使用沙箱編譯,編譯會在 sharelatex 容器內以 TeX Live basic scheme 加上 latexmk、texcount、synctex、etoolbox 與 xetex 執行,因此許多專案會因缺少套件而失敗。之後 data/ 目錄會隨著您的專案及其歷程記錄而增長;可使用 du -sh data/* 檢查。Q10:我可以讓 Ayakaleaf 在 Windows 上全天候 24 小時執行嗎?
Q10:我可以讓 Ayakaleaf 在 Windows 上全天候 24 小時執行嗎?
restart: always 原則,並在使用交流電源時停用自動睡眠與休眠。螢幕可以關閉;筆電上蓋的行為是另一項獨立設定。在執行 bin/up -d 後關閉 Ubuntu 終端機,並不會停止以分離模式執行的容器。結束 Docker Desktop、暫停其引擎或執行 wsl --shutdown 則會中斷服務。Docker Desktop 的 Resource Saver 與 Windows 睡眠不同:它只在沒有任何容器執行時才會生效,因此正在執行的 Ayakaleaf 堆疊不會只因為沒有人在編輯就被視為閒置。Windows 重新開機後,登入時啟動的設定仍需要有人登入。檢查與復原步驟請參閱保持執行個體可用。當可用性不能依賴互動式桌面登入時,我們仍建議使用 Linux。Q11:Docker Desktop 顯示虛擬化已停用。我需要 Hyper-V 嗎?
Q11:Docker Desktop 顯示虛擬化已停用。我需要 Hyper-V 嗎?
wsl --list --verbose。像 0x80370102 這類錯誤可能表示虛擬化、該 Windows 功能或開機 hypervisor 已停用。請參閱 Windows 安裝疑難排解步驟,其中附有 Microsoft 與 Docker 的修復連結。啟用必要功能後請重新啟動 Windows;重新安裝 Ayakaleaf 無法修復無法啟動的 Docker 引擎。LaTeX
Q01:使用者的 LaTeX 專案編譯是否相互隔離?是否啟用 Shell Escape?
Q01:使用者的 LaTeX 專案編譯是否相互隔離?是否啟用 Shell Escape?
Q02:沙箱編譯的映像檔可靠嗎?編譯可能會失敗嗎?
Q02:沙箱編譯的映像檔可靠嗎?編譯可能會失敗嗎?
Q03:我的專案無法編譯,可以協助我排除問題嗎?
Q03:我的專案無法編譯,可以協助我排除問題嗎?

