publish-to-pages

Publique qualquer apresentação ou conteúdo web no GitHub Pages de uma só vez.

1. Verificação de Pré-requisitos

Execute estes silenciosamente. Apenas mostre erros:

command -v gh >/dev/null || echo "MISSING: gh CLI — install from https://cli.github.com"
gh auth status &>/dev/null || echo "MISSING: gh not authenticated — run 'gh auth login'"
command -v python3 >/dev/null || echo "MISSING: python3 (needed for PPTX conversion)"

poppler-utils é opcional (conversão de PDF via pdftoppm). Não bloqueie por causa disso.

2. Detecção de Entrada

Determine o tipo de entrada a partir do que o usuário fornece:

Peça ao usuário um nome de repositório se não for fornecido. Padrão: nome do arquivo sem extensão.

3. Conversão

Tratamento de Arquivos Grandes

Ambos os scripts de conversão detectam automaticamente arquivos grandes e mudam para o modo de ativos externos:

• PPTX: Arquivos >20MB ou com >50 imagens → imagens salvas como arquivos separados em assets/
• PDF: Arquivos >20MB ou com >50 páginas → PNGs de página salvos em assets/
• Arquivos >150MB imprimem um aviso (PPTX sugere o caminho do PDF em vez disso)

Isso mantém os arquivos individuais bem abaixo do limite de 100MB do GitHub. Arquivos pequenos ainda produzem um único HTML autocontido.

Você pode forçar o comportamento com --external-assets ou --no-external-assets.

HTML

Nenhuma conversão necessária. Use o arquivo diretamente como index.html.

PPTX

Execute o script de conversão:

python3 SKILL_DIR/scripts/convert-pptx.py INPUT_FILE /tmp/output.html
# For large files, force external assets:
python3 SKILL_DIR/scripts/convert-pptx.py INPUT_FILE /tmp/output.html --external-assets

Se python-pptx estiver faltando, diga ao usuário: pip install python-pptx

PDF

Converta com o script incluído (requer poppler-utils para pdftoppm):

python3 SKILL_DIR/scripts/convert-pdf.py INPUT_FILE /tmp/output.html
# For large files, force external assets:
python3 SKILL_DIR/scripts/convert-pdf.py INPUT_FILE /tmp/output.html --external-assets

Cada página é renderizada como um PNG e incorporada ao HTML com navegação de slides. Se pdftoppm estiver faltando, diga ao usuário: apt install poppler-utils (ou brew install poppler no macOS).

Google Slides

1. Extraia o ID da apresentação da URL (a string longa entre /d/ e /)
2. Baixe como PPTX:

curl -L "https://docs.google.com/presentation/d/PRESENTATION_ID/export/pptx" -o /tmp/slides.pptx

3. Em seguida, converta o PPTX usando o script de conversão acima.

4. Publicação

Visibilidade

Repositórios são criados públicos por padrão. Se o usuário especificar private (ou quiser um repositório privado), use --private — mas observe que o GitHub Pages em repositórios privados requer um plano Pro, Team ou Enterprise.

Publicar

bash SKILL_DIR/scripts/publish.sh /path/to/index.html REPO_NAME public "Description"

Passe private em vez de public se o usuário solicitar.

O script cria o repositório, envia index.html (mais assets/ se presente) e habilita o GitHub Pages.

Observação: Quando o modo de ativos externos é usado, o HTML de saída referencia arquivos em assets/. O script de publicação detecta e copia automaticamente o diretório assets/ ao lado do arquivo HTML. Certifique-se de que o arquivo HTML e seu diretório assets/ estejam no mesmo diretório pai.

5. Saída

Diga ao usuário:

• Repositório: https://github.com/USERNAME/REPO_NAME
• URL ao vivo: https://USERNAME.github.io/REPO_NAME/
• Observação: O Pages leva de 1 a 2 minutos para ficar ativo.

Tratamento de Erros

• Repositório já existe: Sugira adicionar um número (my-slides-2) ou uma data (my-slides-2026).
• Falha na habilitação do Pages: Ainda retorne a URL do repositório. O usuário pode habilitar o Pages manualmente nas Configurações do repositório.
• Falha na conversão de PPTX: Diga ao usuário para executar pip install python-pptx.
• Falha na conversão de PDF: Sugira instalar poppler-utils (apt install poppler-utils ou brew install poppler).
• Falha no download do Google Slides: A apresentação pode não estar acessível publicamente. Peça ao usuário para torná-la visualizável ou baixar o PPTX manualmente.