2 pontos por GN⁺ 2024-12-23 | 1 comentários | Compartilhar no WhatsApp
  • A documentação do twtxt é organizada, com base na v1.3.2-dev, para que seja possível consultar em sequência a instalação, o início rápido, o uso da CLI e a API interna
  • Para quem vai usar pela primeira vez, recomenda-se preparar o ambiente em Installation e depois seguir para o Quickstart
  • Se o conceito de twtxt ainda for pouco familiar, vale ler primeiro a Introduction, e o método prático de uso pode ser conferido em Usage, com foco na CLI
  • A estrutura interna e os detalhes sob a perspectiva de desenvolvimento são tratados no capítulo API e na API Reference
  • O projeto aceita contribuições, e o código-fonte é mantido no GitHub

Ordem de leitura da documentação

  • A documentação tem como base a Release v1.3.2-dev
  • Ao acessar pela primeira vez, o ideal é ver primeiro a instalação e o início rápido, e depois avançar para a explicação dos conceitos e o uso detalhado conforme necessário
    • Installation: instalação
    • Quickstart: início rápido
    • Introduction: documento para ler primeiro se você ainda não souber o que é twtxt
    • Usage: formas mais detalhadas de usar o twtxt pela CLI
    • API: documentação da estrutura interna do twtxt

API Reference e contribuições

  • A API Reference pode ser vista como a porta de entrada para desenvolvedores que querem consultar módulos, classes, funções e outros detalhes do código-fonte do twtxt
  • É possível contribuir com o projeto, e o código-fonte é mantido no GitHub

