Hospedagem com 20% de desconto comprando pelo link

Visual e temas

A aparência de um site Velk mora no tema: os templates e o CSS que a IA escreve. Como pedir mudanças visuais, transformar um site em HTML estático num tema e por que uma mudança de CSS às vezes não aparece.

Um site Velk tem três partes: a estrutura é um arquivo (site.json), o conteúdo está no banco, e a aparência é o tema — os templates das páginas em theme/templates/, os pedaços reaproveitados como cabeçalho e rodapé em theme/partials/, e o CSS (as regras de estilo), os scripts e as imagens ao lado. Tudo que o visitante vê — cor, fonte, espaçamento, layout — vem do tema, e quem escreve é a IA.

O cliente mexe no conteúdo pelo painel, nunca no visual. Um post novo ou um bloco novo sempre sai com a cara do site, e o painel não tem como mudar o layout.

Como pedir uma mudança visual

  • Dê referência. Um site que você gosta, o manual da marca, os códigos de cor e os nomes das fontes, um layout desenhado (uma imagem ou um PDF anexado na conversa). “Moderno e clean” não diz nada para ninguém; “cards como os desta página, no nosso azul #1A3D8F” diz.
  • Uma mudança por vez. “Título maior no hero” e depois “mais espaço entre os serviços”: dois pedidos que você confere um a um.
  • Diga onde vale — só na home, em todas as páginas, só nos posts — e o que não pode mudar.
  • Confira no celular. Estreite a janela do navegador ou abra a página no celular, e descreva o que quebra: “no celular o menu cobre o logo”.

Peça à IA

No hero da home (a seção grande de abertura), aumenta o título — uns 56px no computador, 36px no celular —, mantém a fonte e deixa mais espaço entre o título e o botão. Não mexe em mais nada no site.

Uma mudança que dá para medir, num lugar só, dizendo o que fica igual: fácil de conferir e fácil de desfazer.

Para uma página nova

Cria a página “Workshops” seguindo o layout anexado. Coloca os estilos dela num arquivo CSS próprio, carregado só por essa página, para nada mais no site mudar enquanto a gente ajusta.

Uma página em construção com CSS próprio aguenta várias rodadas sem quebrar o resto do site. Um ajuste pontual numa regra que já existe é feito onde a regra já mora.

De um site em HTML estático para um tema Velk

Um site em HTML puro — um template comprado, um site estático antigo, um layout exportado em HTML — pode virar um tema Velk com o painel já preenchido. Coloque os arquivos na pasta do projeto e peça: converte esse HTML num tema velk. A primeira parada da skill é um plano para você aprovar.

Peça à IA

Converte esse HTML num tema velk. Os arquivos estão na pasta site-antigo. Mantém o visual idêntico. O blog vira tipo de conteúdo, os depoimentos viram uma lista editável, e o menu e os contatos do rodapé vão para as opções. Me mostra o plano antes de gerar qualquer coisa.

Dizer como você quer dividir o conteúdo deixa o plano mais perto do que você precisa já na primeira tentativa.

O que a skill faz

  1. Separa o original

    Os arquivos originais vão para uma pasta _source/ na raiz do projeto, fora do tema. Se o Velk ainda não estiver instalado, ela propõe instalar e espera o seu sim.

  2. Lê cada página

    Cabeçalho e rodapé repetidos viram pedaços reaproveitados, cards repetidos uma lista ou um tipo de conteúdo, menu e contatos opções, os textos campos da página. Ela também recolhe os textos e as imagens escritos no HTML.

  3. Mostra o plano

    Páginas e campos, tipos de conteúdo, opções e com o que o painel vai nascer preenchido. Nada é gerado antes da sua aprovação.

  4. Monta e preenche

    Escreve o site.json, os templates e o CSS; depois um script de uma vez só copia o conteúdo antigo para o banco, e o painel abre preenchido.

  5. Diz o que falta

    Imagens para passar à biblioteca de mídia (até lá aparecem os arquivos originais), destinatários de formulário para configurar, scripts de rastreamento (pixel, chat) para cadastrar na tela Scripts, e a _source/ para apagar depois que você aprovar — o primeiro deploy não roda com ela ali.

O que a IA roda
# depois de escrever o site.json, os templates e o script de carga $ ./bin/velk schema:validate ✓ site.json is valid. $ ./bin/velk page:sync ✓ Pages synced. $ php theme/install/seed.php # copia os textos e as imagens do site antigo para o painel $ ./bin/velk serve ✓ Velk serving on http://localhost:8080
Abra o site local e o painel e compare com o original antes de aprovar.

Por que a mudança de CSS não aparece

As regras de servidor do Velk (o arquivo .htaccess) mandam o navegador guardar CSS e JavaScript por um mês. Isso deixa o site mais rápido, e quer dizer que uma folha de estilo carregada sempre do mesmo endereço continua mostrando a versão antiga para quem volta ao site — às vezes até para você. A correção está no tema: cada arquivo de CSS e JS é carregado com uma versão no endereço, tirada da última alteração do arquivo, então cada mudança ganha um endereço novo que todo navegador busca.

Os temas que a skill monta já fazem isso, e a publicação versionada avisa quando o CSS ou o JS mudou sem essa versão. Num tema mais antigo, peça uma vez: “carrega o CSS e o JS com versão no endereço”.

Perguntas

O cliente consegue mudar cor ou fonte pelo painel?

Por padrão, não: o visual está no tema. Se o cliente precisa trocar alguma coisa — a cor de um banner, uma imagem de temporada —, peça uma opção que o tema leia, como uma escolha entre as cores da marca.

Mudei o CSS e o site continua igual.

Se só você vê a versão antiga, recarregue ignorando o cache (Cmd/Ctrl+Shift+R na maioria dos navegadores). Se todo mundo vê, o tema carrega o CSS sem versão no endereço: peça para a IA acrescentar.