Quando você publica no WriteFreely, uma plataforma de blogs, o conteúdo aparece de forma diferente no Mastodon. Os usuários do Mastodon veem uma prévia truncada com um link para o artigo completo, em vez do texto integral. Esse comportamento é proposital e decorre de como o ActivityPub, o protocolo subjacente, lida com conteúdo de diferentes tipos de software. Este artigo explica por que os posts do WriteFreely são truncados no Mastodon, como funciona o link de federação e o que usuários de ambas as plataformas podem esperar ao interagir com conteúdo longo no fediverso.
Principais Conclusões: Federação de Posts entre WriteFreely e Mastodon
- Mapeamento de tipo de conteúdo no ActivityPub: O WriteFreely envia artigos como objetos
Article, que o Mastodon exibe como prévias truncadas com um link para o post original. - Preferências > Visibilidade do Post > Linha do Tempo Federada: Usuários do Mastodon veem apenas os primeiros 500 caracteres de um post do WriteFreely em sua linha do tempo inicial ou federada.
- Prévia de link do WriteFreely no Mastodon: Um cartão com o título do artigo, um resumo e uma imagem aparece, permitindo que usuários do Mastodon cliquem para ler o texto completo no WriteFreely.
Como WriteFreely e Mastodon Interpretam os Tipos de Conteúdo um do Outro
O WriteFreely é uma plataforma de blogs minimalista projetada para escrita longa. O Mastodon é uma plataforma de microblogging com limite de 500 caracteres por post. Quando essas duas plataformas federam via ActivityPub, precisam reconciliar seus diferentes modelos de conteúdo.
O ActivityPub define vários tipos de objeto. O WriteFreely envia posts como objetos Article. O Mastodon envia posts principalmente como objetos Note. O Mastodon não exibe objetos Article por completo. Em vez disso, os renderiza como um cartão de resumo contendo um título, um pequeno trecho e um link para o artigo original no WriteFreely.
Esse comportamento não é um bug. É uma escolha de design deliberada do Mastodon para preservar a experiência de limite de caracteres para seus usuários. Se o Mastodon exibisse o texto completo de um artigo de 2000 palavras do WriteFreely na linha do tempo, isso quebraria a experiência de rolagem, sobrecarregaria a contagem de caracteres e confundiria os usuários que esperam posts curtos.
Estrutura do Post do WriteFreely no ActivityPub
Quando você publica um post no WriteFreely, o software gera um payload ActivityPub com os seguintes campos:
- type:
Article - name: O título do seu post
- content: O corpo HTML completo do artigo
- url: O link permanente para o artigo na sua instância WriteFreely
- summary: Um pequeno trecho, geralmente os primeiros 140 caracteres do artigo
O Mastodon recebe esse payload e verifica o campo type. Como o tipo é Article em vez de Note, o Mastodon aplica sua lógica de renderização de prévia em vez de exibir o conteúdo completo.
Lógica de Renderização de Prévia do Mastodon
O Mastodon usa um gerador de prévia de link integrado para todo conteúdo federado que não é um Note. Quando encontra um objeto Article, extrai o campo name como título do cartão, o campo summary como descrição do cartão e o campo url como destino do link. Também tenta buscar qualquer imagem Open Graph da URL do artigo para exibir como miniatura.
A linha do tempo do Mastodon mostra esse cartão em formato compacto. Os usuários veem o título, uma descrição curta e um link rotulado como “Leia mais” ou o domínio do artigo. Eles precisam clicar no link para visualizar o artigo completo no WriteFreely.
O que os Usuários do Mastodon Veem Quando um Post do WriteFreely Aparece em Seu Feed
- Rolando a linha do tempo inicial ou federada
Um post do WriteFreely aparece como um cartão com um título, um pequeno trecho de cerca de 140 caracteres e uma imagem miniatura se o artigo incluir uma. O cartão tem um link para o artigo completo no WriteFreely. - Clicando no cartão ou no link
O Mastodon abre o artigo no navegador integrado ou no navegador padrão, dependendo das configurações do cliente Mastodon. O artigo carrega na instância WriteFreely onde foi publicado. - Interagindo com o post
Você pode favoritar, impulsionar ou responder ao post do WriteFreely a partir do Mastodon. Sua resposta é enviada de volta ao WriteFreely, onde aparece como um comentário no artigo. Os usuários do Mastodon veem a resposta em sua linha do tempo como um post normal do Mastodon. - Visualizando os detalhes do post
Se você abrir o post do WriteFreely na visualização detalhada do Mastodon, ainda verá apenas a prévia do cartão. O texto completo do artigo nunca é carregado no Mastodon. Você precisa clicar para ir ao WriteFreely e ler o artigo inteiro.
Problemas Comuns e Equívocos com a Federação do WriteFreely no Mastodon
Post do WriteFreely Mostra Apenas um Link Sem Prévia
Se a instância WriteFreely não retornar metadados Open Graph ou se o payload ActivityPub estiver faltando o campo summary, o Mastodon pode mostrar apenas um link simples em vez de um cartão rico. Para corrigir isso, o administrador da instância WriteFreely deve garantir que as tags Open Graph estejam ativadas no arquivo de configuração do WriteFreely. A configuração relevante é opengraph definido como true no config.ini. Após alterar essa configuração, reinicie o serviço WriteFreely.
Respostas do WriteFreely Aparecem como Posts Separados no Mastodon
Quando um usuário do Mastodon responde a um artigo do WriteFreely, a resposta aparece no WriteFreely como um comentário. No entanto, no Mastodon, essa resposta aparece como um post independente na linha do tempo, não aninhado sob o artigo original do WriteFreely. Isso ocorre porque o Mastodon não mantém um contexto de thread para objetos Article. Usuários do Mastodon que desejam acompanhar uma discussão precisam navegar manualmente até o artigo do WriteFreely para ver a thread completa de comentários.
Posts do WriteFreely Não Aparecem na Pesquisa do Mastodon
A pesquisa de texto completo do Mastodon indexa apenas o conteúdo de objetos Note. Como os posts do WriteFreely são objetos Article, seu texto completo não é indexado na pesquisa do Mastodon. Usuários do Mastodon não podem encontrar artigos do WriteFreely pesquisando por palavras-chave do corpo do artigo. Eles só podem encontrá-los pesquisando pelo título do artigo ou pelo identificador do autor. Essa limitação é inerente ao design da plataforma e não pode ser alterada por configuração.
Comparação de Exibição de Posts: WriteFreely vs Mastodon
| Item | WriteFreely | Mastodon |
|---|---|---|
| Tipo de conteúdo | Article | Note |
| Limite de caracteres | Ilimitado | 500 por post |
| Exibição na linha do tempo | Texto completo do artigo | Cartão com título, resumo e link |
| Indexação em pesquisa | Texto completo indexado | Apenas título e autor indexados |
| Tratamento de respostas | Comentários aparecem abaixo do artigo | Respostas aparecem como posts separados |
Esta tabela mostra as diferenças fundamentais em como cada plataforma trata os posts. O comportamento de federação é um resultado direto dessas escolhas de design no nível do software.
Usuários do WriteFreely que desejam que o texto completo de seus artigos apareça no Mastodon podem considerar publicar um resumo curto no Mastodon com um link para o artigo completo. Isso dá aos usuários do Mastodon a opção de clicar para acessar, mantendo a linha do tempo limpa. Usuários do Mastodon que leem conteúdo longo com frequência podem seguir autores do WriteFreely diretamente e usar o navegador integrado do cliente Mastodon para abrir artigos sem sair do aplicativo.
Para verificar como sua instância WriteFreely federada com o Mastodon, publique um artigo de teste e depois pesquise pelo seu identificador do Mastodon a partir de uma conta do Mastodon em uma instância diferente. Se a prévia do cartão aparecer corretamente, a federação está funcionando como projetado. Se o cartão estiver ausente ou quebrado, verifique as configurações de Open Graph do WriteFreely e o payload ActivityPub nos logs do servidor.