> ## 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.

# Korzystanie z GitHub Codespace

Najłatwiejszym sposobem na przetestowanie Ayakaleaf Pro jest użycie GitHub Codespace, w którym wszystkie zmienne środowiskowe są wstępnie skonfigurowane, dzięki czemu możesz korzystać z niego od razu.

<Warning>
  Gdy uruchamiasz kontenery Docker w GitHub Codespaces, Codespace nie wyłączy się automatycznie i nadal będzie **naliczana opłata**. Zasady rozliczeń GitHub Codespaces znajdziesz w [zasadach rozliczeń github codespaces](https://docs.github.com/en/billing/concepts/product-billing/github-codespaces).

  Aby zarządzać swoimi GitHub Codespaces, odwiedź [https://github.com/codespaces](https://github.com/codespaces). Gdy Codespace przestanie być potrzebny, usuń go w odpowiednim czasie.
</Warning>

**Wstępnie skonfigurowaliśmy** następujące funkcje:

* [x] Kompilacja LaTeX w piaskownicy z TeXLive **Basic** (2024-2026)
* [x] Import/eksport Pandoc (funkcja platformy SaaS)
* [x] Uruchamianie skryptów Python (funkcja platformy SaaS)
* [x] Obsługa Git-Bridge (funkcja Server Pro)
* [x] Zaawansowane wyszukiwanie bibliografii (funkcja platformy SaaS)
* [x] Panel administratora (globalne zarządzanie użytkownikami/projektami)
* [x] Śledzenie zmian (z panelem recenzji i komentarzy)
* [x] Pełna historia projektu (z przywracaniem i pobieraniem)
* [x] Paleta symboli (funkcja Server Pro/platformy SaaS)

<Warning>
  Standardowe GitHub Codespaces zapewniają 32 GB przestrzeni dyskowej. To za mało dla naszej instalacji `texlive-full`. Aby przetestować pełny obraz, złóż zgłoszenie do pomocy technicznej GitHub o Codespace z dużymi maszynami (8+ rdzeni).
</Warning>

GitHub Sync, LDAP, OAuth, SSO, integracja z Zotero i inne funkcje ***nie są skonfigurowane*** w tym środowisku testowym. Więcej informacji o konfigurowaniu tych funkcji we własnym wdrożeniu znajdziesz w [ustawieniach toolkit](/pl/on-premises/configuration/overleaf-toolkit/toolkit-settings).

<Steps>
  <Step title="Utwórz GitHub Codespace">
    Kliknij poniższy przycisk, aby utworzyć GitHub Codespace. Jeśli chodzi o konfigurację serwera, do testów zazwyczaj wystarczą **2 rdzenie i 8 GB RAM**. Jeśli planujesz używać [**TeX Live Full**](https://github.com/ayaka-notes/texlive-full), zalecamy wybranie konfiguracji z **8 rdzeniami i 64 GB**.

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

  <Step title="Zainicjuj instancję Overleaf">
    Gdy Codespace będzie gotowy, uruchom w bashu poniższe polecenie, aby zainicjować instancję Overleaf.

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

    <Info>
      Pobranie wszystkich potrzebnych obrazów Docker może potrwać co najmniej 3 minuty.
    </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="Udostępnij port 80">
    Przejdź do karty **Ports**, a następnie wykonaj poniższe kroki, aby ustawić port 80 jako publiczny.

    <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>

    Następnie możesz kliknąć **Forwarded Address**, aby otworzyć swoją instancję Overleaf. Aby wyświetlić stronę powitalną Overleaf, może być konieczne dopisanie `/launchpad`.
  </Step>

  <Step title="Utwórz konto administratora">
    Wprowadź nazwę konta administratora i hasło, a następnie kliknij przycisk 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="Miłego pisania">
    Teraz możesz cieszyć się pisaniem w $\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>

#### Użycie pełnego obrazu TeXLive

Jeśli masz dostęp do GitHub Codespaces z 8 rdzeniami/64 GB, możesz użyć w tym środowisku testowym obrazu TeXLive Full. Aby używać obrazu TeXLive Full zamiast TeXLive Basic, zmień poniższe zmienne środowiskowe w pliku `toolkit/config/variables.env`.

```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
```

Po zmianie zmiennych środowiskowych musisz zrestartować toolkit, aby zastosować zmiany. Możesz to zrobić za pomocą poniższego polecenia.

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


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