Projeto:Galo Digital/Documentação/Common.css

MediaWiki:Common.css – Manual Técnico

Este documento descreve, organiza e normatiza o uso do arquivo MediaWiki:Common.css no projeto Wiki Galo Digital.

O Common.css é a camada global de estilo da wiki. Qualquer alteração neste arquivo afeta múltiplos namespaces, templates e módulos, devendo ser feita com critério técnico, rastreabilidade e consciência de impacto sistêmico.

---

Finalidade do Common.css

O arquivo MediaWiki:Common.css tem como objetivos:

• Padronizar a apresentação visual da wiki
• Corrigir inconsistências históricas de skins e navegadores
• Definir estilos reutilizáveis para templates e módulos
• Sustentar a automação editorial via Scribunto
• Evitar CSS inline ou acoplado a templates

---

Princípios editoriais e técnicos

• CSS global deve ser:
  • Reutilizável
  • Documentado
  • Comentado
  • Conservador
• Regras locais devem ser preferidas quando possível
• CSS inline em templates deve ser evitado
• Toda classe criada deve ter finalidade clara

---

Estrutura lógica do arquivo

O arquivo está organizado, de forma histórica e funcional, nos seguintes blocos:

1. Correções de compatibilidade

• Ajustes de sup e sub
• Correções herdadas de compatibilidade com navegadores antigos

Uso:

• Apenas manutenção
• Não expandir este bloco

---

2. Página principal

Oculta elementos específicos apenas na página principal:

• Subtítulo
• Metadados
• Cabeçalho H1
• Seções técnicas irrelevantes ao leitor final

Escopo:

• body.page-Página_principal

---

3. Elementos editoriais gerais

Inclui:

• Transformação de div.editsection
• Ícones para artigos destacados e bons
• Ajustes visuais em resultados de busca
• Zebra striping em listas especiais

---

4. Infobox e tabelas

Classes centrais:

• .infobox
• .infobox_v2
• .wikitable
• .prettytable

Finalidade:

• Padronizar infoboxes e tabelas
• Evitar estilos duplicados em templates
• Garantir consistência visual entre páginas históricas

---

5. Caixas informativas e mensagens

Classes:

• .caixa
• .caixaMW
• .messagebox
• Variações:
  • .info
  • .aviso
  • .infodestaque
  • .avisodestaque

Uso recomendado:

• Mensagens editoriais
• Avisos históricos
• Contextualizações museográficas

---

6. Navegação e navboxes

Inclui:

• .navbox
• Estruturas colapsáveis (NavFrame)
• Regras de impressão

Objetivo:

• Facilitar navegação sem poluir a leitura
• Compatibilidade com impressão e exportação

---

7. Referências e citações

Ajustes aplicados:

• Destaque visual para referências clicadas
• Normalização de cite e span.citation
• Controle de exibição em tela vs impressão

---

8. CommonsTicker e integrações históricas

Bloco herdado de integrações com Wikimedia Commons:

• Estilos de status
• Ações (deleted, restored, replaced)
• Uso residual e histórico

---

9. Media lists e ícones

Inclui suporte visual para:

• Áudio
• Vídeo
• PDFs externos

Objetivo:

• Melhorar leitura e identificação de mídias
• Evitar ambiguidade de links externos

---

10. Metacaixa (abas)

Conjunto extenso de classes:

• .mbBouton
• .mbContenu
• .mbOnglet

Esquemas de cor suportados:

• Lilás
• Verde
• Azul
• Laranja
• Cinza
• Amarelo
• Vermelho

Uso:

• Predefinição:Metacaixa
• Conteúdos extensos com múltiplos eixos

---

11. Namespaces

Estilos aplicados a namespaces específicos:

• Template
• Categoria
• Portal
• Efeméride
• Páginas de discussão

Objetivo:

• Diferenciar visualmente áreas técnicas
• Facilitar orientação do editor

---

12. Identidade visual Galo Digital

Classes específicas do projeto:

• .fundologo
• .gd-caixa

Uso:

• Elementos institucionais
• Destaques editoriais próprios do Galo Digital

---

13. Temporadas – Automação visual

Bloco crítico para o sistema de temporadas automatizadas.

Classes principais:

• .gd-result-win
• .gd-result-draw
• .gd-result-loss
• .gd-score
• .gd-table
• .gd-table-partidas
• .gd-stadium

Finalidade:

• Suporte direto aos módulos Lua:
  • Módulo:Temporada
  • Módulo:Temporada/Partidas
  • Módulo:Temporada/Estatisticas
• Separação semântica de resultados
• Correções definitivas de alinhamento

---

Boas práticas de manutenção

• Nunca remover regras sem verificar dependências
• Evitar URLs externas quando possível
• Documentar decisões visuais relevantes
• Preferir classes específicas a seletores genéricos
• Testar em páginas reais antes de salvar

---

Erros comuns

• Inserir CSS inline em templates
• Criar classes duplicadas
• Alterar estilos globais para resolver problemas locais
• Editar sem histórico ou justificativa

---

Relação com Scribunto

O Common.css é parte integrante da arquitetura de automação:

• Módulos Lua geram classes semânticas
• O CSS define o comportamento visual
• Templates permanecem limpos e editoriais

Este modelo permite:

• Escalabilidade
• Manutenção de longo prazo
• Separação clara entre lógica e apresentação

---

Histórico e governança

• Arquivo com herança histórica de múltiplas fases da wiki
• Consolidado e reutilizado no projeto Galo Digital
• Base visual da automação das temporadas
• Deve ser tratado como infraestrutura crítica