Usar o GitHub Codespace

A maneira mais fácil de testar o nosso Ayakaleaf Pro é usar o GitHub Codespace, onde todas as variáveis de ambiente já vêm pré-configuradas para que você possa usá-lo imediatamente.

Quando você executa contêineres Docker usando o GitHub Codespaces, o Codespace não é desligado automaticamente e continuará sendo cobrado. Para as regras de cobrança do GitHub Codespaces, consulte as regras de cobrança do github codespaces.

Para gerenciar seus GitHub Codespaces, acesse https://github.com/codespaces. Quando não precisar mais dele, exclua seu Codespace o quanto antes.

Pré-configuramos os seguintes recursos:

• Compilação LaTeX em sandbox com TeXLive Basic (2024-2026)
• Importação/exportação com Pandoc (recurso da plataforma SaaS)
• Executor de scripts Python (recurso da plataforma SaaS)
• Suporte ao Git-Bridge (recurso do Server Pro)
• Pesquisa avançada de referências (recurso da plataforma SaaS)
• Painel de administração (gerenciamento global de usuários/projetos)
• Controle de alterações (com painel de revisão e comentários)
• Histórico completo do projeto (com restauração e download)
• Paleta de símbolos (recurso do Server Pro/plataforma SaaS)

Os GitHub Codespaces padrão oferecem 32 GB de armazenamento. Isso é insuficiente para a nossa instalação texlive-full. Para testar a imagem completa, abra um chamado no suporte do GitHub solicitando um Codespace com runners maiores (8 núcleos ou mais).

Sincronização com GitHub, LDAP, OAuth, SSO, integração com Zotero e outros recursos não estão configurados neste playground. Você pode consultar as configurações do Toolkit para mais detalhes sobre como configurar esses recursos na sua própria implantação.

1. Criar seu GitHub Codespace

   Clique no botão a seguir para criar seu GitHub Codespace. Em termos de configuração do servidor, 2 núcleos com 8 GB de RAM geralmente são suficientes para um teste. Se você planeja usar o TeX Live Full, recomendamos escolher uma configuração com 8 núcleos e 64 GB.

   

2. Inicializar a instância do Overleaf

   Quando seu codespace estiver pronto, execute o seguinte comando no bash para inicializar sua instância do Overleaf.

   bash

   ./init.sh
   

   Talvez seja necessário aguardar pelo menos 3 minutos até que todas as imagens Docker necessárias sejam baixadas.

   
3. Tornar a porta 80 disponível

   Mude para a aba Ports e siga estas etapas para tornar a porta 80 pública.

   

   Depois disso, você pode clicar em Forwarded Address para acessar sua instância do Overleaf. Talvez seja necessário adicionar /launchpad para acessar a página de boas-vindas do Overleaf.

4. Criar sua conta de administrador

   Informe a conta e a senha do administrador e clique no botão Register.

   
5. Aproveite a escrita

   Agora é hora de aproveitar sua escrita em $\LaTeX$!

   

​

Usar a imagem TeXLive Full

Se você tiver acesso a GitHub Codespaces com 8 núcleos/64 GB, poderá usar a imagem TeXLive Full neste playground. Você pode alterar as seguintes variáveis de ambiente no arquivo toolkit/config/variables.env para usar a imagem TeXLive Full em vez da imagem 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

Após alterar as variáveis de ambiente, é necessário reiniciar o Toolkit para aplicar as alterações. Você pode executar o seguinte comando para reiniciá-lo.

cd toolkit && bin/up -d