> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sử dụng GitHub Codespace

Cách dễ nhất để dùng thử Ayakaleaf Pro là sử dụng GitHub Codespace, nơi tất cả biến môi trường đã được cấu hình sẵn để bạn có thể dùng ngay.

<Warning>
  Khi bạn chạy các container Docker bằng GitHub Codespaces, Codespace sẽ không tự động tắt và sẽ tiếp tục bị **tính phí**. Về quy tắc tính phí của GitHub Codespaces, vui lòng tham khảo [github codespaces billing rules](https://docs.github.com/en/billing/concepts/product-billing/github-codespaces).

  Để quản lý GitHub Codespaces của bạn, vui lòng truy cập [https://github.com/codespaces](https://github.com/codespaces). Khi không còn cần dùng nữa, hãy xóa Codespace của bạn kịp thời.
</Warning>

Chúng tôi đã **cấu hình sẵn** các tính năng sau:

* [x] Biên dịch LaTeX trong sandbox với TeXLive **Basic** (2024-2026)
* [x] Nhập/Xuất bằng Pandoc (tính năng của nền tảng SaaS)
* [x] Trình chạy script Python (tính năng của nền tảng SaaS)
* [x] Hỗ trợ Git-Bridge (tính năng của Server Pro)
* [x] Tìm kiếm tài liệu tham khảo nâng cao (tính năng của nền tảng SaaS)
* [x] Bảng quản trị (quản lý người dùng/dự án toàn cục)
* [x] Theo dõi thay đổi (kèm bảng Review và Comment)
* [x] Toàn bộ lịch sử dự án (kèm khôi phục và tải xuống)
* [x] Bảng ký hiệu (tính năng của Server Pro/nền tảng SaaS)

<Warning>
  GitHub Codespaces tiêu chuẩn cung cấp 32 GB dung lượng lưu trữ. Dung lượng này không đủ cho bản cài đặt `texlive-full` của chúng tôi. Để dùng thử image đầy đủ, hãy gửi yêu cầu hỗ trợ tới GitHub để có Codespace với large runner (từ 8 lõi trở lên).
</Warning>

GitHub Sync, LDAP, OAuth, SSO, tích hợp Zotero và các tính năng khác ***chưa được cấu hình*** trong môi trường thử nghiệm này. Bạn có thể tham khảo [cài đặt toolkit](/vi/on-premises/configuration/overleaf-toolkit/toolkit-settings) để biết thêm chi tiết về cách cấu hình các tính năng này trong triển khai của riêng bạn.

<Steps>
  <Step title="Tạo GitHub Codespace của bạn">
    Nhấp vào nút sau để tạo GitHub Codespace của bạn. Về cấu hình máy chủ, **2 lõi với 8 GB RAM** thường là đủ cho mục đích thử nghiệm. Nếu bạn định sử dụng [**TeX Live Full**](https://github.com/ayaka-notes/texlive-full), chúng tôi khuyến nghị chọn cấu hình **8 lõi 64GB**.

    [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/ayaka-notes/ayakaleaf-pro-playground)
  </Step>

  <Step title="Khởi tạo phiên bản Overleaf">
    Khi codespace đã sẵn sàng, hãy chạy lệnh sau trong bash để khởi tạo phiên bản Overleaf của bạn.

    ```bash title="bash" theme={null}
    ./init.sh
    ```

    <Info>
      Bạn có thể cần đợi ít nhất 3 phút để chúng tôi tải về tất cả các Docker image cần thiết.
    </Info>

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-26.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=8566b61de0757c1b270e7e5011d48a3e" alt="" width="1181" height="626" data-path="images/on-premises/image-26.png" />
    </Frame>
  </Step>

  <Step title="Mở cổng 80">
    Chuyển sang tab **Ports**, sau đó làm theo các bước sau để đặt cổng 80 ở chế độ công khai.

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/GmaXa-Cu4QQRFT4C/images/on-premises/img-db37d3e4.png?fit=max&auto=format&n=GmaXa-Cu4QQRFT4C&q=85&s=81e5a18f3aebbd396a57d163a2460739" alt="" width="1452" height="694" data-path="images/on-premises/img-db37d3e4.png" />
    </Frame>

    Sau đó, bạn có thể nhấp vào **Forwarded Address** để truy cập phiên bản Overleaf của mình. Bạn có thể cần thêm `/launchpad` để truy cập trang chào mừng của Overleaf.
  </Step>

  <Step title="Tạo tài khoản quản trị viên">
    Nhập tài khoản và mật khẩu quản trị viên, sau đó nhấp nút Register.

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/img-1ae40ae0.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=82d769561891fd4b4566ee2ad9c48065" alt="" width="2736" height="1798" data-path="images/on-premises/img-1ae40ae0.png" />
    </Frame>
  </Step>

  <Step title="Tận hưởng việc viết">
    Giờ là lúc tận hưởng việc soạn thảo $\LaTeX$!

    <Frame>
      <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-25.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=1d4e1fac863cbee906d9d3ad2f3c08d7" alt="" width="2104" height="1415" data-path="images/on-premises/image-25.png" />
    </Frame>
  </Step>
</Steps>

#### Sử dụng image TeXLive Full

Nếu bạn có quyền truy cập GitHub Codespaces 8 lõi/64 GB, bạn có thể sử dụng image TeXLive Full trong môi trường thử nghiệm này. Bạn có thể thay đổi các biến môi trường sau trong tệp `toolkit/config/variables.env` để dùng image TeXLive Full thay cho image TeXLive Basic.

```dotenv wrap theme={null}
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
```

Sau khi thay đổi biến môi trường, bạn cần khởi động lại toolkit để áp dụng thay đổi. Bạn có thể chạy lệnh sau để khởi động lại toolkit.

```bash theme={null}
cd toolkit && bin/up -d
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.