Pular para o conteúdo
CIBERLURGIA

Guia de padrões

Guia de padrões

Os blocos que a gente usa para montar o site. Cada exemplo é o HTML de verdade: copia, troca o texto e pronto.

01

Princípios

Seis regras. Quando uma decisão ficar em dúvida, volta pra cá.

  1. Celular simples e pouca banda primeiro. O site tem que abrir rápido numa conexão ruim.
  2. 2D é a base, 3D é camada. O 3D enfeita por cima. Nunca é o único jeito de usar.
  3. Contraste e alvo de toque de 44 px. Se não dá pra ler e tocar, não serve.
  4. A gota é a assinatura. É metal em fusão: gradiente de fogo com grão. Gota nunca tem contorno.
  5. O nome CIBERLURGIA nunca é gradiente. Sempre preto, giz ou cor sólida. O fogo é só da gota, da faixa e da borda.
  6. Texto direto. Frase curta, verbo na frente, sem enfeite.

02

Cores

Cada cor tem um trabalho. Sem dúvida, use preto, concreto e giz. A forja aparece como fogo, não como texto de parágrafo.

  • Preto --preto

    #000000

    Texto, borda e fundo onde o fogo brilha.

  • Concreto --concreto

    #D2D1CB

    Fundo claro. Sempre com grão.

  • Giz --giz

    #F5F4F0

    Papel e cartões. Texto sobre preto.

  • Grafite --grafite

    #4A4A47

    Texto secundário sobre claro.

  • Cinza --cinza

    #8A8984

    Texto secundário sobre preto. Arame frio.

  • Cereja --cereja

    #6E0000

    Forja a cerca de 750 °C. Fundo do hover em Mais procurados.

  • Forja --forja

    #E8180C

    Forja a cerca de 900 °C. Texto só sobre preto, ou título grande no claro. Fundo de botão com texto preto.

  • Brasa --brasa

    #FF5A00

    Forja a cerca de 1.000 °C. Linha de hover do menu.

  • Fusão --fusao

    #FFC400

    Forja a cerca de 1.100 °C. Destaque sobre preto, grifo e foco no topo.

  • Incandescente --incand

    #FFF4CF

    Forja a cerca de 1.300 °C. Brilho da gota e texto claro sobre o fogo.

  • Arco --arco

    #2D2DFF

    Contraponto frio. Fundo de botão e linha. Texto em giz por cima.

  • Arco claro --arco-claro

    #7C82FF

    Texto e linha sobre preto.

  • Fogo --fogo

    gradiente

    Gradiente só em gota, faixa (.fio-fogo) e borda, sempre sobre grão. Nunca em texto.

Regra da forja

Forja sobre preto: funciona.

Forja em texto pequeno sobre giz: não usa.

Uma amostra de cor (a grade acima é uma lista disso)

Ver código
<li class="pp-cor">
  <span class="pp-cor__amostra" style="background:var(--forja)" aria-hidden="true"></span>
  <div>
    <p class="pp-cor__nome">Forja <code>--forja</code></p>
    <p class="cota">#E8180C</p>
    <p>Texto só sobre preto, ou título grande no claro.</p>
  </div>
</li>

03

Tipografia

Quatro famílias, cada uma com uma função. Não troca de lugar. Escala: texto 17 px, cota 14 px, subtítulo 22 px, seção 64 px, capa 120 px ou mais. O nome CIBERLURGIA é sempre preto ou cor sólida, sem gradiente.

  • --f-estencil CBL Estencil (Big Shoulders Stencil 900): título, palavra de ordem e número grande, em caixa alta.
  • --f-geo CBL Jost 500 e 700: subtítulo, rótulo, botão e chamada.
  • --f-tec CBL Normógrafo (Osifont): cota, carimbo, data e legenda.
  • --f-texto Atkinson Hyperlegible 400 e 700: texto corrido e formulário.

Títulos e cotas

Santo André · ABC Paulista

Oficina aberta

Quem está na bancada

Ver HTML
<p class="cota">Santo André · ABC Paulista</p>
<h3 class="titulo-estencil">Oficina aberta</h3>
<p class="titulo-secao">Quem está na bancada</p>

Título gigante: cor sólida, nunca gradiente (regra: o nome nunca tem gradiente)

Solda

Ver HTML
<p class="titulo-estencil titulo-estencil--gigante">Solda</p>

Texto longo

Texto corrido vai nessa caixa. Ela limita a linha em cerca de 68 caracteres, que é o ponto em que a leitura não cansa.

Subtítulo de seção

Um parágrafo a mais, pra ver o espaço entre eles.

Ver HTML
<div class="texto-longo">
  <p>Texto corrido vai nessa caixa. Ela limita a linha em cerca de 68 caracteres, que é o ponto em que a leitura não cansa.</p>
  <h2>Subtítulo de seção</h2>
  <p>Um parágrafo a mais, pra ver o espaço entre eles.</p>
</div>

04

Faixas

Faixa é o fundo de uma seção. Preta pra destaque, concreto pra base, giz pra leitura. O fio-fogo é a régua de gradiente com grão, a única faixa de fogo.

