🚀 Próximos Passos para Publicar o Site

SuperProfessores - Guia Rápido de Publicação

✅ O Que Já Está Pronto

  • Estrutura do site configurada (Jekyll + Just-the-Docs)
  • Paleta de cores personalizada
  • Landing page profissional (index.md)
  • Página de documentação organizada
  • Guias de customização e estrutura
  • Configuração do GitHub Pages (_config.yml)
  • .gitignore configurado

📋 Checklist de Publicação

1️⃣ OPCIONAL: Criar Logo (5-10 min)

Você pode pular isso e publicar sem logo primeiro.

Se quiser criar:

  1. Acesse: https://canva.com
  2. Template: “Logo” (150x150px)
  3. Cores: Azul #4a90e2
  4. Ícones: 🎓, 🧠, 🤖
  5. Texto: “SP” ou “SuperProf”
  6. Baixe como PNG
  7. Salve em: assets/images/logo.png
mkdir -p assets/images
# Coloque o logo.png lá

Ou pule e adicione depois!

2️⃣ Inicializar Git e Fazer Commit (2 min) 

# Navegue até o projeto
cd /home/nmaldaner/projetos/superprofessores

# Inicialize git (se ainda não fez)
git init

# Configure suas credenciais
git config user.name "inematds"
git config user.email "inematds@gmail.com"

# Adicione APENAS os arquivos necessários
git add index.md _config.yml _sass/ doc/ README.md .gitignore
git add GUIA_GITHUB_PAGES.md CUSTOMIZACAO_VISUAL.md ESTRUTURA_SITE.md
git add package.json

# Commit
git commit -m "Initial commit: SuperProfessores v3.0 com Jekyll"

3️⃣ Criar Repositório no GitHub (2 min)

Opção A: Via Interface Web (Recomendado)

  1. Acesse: https://github.com/new
  2. Repository name: SuperProf
  3. Description: SuperProfessores: Transformando educadores em arquitetos do futuro da aprendizagem
  4. Público ✅
  5. NÃO marque “Add a README” (já temos)
  6. Clique “Create repository”

Opção B: Via GitHub CLI (se tiver instalado)

gh repo create SuperProf --public --description "SuperProfessores: Programa de formação em IA para educadores"

4️⃣ Conectar Local ao GitHub (1 min) 

# Adicione o remote
git remote add origin https://github.com/inematds/SuperProf.git

# Verifique
git remote -v

# Renomeie branch para main
git branch -M main

# Faça o push
git push -u origin main

Se pedir senha:

5️⃣ Ativar GitHub Pages (1 min)

  1. Vá para: https://github.com/inematds/SuperProf/settings/pages
  2. Em “Source”, selecione: “Deploy from a branch”
  3. Em “Branch”, selecione: main e / (root)
  4. Clique “Save”

Aguarde 2-3 minutos!

6️⃣ Verificar o Site (1 min)

  1. Acesse: https://inematds.github.io/SuperProf
  2. Se não carregar, aguarde mais 1-2 min
  3. Verifique o status do deploy em: https://github.com/inematds/SuperProf/actions

Deve aparecer um check verde ✅

🎨 Customizações DEPOIS (Opcional)

Você pode fazer isso após o site estar no ar:

# Coloque logo.png em assets/images/
git add assets/images/logo.png
git commit -m "Add logo"
git push

Mudar Cores

Edite _sass/color_schemes/superprofessores.scss:

$blue-300: #SUA_COR;

git add _sass/
git commit -m "Update color scheme"
git push

Adicionar Google Analytics

  1. Crie conta: https://analytics.google.com
  2. Obtenha ID: G-XXXXXXXXXX
  3. Adicione no _config.yml:
google_analytics: G-XXXXXXXXXX

git add _config.yml
git commit -m "Add Google Analytics"
git push

🐛 Se Algo Der Errado

Erro: “Permission denied” 

# Configure SSH ou use token
# Token: https://github.com/settings/tokens

Erro: “Page build failed”

  1. Vá para: https://github.com/inematds/SuperProf/actions
  2. Clique no workflow com ❌
  3. Veja o erro nos logs
  4. Comum: YAML inválido no front matter

Site mostra 404

  • Aguarde 5 minutos
  • Force refresh: Ctrl+F5 (Windows) ou Cmd+Shift+R (Mac)
  • Verifique se GitHub Pages está ativado

📊 Após Publicar

Compartilhe!

  • Compartilhe no LinkedIn
  • Poste no Twitter/X
  • Envie para grupos de educadores
  • Submeta para comunidades (Reddit r/教育, r/teachers)

Monitore

  • Ative Google Analytics
  • Veja tráfego em: https://github.com/inematds/SuperProf/graphs/traffic
  • Responda issues: https://github.com/inematds/SuperProf/issues

Melhore

  • Adicione logo
  • Crie vídeo de apresentação
  • Adicione depoimentos
  • Crie página de FAQ
  • Adicione formulário de inscrição (Google Forms)

🎯 Comandos Resumidos (Copy-Paste)

Para publicar AGORA (sem logo):

# 1. Vá para o diretório
cd /home/nmaldaner/projetos/superprofessores

# 2. Git init e config
git init
git config user.name "inematds"
git config user.email "inematds@gmail.com"

# 3. Add e commit
git add index.md _config.yml _sass/ doc/ README.md .gitignore GUIA_GITHUB_PAGES.md CUSTOMIZACAO_VISUAL.md ESTRUTURA_SITE.md package.json
git commit -m "Initial commit: SuperProfessores v3.0 com Jekyll"

# 4. Conecte ao GitHub (crie o repo primeiro em github.com/new)
git remote add origin https://github.com/inematds/SuperProf.git
git branch -M main
git push -u origin main

# 5. Ative GitHub Pages em:
# https://github.com/inematds/SuperProf/settings/pages
# Source: Deploy from branch > main > / (root) > Save

# 6. Aguarde 2-3 min e acesse:
# https://inematds.github.io/SuperProf

📞 Precisa de Ajuda?

  • Documentação: Veja GUIA_GITHUB_PAGES.md
  • Customização: Veja CUSTOMIZACAO_VISUAL.md
  • Estrutura: Veja ESTRUTURA_SITE.md
  • Email: inematds@gmail.com

🎉 Tudo Pronto!

Após seguir esses passos, seu site estará ONLINE em:

https://inematds.github.io/SuperProf

Com:

  • ✅ Design profissional
  • ✅ Navegação intuitiva
  • ✅ Busca integrada
  • ✅ Responsivo (mobile-friendly)
  • ✅ Diagramas (Mermaid)
  • ✅ SEO otimizado

Lembre-se: Você pode melhorar o site aos poucos. O importante é PUBLICAR e começar a receber feedback!

Boa sorte! 🚀