Feito com Chinaski

Usuário do X (Twitter)

O campo X handle (Settings → Integrations → Social) é a coisa mais simples da aba: um campo de texto que controla uma meta tag. Quando você o define (o seu handle, como @yourhandle), cada página construída carrega a atribuição twitter:site para que o X e clientes de preview de link saibam a qual conta um artigo pertence. Deixe-o em branco e essa linha simplesmente é omitida. Nenhum outro comportamento muda.

O que ele faz

No próximo build depois de salvar, cada página e post ganha um conjunto de meta tags X/Twitter:

  • twitter:card: um card de imagem grande quando a página tem uma imagem de compartilhamento (imagem OG → imagem destacada → imagem de compartilhamento padrão do site), e um card de resumo simples caso contrário.
  • twitter:title / twitter:description: as mesmas regras de texto das tags OpenGraph: o título/descrição OG por página, recuando para o título/descrição meta, depois para o título da página e a tagline do site.
  • twitter:image: a imagem de compartilhamento resolvida (mesma cadeia de fallback), omitida quando uma página não tem imagem nenhuma.
  • twitter:site: o seu handle, exatamente como digitado.

Essas tags complementam o conjunto OpenGraph emitido nas mesmas páginas; o X e outros clientes de preview de link geralmente aceitam qualquer um dos conjuntos.

O que ele não faz

  • Nenhum link ou login no X. É uma meta tag, nada mais: sem script, sem chamada de API, sem botões sociais por post adicionados.
  • Funciona offline. Diferente dos campos de análise, o handle não é relacionado à rede; o modo air-gap não o toca, e as meta tags são construídas bem em um host isolado.
  • Um card existe sem ele. As tags card/título/descrição/imagem são emitidas de qualquer forma; o handle apenas adiciona a linha de atribuição. Sem handle definido, o card ainda renderiza; só perde a linha de atribuição que liga o conteúdo à sua conta.
  • Atribuição por autor (twitter:creator) não é um recurso. Autores são metadados nos posts, mas as páginas construídas não emitem tags X por autor.

Notas de uso

  • Cole o handle, não a URL. O valor deve ser o texto do handle: @yourhandle (com ou sem o @); colar uma URL de perfil completa põe uma string de aparência errada dentro da tag. (O placeholder do campo mostra o formato pretendido.)
  • É uma atribuição de tudo ou nada para todo o site: flatfields de autor por post existem no sistema de autores, e temas poderiam renderizar a própria byline, mas não há um interruptor twitter:site por autor.
  • Qualquer mudança entra em vigor no próximo build das páginas afetadas (todas, já que é para todo o site).
  • Se a sua equipe gerencia várias contas, a mesma regra vale: um handle para toda a instância. Defina a conta que deve ser "respondida" quando os leitores falarem sobre o seu conteúdo.

A versão curta

Um campo, uma linha de meta: twitter:site em todo lugar, cortesia da seção Social de Settings → Integrations. Cards, imagens e títulos já são tratados pelo build; o handle apenas diz quem publicou.

Leia este site em