Três faixas de fundo

faixa-preta

Capa e destaque. Texto em giz.

faixa-concreto

O padrão. Fundo com grão, texto preto.

faixa-giz

Papel liso, pra texto longo e leitura.

Ver HTML
<div class="faixa-preta pp-faixa"><p class="cota">faixa-preta</p><p>Capa e destaque. Texto em giz.</p></div>
<div class="faixa-concreto pp-faixa"><p class="cota">faixa-concreto</p><p>O padrão. Fundo com grão, texto preto.</p></div>
<div class="faixa-giz pp-faixa"><p class="cota">faixa-giz</p><p>Papel liso, pra texto longo e leitura.</p></div>
<div class="fio-fogo" role="presentation"></div>

05

Gota

A gota é a assinatura do site. Aparece no mosaico da capa e nos cartões sem foto, sem contorno nenhum. A forma pulsa devagar, e para quando o aparelho pede movimento reduzido.

As cinco cores da gota

gota--forja
gota--brasa
gota--fusao
gota--cereja
gota--arco
Ver HTML
<figure class="pp-gota"><span class="gota gota--forja" aria-hidden="true"></span><figcaption class="cota">gota--forja</figcaption></figure>
<figure class="pp-gota"><span class="gota gota--brasa" aria-hidden="true"></span><figcaption class="cota">gota--brasa</figcaption></figure>
<figure class="pp-gota"><span class="gota gota--fusao" aria-hidden="true"></span><figcaption class="cota">gota--fusao</figcaption></figure>
<figure class="pp-gota"><span class="gota gota--cereja" aria-hidden="true"></span><figcaption class="cota">gota--cereja</figcaption></figure>
<figure class="pp-gota"><span class="gota gota--arco" aria-hidden="true"></span><figcaption class="cota">gota--arco</figcaption></figure>

data-gota e data-cor

Ver HTML
<a class="pp-gota-link" href="/linkoteca/" data-gota="linkoteca" data-cor="forja" data-transicao>
  <span class="gota gota--forja" aria-hidden="true"></span>Linkoteca
</a>
  • data-gota: identificador da gota. Todo elemento com data-gota vira uma gota clicável no modo 3D.
  • data-cor: a cor da gota. Uma de forja, brasa, fusao, arco ou cereja.

06

Botões

O botão tem sombra e sobe no hover. O principal é o de fogo; os outros são apoio.

Botões

Ver HTML
<div class="pp-linha">
  <a class="botao" href="#botoes">Giz</a>
  <a class="botao botao--fogo" href="#botoes">Fogo</a>
  <button class="botao botao--arco" type="button">Arco</button>
  <button class="botao botao--icone" type="button" aria-label="Próxima">→</button>
</div>
<div class="faixa-preta pp-faixa">
  <a class="botao" href="#botoes">Botão sobre preto</a>
</div>

Um botão de fogo por bloco. Botão de só ícone precisa de aria-label. O botão é compacto (cerca de 32 px de altura); a área de toque de 44 px vem de um pseudo-elemento invisível.

07

Campos e busca

Campo tem borda preta, sem arredondar. Foco aparece em azul. Todo campo tem rótulo visível.

Busca e select

Ver HTML
<div class="busca" role="search">
  <label class="busca__rotulo" for="pp-busca">O que você procura?</label>
  <div class="busca__linha">
    <input class="busca__campo" id="pp-busca" type="search" placeholder="certidão, edital, Mauá…" autocomplete="off">
    <button class="botao botao--fogo" type="button">Buscar</button>
  </div>
</div>
<label class="filtros__cidade">
  <span class="cota">Cidade</span>
  <select class="campo" id="pp-cidade">
    <option>Todas</option>
    <option>Santo André</option>
    <option>Mauá</option>
  </select>
</label>

Campo de busca sem name: o texto fica no navegador e não vai para o servidor. Ids sempre com prefixo único.

08

Chips e selos

Chip filtra. Selo marca a categoria. A bolinha tem a cor da categoria.

Chips (filtros)

Todas Editais Conselhos
Ver HTML
<div class="pp-linha">
  <a class="chip chip--ativo" href="#chips">Todas</a>
  <a class="chip chip--forja" href="#chips">Editais</a>
  <a class="chip chip--arco" href="#chips">Conselhos</a>
  <button class="chip chip--brasa" type="button" aria-pressed="true">Tecnologia</button>
</div>

Selos de categoria

Cultura Mídia livre Conselhos

Ver HTML
<p class="pp-linha">
  <span class="selo-cat selo-cat--cereja">Cultura</span>
  <span class="selo-cat selo-cat--fusao">Mídia livre</span>
  <span class="selo-cat selo-cat--arco">Conselhos</span>
</p>

Chip ativo: chip--ativo ou aria-pressed="true". Cores: forja, brasa, fusao, arco e cereja.

09

Cartões e listas

Cartão é a peça básica: topo com foto ou gota, título, texto e um botão. Listas usam as mesmas cores e fontes.

Cartão

