GitHub Codespace Kullanma

Ayakaleaf Pro’yu denemenin en kolay yolu GitHub Codespace kullanmaktır; burada tüm ortam değişkenleri önceden yapılandırılmıştır, böylece kutudan çıktığı gibi kullanabilirsiniz.

GitHub Codespaces ile Docker konteynerleri çalıştırdığınızda Codespace otomatik olarak kapanmaz ve ücretlendirilmeye devam eder. GitHub Codespaces faturalandırma kuralları için lütfen github codespaces billing rules sayfasına bakın.

GitHub Codespaces’inizi yönetmek için lütfen https://github.com/codespaces adresini ziyaret edin. Artık ihtiyacınız olmadığında lütfen Codespace’inizi zamanında silin.

Aşağıdaki özellikleri önceden yapılandırdık:

• TeXLive Basic (2024-2026) ile korumalı alanda (sandbox) LaTeX derlemesi
• Pandoc İçe/Dışa Aktarma (SaaS Platformundaki özellikler)
• Python Betik Çalıştırıcı (SaaS Platformundaki özellikler)
• Git-Bridge Desteği (Server Pro’daki özellikler)
• Gelişmiş Kaynakça Arama (SaaS Platformundaki özellikler)
• Yönetici Paneli (Genel Kullanıcı/Proje yönetimi)
• Değişiklikleri İzleme (İnceleme ve Yorum Paneli ile)
• Tam Proje Geçmişi (Geri Yükleme ve İndirme ile)
• Symbol Palette (Server Pro/SaaS Platformundaki özellikler)

Standart GitHub Codespaces 32 GB depolama alanı sağlar. Bu, texlive-full kurulumumuz için yetersizdir. Tam imajı denemek için, büyük çalıştırıcılara (8 çekirdek+) sahip bir Codespace talebiyle GitHub destek kaydı oluşturun.

GitHub Sync, LDAP, OAuth, SSO, Zotero Entegrasyonu ve diğer özellikler bu deneme ortamında yapılandırılmamıştır. Bu özellikleri kendi dağıtımınızda nasıl yapılandıracağınıza ilişkin daha fazla ayrıntı için toolkit ayarlarına bakabilirsiniz.

1. GitHub Codespace'inizi Oluşturun

   GitHub Codespace’inizi oluşturmak için aşağıdaki düğmeye tıklayın. Sunucu yapılandırması açısından, bir test senaryosu için genellikle 2 çekirdek ve 8 GB RAM yeterlidir. TeX Live Full kullanmayı planlıyorsanız 8 çekirdek 64 GB yapılandırmasını seçmenizi öneririz.

   

2. Overleaf Örneğini Başlatın

   Codespace’iniz hazır olduğunda, Overleaf örneğinizi başlatmak için bash’te aşağıdaki komutu çalıştırın.

   bash

   ./init.sh
   

   İhtiyacınız olan tüm Docker imajları çekilene kadar en az 3 dakika beklemeniz gerekebilir.

   
3. 80 Numaralı Bağlantı Noktasını Erişilebilir Yapın

   Ports sekmesine geçin ve ardından 80 numaralı bağlantı noktasını herkese açık yapmak için şu adımları izleyin.

   

   Bundan sonra Overleaf örneğinizi ziyaret etmek için Forwarded Address öğesine tıklayabilirsiniz. Overleaf karşılama sayfasını ziyaret etmek için adrese /launchpad eklemeniz gerekebilir.

4. Yönetici Hesabınızı Oluşturun

   Yönetici hesabınızı ve parolanızı girin, ardından Register düğmesine tıklayın.

   
5. Yazmanın Keyfini Çıkarın

   Artık $\LaTeX$ ile yazmanın keyfini çıkarma zamanı!

   

​

TeXLive Full İmajını Kullanma

8 çekirdek/64 GB GitHub Codespaces’e erişiminiz varsa, bu deneme ortamında TeXLive Full imajını kullanabilirsiniz. TeXLive Basic imajı yerine TeXLive Full imajını kullanmak için toolkit/config/variables.env dosyasında aşağıdaki ortam değişkenlerini değiştirebilirsiniz.

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

Ortam değişkenlerini değiştirdikten sonra, değişiklikleri uygulamak için toolkit’i yeniden başlatmanız gerekir. Toolkit’i yeniden başlatmak için aşağıdaki komutu çalıştırabilirsiniz.

cd toolkit && bin/up -d