Menggunakan GitHub Codespace

Cara termudah untuk mencoba Ayakaleaf Pro adalah dengan menggunakan GitHub Codespace, di mana semua variabel lingkungan sudah dikonfigurasi sebelumnya sehingga Anda dapat langsung menggunakannya.

Saat Anda menjalankan kontainer Docker menggunakan GitHub Codespaces, Codespace tidak akan mati secara otomatis dan akan terus ditagih. Untuk aturan penagihan GitHub Codespaces, silakan lihat aturan penagihan github codespaces.

Untuk mengelola GitHub Codespaces Anda, silakan kunjungi https://github.com/codespaces. Jika Anda tidak lagi membutuhkannya, segera hapus Codespace Anda.

Kami telah mengonfigurasi sebelumnya fitur-fitur berikut:

• Kompilasi LaTeX dalam sandbox dengan TeXLive Basic (2024-2026)
• Impor/Ekspor Pandoc (Fitur di Platform SaaS)
• Python Script Runner (Fitur di Platform SaaS)
• Dukungan Git-Bridge (Fitur di Server Pro)
• Pencarian Referensi Lanjutan (Fitur di Platform SaaS)
• Panel Admin (Manajemen Pengguna/Proyek global)
• Track Changes (Dengan Panel Review dan Komentar)
• Riwayat Proyek Lengkap (Dengan Pemulihan dan Unduhan)
• Symbol Palette (Fitur di Server Pro/Platform SaaS)

GitHub Codespaces standar menyediakan penyimpanan 32 GB. Ini tidak cukup untuk instalasi texlive-full kami. Untuk mencoba image lengkap, ajukan tiket dukungan GitHub untuk mendapatkan Codespace dengan large runner (8 core+).

Sinkronisasi GitHub, LDAP, OAuth, SSO, Integrasi Zotero, dan fitur lainnya tidak dikonfigurasi di playground ini. Anda dapat merujuk ke pengaturan toolkit untuk detail lebih lanjut tentang cara mengonfigurasi fitur-fitur ini di deployment Anda sendiri.

1. Buat GitHub Codespace Anda

   Klik tombol berikut untuk membuat GitHub Codespace Anda. Dari segi konfigurasi server, 2 core dengan RAM 8 GB umumnya sudah cukup untuk pengujian. Jika Anda berencana menggunakan TeX Live Full, kami menyarankan memilih konfigurasi 8 core 64GB.

   

2. Inisialisasi Instans Overleaf

   Setelah codespace Anda siap, jalankan perintah berikut di bash untuk menginisialisasi instans Overleaf Anda.

   bash

   ./init.sh
   

   Anda mungkin perlu menunggu setidaknya 3 menit hingga semua image Docker yang Anda perlukan selesai ditarik.

   
3. Jadikan Port 80 Tersedia

   Beralih ke tab Ports, lalu ikuti langkah-langkah berikut untuk menjadikan port 80 publik.

   

   Setelah itu, Anda dapat mengklik Forwarded Address untuk mengunjungi instans Overleaf Anda. Anda mungkin perlu menambahkan /launchpad untuk mengunjungi halaman selamat datang Overleaf.

4. Buat Akun Admin Anda

   Masukkan akun dan kata sandi admin Anda, lalu klik tombol Register.

   
5. Selamat Menulis

   Sekarang, saatnya menikmati menulis $\LaTeX$ Anda!

   

​

Menggunakan Image TeXLive Full

Jika Anda memiliki akses ke GitHub Codespaces 8-core/64 GB, Anda dapat menggunakan image TeXLive Full di playground ini. Anda dapat mengubah variabel lingkungan berikut di file toolkit/config/variables.env untuk menggunakan image TeXLive Full alih-alih image 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

Setelah mengubah variabel lingkungan, Anda perlu memulai ulang toolkit agar perubahan diterapkan. Anda dapat menjalankan perintah berikut untuk memulai ulang toolkit.

cd toolkit && bin/up -d