使用 GitHub Codespace

测试 Ayakaleaf Pro 最简单的方式是使用 GitHub Codespace，其中所有环境变量都已预先配置，确保你可以开箱即用。

使用 GitHub Codespaces 运行 Docker 容器时，Codespace 不会自动关闭，并会持续计费。有关 GitHub Codespaces 的计费规则，请参阅 GitHub Codespaces 计费规则。

要管理你的 GitHub Codespaces，请访问 https://github.com/codespaces。当你不再需要时，请及时删除你的 Codespace。

我们已预先配置了以下功能：

• 使用 TeXLive Basic（2024-2026）的沙箱化 LaTeX 编译
• Pandoc 导入/导出（SaaS 平台功能）
• Python 脚本运行器（SaaS 平台功能）
• Git-Bridge 支持（Server Pro 功能）
• 高级参考文献搜索（SaaS 平台功能）
• 管理面板（全局用户/项目管理）
• 修订追踪（含审阅和评论面板）
• 完整的项目历史记录（支持恢复和下载）
• 符号面板（Server Pro/SaaS 平台功能）

标准 GitHub Codespaces 提供 32 GB 存储空间，不足以安装我们的 texlive-full。如需测试完整镜像，请向 GitHub 提交支持工单，申请使用大型运行器（8 核以上）的 Codespace。

GitHub 同步、LDAP、OAuth、SSO、Zotero 集成等功能在此演练环境中 均未配置。关于如何在你自己的部署中配置这些功能，可参阅 Toolkit 设置了解更多详情。

1. 创建你的 GitHub Codespace

   点击下面的按钮创建你的 GitHub Codespace。在服务器配置方面，对于测试用途，2 核 8 GB 内存通常已经足够。如果你计划使用 TeX Live Full，我们建议选择 8 核 64GB 的配置。

   

2. 初始化 Overleaf 实例

   Codespace 准备就绪后，在 bash 中运行以下命令来初始化你的 Overleaf 实例。

   bash

   ./init.sh
   

   你可能需要等待至少 3 分钟，以便拉取所需的全部 Docker 镜像。

   
3. 开放 80 端口

   切换到 Ports 标签页，然后按照以下步骤将 80 端口设为公开。

   

   之后，你可以点击 Forwarded Address 访问你的 Overleaf 实例。你可能需要在地址后添加 /launchpad 才能访问 Overleaf 欢迎页面。

4. 创建管理员账户

   输入管理员账户和密码，然后点击 Register 按钮。

   
5. 开始写作

   现在，尽情享受 $\LaTeX$ 写作吧！

   

​

使用 TeXLive Full 镜像

如果你可以使用 8 核/64 GB 的 GitHub Codespaces，就可以在此演练环境中使用 TeXLive Full 镜像。你可以修改 toolkit/config/variables.env 文件中的以下环境变量，以使用 TeXLive Full 镜像代替 TeXLive Basic 镜像。

ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1, ghcr.io/ayaka-notes/texlive-full:2024.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025, Texlive 2024
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1

修改环境变量后，你需要重启 Toolkit 才能使更改生效。可以运行以下命令重启 Toolkit。

cd toolkit && bin/up -d