Ver HTML
<article class="cartao">
  <div class="cartao__corpo">
    <p class="cota">Categoria ou data</p>
    <h3 class="cartao__titulo"><a href="#cartoes">Título do cartão</a></h3>
    <p>Um parágrafo curto, uma ou duas linhas.</p>
    <a class="botao botao--fogo" href="#cartoes">Abrir</a>
  </div>
</article>

Item de lista de links

Ver HTML
<ul class="resultados">
  <li class="link-item">
    <a class="link-item__titulo" href="#cartoes">Nome do link <span aria-hidden="true">↗</span></a>
    <p>Para que serve, numa frase.</p>
    <p class="link-item__meta cota"><span class="selo-cat selo-cat--forja">Editais</span><span>Santo André</span><span>exemplo.org</span></p>
  </li>
</ul>

Mais procurados

Mais procurados

  1. 1Nome do link
  2. 2Outro link
Ver HTML
<section class="procurados" aria-labelledby="pp-t-procurados">
  <h3 class="titulo-secao" id="pp-t-procurados">Mais procurados</h3>
  <ol class="procurados__lista">
    <li><a href="#cartoes"><span class="procurados__n">1</span>Nome do link</a></li>
    <li><a href="#cartoes"><span class="procurados__n">2</span>Outro link</a></li>
  </ol>
</section>

Pessoa do coletivo

  • Ricardo Palmieri

    Na bancada

    Uma frase sobre o que a pessoa faz na oficina.

Ver HTML
<ul class="carrossel" aria-label="Exemplo de pessoa">
  <li class="pessoa" data-gota="pessoa-exemplo" data-cor="arco">
    <div class="pessoa__retrato" aria-hidden="true"><span class="blob blob--arco"><span class="blob__iniciais">RP</span></span></div>
    <h3 class="pessoa__nome">Ricardo Palmieri</h3>
    <p class="cota pessoa__funcao">Na bancada</p>
    <p class="pessoa__bio">Uma frase sobre o que a pessoa faz na oficina.</p>
    <ul class="pessoa__contatos">
      <li><a href="#cartoes">Contato</a></li>
    </ul>
  </li>
</ul>

Lista de links da Linkoteca usa item_link(), em app/views/paginas.php. Não copie o HTML na mão.

11

Conteúdo editável

O que o painel edita, arquivo por arquivo. Campo de link e de imagem têm regra própria no núcleo.

Estas coleções ficam em conteudo/*.json e são editadas no painel, em /admin. A tabela sai de app/esquemas.php, então muda sozinha quando o esquema muda.

ArquivoNome no painelFormatoCampos (tipo)
conteudo/site.jsonTextos geraisum registro sóNome do coletivo texto
Frase curta texto
Descrição para buscadores textarea
Chamada da capa textarea
E-mail de contato email
Redes e contatos links
Texto do rodapé textarea
conteudo/paginas.jsonPáginas de textolista, chave: slugIdentificador slug
Título texto
Subtítulo texto
Texto markdown
Imagem imagem
conteudo/categorias.jsonCategorias da Linkotecalista, chave: slugIdentificador slug
Nome texto
Descrição textarea
Cor da gota selecao
conteudo/links.jsonLinkotecalista, chave: idIdentificador slug
Título texto
Endereço url
Para que serve textarea
Categoria referencia
Abrangência selecao
Palavras-chave tags
Destaque na capa da Linkoteca booleano
Última verificação data
conteudo/ferramentas.jsonFerramentas úteislista, chave: idIdentificador slug
Nome texto
Endereço url
Para que serve textarea
Imagem imagem
Quem fez texto
Palavras-chave tags
conteudo/pessoas.jsonPessoas do coletivolista, chave: idIdentificador slug
Nome texto
Na bancada texto
Mini bio textarea
Foto imagem
Contatos links
conteudo/diario.jsonDiário (posts)lista, chave: slugIdentificador slug
Título texto
Data data
Resumo textarea
Texto markdown
Imagem imagem
Palavras-chave tags
Publicado booleano

Como o PHP lê uma coleção

Ver código
$pessoas = ler_colecao('pessoas'); // lista de arrays, um por pessoa

12

Acessibilidade e peso

Antes de publicar uma página nova, passa por esta lista.

  • Forja como texto só sobre preto, ou em título grande no claro.
  • Alvo de toque de 44 px no mínimo (botão compacto com área invisível ao redor).
  • Contraste AA: 4,5 para 1 em texto, 3 para 1 em título grande e borda.
  • Gota sem contorno preto. Nome CIBERLURGIA sem gradiente.
  • Foco de teclado visível: azul sobre claro, amarelo sobre preto.
  • Toda imagem tem alt. Se for decorativa, alt="".
  • Botão só com ícone tem aria-label.
  • Imagem com width e height, pra a tela não pular.
  • Imagens em webp ou svg, fontes em woff2. Nada de script novo sem motivo.
  • Movimento: a gota pulsa devagar, e o CSS corta isso com movimento reduzido.
  • A página abre e se lê sem JS. Teste desligando o JS.
  • Sem CSS inline, a não ser a cor da amostra.

Dúvida ou coisa que falta aqui? A gente ajusta. Voltar ao manual.