1 comentários

 
GN⁺ 2024-12-23
Opiniões no Hacker News
  • Foi surpreendentemente difícil encontrar exemplos de sites que realmente rodam isso
    O diretório https://git.mills.io/yarnsocial/we-are-twtxt dava erro, mas consegui encontrá-lo em um snapshot de 19 de setembro de 2024 no Internet Archive: https://web.archive.org/web/20240919022045/https://git.mills...
    Um exemplo vivo nessa lista é https://niplav.site/twtxt.txt, e a lista de quem ele segue também aparece. Um exemplo com posts recentes é https://txt.sour.is/user/xuu/twtxt.txt, que tem posts de dezembro de 2024
    O último commit em https://github.com/buckket/twtxt/commits/master/ é de outubro de 2023, então é difícil dizer que o projeto está muito ativo no momento
    Além disso, encontrei https://twtxt.readthedocs.io/en/latest/user/registry.html e, a partir dali, https://registry.twtxt.org/api/plain/tweets, onde dá para ver conteúdo recente da rede como um todo
    https://registry.twtxt.org/api/plain/users parece ser uma lista de usuários, mas, ao contrário do que aparece em https://registry.twtxt.org/swagger-ui/, a paginação não funcionou com ?page=3

    • A lista de sites yarn.social/twtxt atualmente ativos está em https://feeds.twtxt.net/feeds e é bem grande
      O nome da comunidade é YARN, e twtxt é o nome do protocolo
    • twtxt não é muito popular. O formato do feed em si é limpo, exceto pelo uso de caracteres de tabulação, mas parece que não há demanda de nicho suficiente para isso
      No meu site, também implementei versões twtxt dos feeds Atom e JSON Feed: https://dbohdan.com/twtxt.txt
      O gerador que criei originalmente para o site também gera feeds twtxt: https://github.com/tclssg/tclssg
      Não vi suporte em outros geradores de sites estáticos ou plugins; se alguém souber de algum, gostaria de ver o link
      O sistema Unix público tilde.institute também tem um registro twtxt: https://twtxt.tilde.institute/
      A lista de usuários pode ser vista em https://twtxt.tilde.institute/api/plain/users, e o agregador https://twtxt.tilde.institute/api/plain/tweets está atualmente cheio de posts que parecem protestar contra a frequência das requisições
      quite https://lublin.se/twtxt.txt 2024-12-23T03:15:21-05:00 THE LAST HUMAN POST ON THIS FEED IS MORE THAN FOUR YEARS OLD. PERHAPS TWTXT CLIENTS SHOULD THEN FETCH THE FEED *VERY* RARELY.
      [1] É exatamente por isso que não se deve colocar a palavra “feed” no nome de um padrão de feed
  • Posts relacionados. Será que há mais?
    A Decentralised Social Network - https://news.ycombinator.com/item?id=33513022 - novembro de 2022, 1 comentário
    https://news.ycombinator.com/item?id=25246533 - novembro de 2020
    Twtxt Is a Self-Hosted, Twitter-Like Decentralised MicroBlogging Platform - https://news.ycombinator.com/item?id=25242996 - novembro de 2020, 27 comentários
    Show HN: Twtxt v0.0.7 Your self-hosted, decentralised Twitter -like - https://news.ycombinator.com/item?id=23945300 - julho de 2020, 7 comentários
    Twtxt.net – Attempting to respark the twtxt community - https://news.ycombinator.com/item?id=23892491 - julho de 2020, 1 comentário
    Twtxt is a decentralised, minimalist microblogging service for hackers - https://news.ycombinator.com/item?id=23507640 - junho de 2020, 1 comentário
    Twtxt is a decentralised, minimalist microblogging service for hackers - https://news.ycombinator.com/item?id=23312756 - maio de 2020, 1 comentário
    Show HN: Txtnish – a client for the microblogging platform twtxt - https://news.ycombinator.com/item?id=13742949 - fevereiro de 2017, 4 comentários
    Show HN: htwtxt – hosted twtxt server (written in Go) - https://news.ycombinator.com/item?id=11091592 - fevereiro de 2016, 2 comentários
    Show HN: Twtxt – Decentralised, minimalist microblogging service for hackers - https://news.ycombinator.com/item?id=11043502 - fevereiro de 2016, 65 comentários

  • Usei por alguns anos, depois migrei para o Mastodon e, em seguida, para o Nostr
    Funcionava bastante bem, era fácil de programar, e ainda há pessoas que buscam meu arquivo twtxt. Mas os apps eram rudimentares, então coisas como gerenciar quem eu seguia foram ficando cada vez mais chatas
    A falta de um bom app móvel diminuiu a graça nas situações em que mais uso redes sociais

  • Tinha bugs consideráveis. Parecia quebrar com qualquer pequeno desvio do padrão, como o diretório de configuração ou o diretório do arquivo txt; no fim, mesmo ajustando tudo ao padrão, ainda havia problemas
    twtxt following dava erro. No começo achei que fosse porque eu não seguia ninguém, mas mesmo depois de escolher seguir o feed de notícias do twtxt, o erro não desapareceu
    Mesmo havendo um arquivo txt, aparecia o erro “feed not available”, e talvez fosse por diferença de versão. Sinceramente, é interessante, mas desisti

  • A comunidade Twtxt/Yarn é maior do que parece. Como fundador do Yarn.social[1], e considerando que o próprio Yarn.social usa a especificação e as extensões do Twtxt[2], além de eu operar a instância principal, twtxt.net[3], interajo com frequência com cerca de 70 pessoas ou um pouco mais, excluindo feeds de notícias
    [1]: https://yarn.social
    [2]: https://twtxt.net
    [3]: https://twtxt.net

    • Com todo o respeito, 70 pessoas não é um número maior do que eu imaginava
  • Não consigo entender por que esses sistemas minimalistas de publicação de conteúdo acham que imagens visuais são desnecessárias
    Humanos se expressam por imagens desde muito antes da escrita
    Um sistema que força as pessoas a se expressarem apenas com ASCII, fontes monoespaçadas e uma única cor me parece tosco, quase desrespeitoso com a expressão humana
    Em 1983, quando tecnologias que possibilitavam esse tipo de expressão não eram comuns, isso fazia sentido, mas não sei por que deveríamos fazer isso hoje. Que tipo de pessoa se limita assim? Encaram isso como autodisciplina ou contenção, ou como uma declaração artística?
    Tenho curiosidade sobre o processo que leva alguém a: “vou me dedicar a este sistema e me comunicar sempre apenas por linguagem escrita em um formato tipográfico monocromático uniforme. Vou entrar voluntariamente nessa restrição”
    Seja um monge copista medieval, seja alguém que registrava história e literatura em pergaminhos na Grécia, Roma, Egito ou China antigos, qualquer um ficaria horrorizado ao ouvir uma ideia dessas

    • A escrita se desenvolveu depois das imagens para resolver o problema de que imagens visuais são fracas para expressar conceitos abstratos
      A escrita também se baseia, no fim das contas, em imagens chamadas letras, mas usa o padrão social da alfabetização para transmitir informações altamente codificadas
      Essa invenção, que hoje damos como certa, foi tão venerada por gerações passadas que às vezes chegou ao extremo de tentar expulsar as imagens, como os iconoclastas
      A forma mais extrema disso é a notação matemática, que expressa ideias extremamente abstratas de modo conciso
      Claro que misturar imagens e texto é muito útil. Tente explicar gráficos, diagramas ou cenas reais usando apenas texto. Mas, para outros objetivos, como literatura, isso também pode virar uma distração que obriga o cérebro a trocar de modo e prejudica a experiência
    • Ironicamente, o próprio lugar onde este texto foi publicado é um site retrô que valoriza mais conteúdo do que expressão
    • Basta deixar cada um criar o que quer criar. Se você quer algo diferente, faça você mesmo. Essas pessoas não estão prejudicando ninguém, então por que diminuir o esforço delas?
      “Quando você não cria coisas, passa a ser definido pelo seu gosto, não pela sua capacidade. O gosto só estreita e exclui as pessoas. Portanto, crie”
      • Why the Lucky Stiff
    • Existe um culto à carga que venera a ausência de recursos, porque desenvolvedores antigos e respeitados se acostumaram com coisas como e-mail, IRC e EMACS, que aprenderam na universidade 30 anos atrás
    • Só de ver o vídeo de demonstração já dá para perceber que isso não é um sistema ASCII e, lendo a documentação, confirma-se que os arquivos de texto são considerados UTF-8
      Então há certa ironia na análise. Este sistema permite até hieróglifos, um dos antigos sistemas de representação por imagens que você insinuou. Hieróglifos estão no Unicode
      Mas imagino que quase ninguém tenha usado hieróglifos de fato nesse sistema nos últimos 9 anos
  • Nostr é o microblog dos hackers. É só assinar e retransmitir
    https://github.com/nostr-protocol/nips/blob/master/01.md
    https://news.ycombinator.com/item?id=42489954

    • O que gosto no Nostr é que há muita experimentação ativa com vários clientes, e você pode levar sua identidade para qualquer cliente. É um modelo realmente muito bom
      Estou criando um site de discussões baseado em Nostr, fortemente inspirado em HN/reddit: https://oddbean.com/
      Não exige login, e você pode trocar para outro cliente a qualquer momento. Na página inicial, tento minimizar conversas sobre bitcoin/política. Há muito disso no Nostr, mas também há muitas discussões amigáveis e ponderadas sobre temas variados
    • A tecnologia do Nostr em si é excelente
      O problema é que 95% das conversas são sobre criptomoedas
    • Parece uma pequena Usenet com assinaturas
  • Não sei como esperam que as pessoas conversem facilmente com um nome como Twtxt. Não tem nenhuma vogal

    • Se passar a ser amplamente usado, pretendo pronunciar como “twixt”, mesmo que esteja errado
    • Os votos nas recomendações de pronúncia nos comentários irmãos devem ser considerados juridicamente vinculantes e se tornarão a pronúncia autoritativa. É preciso votar com cuidado
    • Acho que eu pronunciaria como “Twit-ext”
  • Outra rede social smolweb que vale conferir é o Bubble, que roda no Gemini
    http://portal.mozz.us/gemini/git.skyjake.fi/bubble/main/
    http://portal.mozz.us/spartan/hitchhiker-linux.org/gemlog/on...
    Para ver a última URL, é preciso um cliente Gemini
    Surpreendentemente, o Bubble se parece um pouco com o Hacker News e também oferece recursos de moderação
    “Fórum de discussão, microblogging e rastreamento de issues Git para a comunidade Gemini. Para participar, tudo de que você precisa é um cliente Gemini. Boas-vindas!”
    gemini://bbs.geminispace.org/s/Bubble

  • Simon Willison mantém um microblog bastante ativo e recentemente fez uma metarrevisão da própria abordagem e de como ela funciona. Como esperado, é baseado em Django
    Pode ser interessante para quem quiser se aprofundar mais nesta thread
    Minha abordagem para manter um blog de links
    22 de dezembro de 2024
    https://simonwillison.net/2024/Dec/22/link-blog/