2 points par GN⁺ 2024-12-23 | 1 commentaires | Partager sur WhatsApp
  • La documentation de twtxt, basée sur la v1.3.2-dev, est organisée pour parcourir dans l’ordre l’installation, le démarrage rapide, l’utilisation en CLI et les API internes
  • Pour les nouveaux utilisateurs, le parcours recommandé consiste à préparer l’environnement avec Installation, puis à poursuivre avec Quickstart
  • Si le concept de twtxt ne vous est pas familier, lisez d’abord Introduction ; les manipulations concrètes sont présentées dans Usage, principalement autour de la CLI
  • Les détails sur l’architecture interne et le point de vue développement sont traités dans le chapitre API et dans l’API Reference
  • Le projet accepte les contributions, et le code source est géré sur GitHub

Ordre de lecture de la documentation

  • La documentation se base sur la Release v1.3.2-dev
  • Pour une première prise en main, il est préférable de consulter d’abord l’installation et le démarrage rapide, puis de passer, selon les besoins, aux explications conceptuelles et à l’utilisation détaillée
    • Installation : installation
    • Quickstart : démarrage rapide
    • Introduction : document à lire en premier si vous ne savez pas ce qu’est twtxt
    • Usage : méthodes plus détaillées pour utiliser twtxt en CLI
    • API : documentation de l’architecture interne de twtxt

API Reference et contributions

  • L’API Reference peut être considérée comme un point d’entrée pour les développeurs afin de consulter les modules, classes, fonctions et autres détails du code source de twtxt
  • Il est possible de contribuer au projet, et le code source est géré sur GitHub

1 commentaires

 
GN⁺ 2024-12-23
Avis sur Hacker News
  • Il a été étonnamment difficile de trouver des exemples de sites qui font réellement tourner ça
    Le répertoire https://git.mills.io/yarnsocial/we-are-twtxt renvoyait une erreur, mais on pouvait le retrouver dans un snapshot de l’Internet Archive du 19 septembre 2024 : https://web.archive.org/web/20240919022045/https://git.mills...
    Dans cette liste, un exemple encore en ligne est https://niplav.site/twtxt.txt, où l’on voit aussi la liste des abonnements. Un exemple avec des messages récents est https://txt.sour.is/user/xuu/twtxt.txt, qui contient des posts de décembre 2024
    Le dernier commit sur https://github.com/buckket/twtxt/commits/master/ date d’octobre 2023, donc il est difficile de dire que le projet est très actif aujourd’hui
    J’ai aussi trouvé https://twtxt.readthedocs.io/en/latest/user/registry.html et, à partir de là, https://registry.twtxt.org/api/plain/tweets, où l’on peut voir du contenu récent à l’échelle du réseau
    https://registry.twtxt.org/api/plain/users ressemble à une liste d’utilisateurs, mais contrairement à ce qui est indiqué sur https://registry.twtxt.org/swagger-ui/, la pagination ne fonctionnait pas avec ?page=3

    • La liste actuelle des sites yarn.social/twtxt actifs se trouve sur https://feeds.twtxt.net/feeds et elle est assez fournie
      Le nom de la communauté est YARN, et twtxt est le nom du protocole
    • twtxt n’est pas vraiment populaire. Le format de flux lui-même est propre, à part l’usage de tabulations, mais il ne semble pas y avoir une demande de niche suffisante
      Sur mon site, j’ai aussi mis en place une version twtxt des flux Atom et JSON Feed : https://dbohdan.com/twtxt.txt
      Le générateur que j’avais créé pour mon site d’origine produit également un flux twtxt : https://github.com/tclssg/tclssg
      Je n’ai rien vu de similaire pris en charge par d’autres générateurs de sites statiques ou plugins, donc si vous en connaissez, je serais curieux d’avoir des liens
      Le système Unix public tilde.institute dispose aussi d’un registre twtxt : https://twtxt.tilde.institute/
      La liste des utilisateurs est disponible sur https://twtxt.tilde.institute/api/plain/users, et l’agrégateur https://twtxt.tilde.institute/api/plain/tweets semble actuellement rempli de messages se plaignant de la fréquence des requêtes
      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.
      Voilà précisément pourquoi il ne faut pas mettre le mot “feed” dans le nom standard d’un flux [1]
  • Articles connexes. Y en a-t-il d'autres ?
    A Decentralised Social Network - https://news.ycombinator.com/item?id=33513022 - novembre 2022, 1 commentaire
    https://news.ycombinator.com/item?id=25246533 - novembre 2020
    Twtxt Is a Self-Hosted, Twitter-Like Decentralised MicroBlogging Platform - https://news.ycombinator.com/item?id=25242996 - novembre 2020, 27 commentaires
    Show HN: Twtxt v0.0.7 Your self-hosted, decentralised Twitter -like - https://news.ycombinator.com/item?id=23945300 - juillet 2020, 7 commentaires
    Twtxt.net – Attempting to respark the twtxt community - https://news.ycombinator.com/item?id=23892491 - juillet 2020, 1 commentaire
    Twtxt is a decentralised, minimalist microblogging service for hackers - https://news.ycombinator.com/item?id=23507640 - juin 2020, 1 commentaire
    Twtxt is a decentralised, minimalist microblogging service for hackers - https://news.ycombinator.com/item?id=23312756 - mai 2020, 1 commentaire
    Show HN: Txtnish – a client for the microblogging platform twtxt - https://news.ycombinator.com/item?id=13742949 - février 2017, 4 commentaires
    Show HN: htwtxt – hosted twtxt server (written in Go) - https://news.ycombinator.com/item?id=11091592 - février 2016, 2 commentaires
    Show HN: Twtxt – Decentralised, minimalist microblogging service for hackers - https://news.ycombinator.com/item?id=11043502 - février 2016, 65 commentaires

  • Je l’ai utilisé pendant quelques années, puis je suis passé à Mastodon, puis à Nostr
    Ça fonctionnait plutôt bien, c’était facile à coder, et il y a encore des gens qui récupèrent mon fichier twtxt. Mais les apps étaient rudimentaires, donc la gestion des abonnements et ce genre de choses est devenue de plus en plus pénible
    Comme il n’y avait pas de bonne application mobile, c’était moins amusant dans le contexte où j’utilise le plus souvent les réseaux sociaux

  • Il y avait pas mal de bugs. On aurait dit que ça cassait dès qu’on s’écartait un peu du standard, par exemple pour le répertoire de configuration ou celui des fichiers txt, et au final il y avait encore des problèmes même après s’être aligné sur le standard
    twtxt following renvoie une erreur. Au début, j’ai cru que c’était parce que je ne suivais encore personne, mais même après avoir choisi de suivre le fil d’actualité twtxt, l’erreur ne disparaissait pas
    J’obtenais aussi l’erreur « feed not available » alors que le fichier txt existait, peut-être à cause d’une différence de version. Honnêtement, c’est intéressant, mais j’ai laissé tomber

  • La communauté Twtxt/Yarn est plus grande qu’on ne le pense. En tant que fondateur de Yarn.social[1], qui utilise lui-même la spécification Twtxt et ses extensions[2], et en tant qu’exploitant de twtxt.net[3], l’instance principale, j’interagis régulièrement avec environ 70 personnes en excluant le fil d’actualité
    [1]: https://yarn.social
    [2]: https://twtxt.net
    [3]: https://twtxt.net

    • Avec tout le respect voulu, 70 personnes, ce n’est pas vraiment plus grand que ce que j’imaginais
  • Je ne comprends absolument pas pourquoi ces systèmes minimalistes de publication de contenu considèrent qu’ils n’ont pas besoin d’images visuelles
    Les humains s’expriment par l’image depuis bien plus longtemps que par le texte
    Un système qui force les gens à s’exprimer uniquement avec de l’ASCII, une police à chasse fixe et du monochrome me paraît grossier, presque insultant pour l’expression humaine
    Cela se comprenait peut-être en 1983, quand la technologie permettant ce type d’expression était rare, mais aujourd’hui je ne vois pas pourquoi il faudrait faire ça. Quel genre de personnes choisissent de se limiter ainsi ? Est-ce une forme de discipline personnelle ou d’ascèse, ou bien une déclaration artistique ?
    Je suis curieux du cheminement qui mène à : « Je vais me consacrer à ce système et communiquer uniquement par écrit, toujours dans un format typographique monochrome uniforme. Je vais volontairement entrer dans cette contrainte »
    Qu’il s’agisse des moines copistes médiévaux ou de ceux qui consignaient l’histoire et la littérature sur parchemin dans la Grèce, la Rome, l’Égypte ou la Chine antiques, ils auraient été horrifiés d’entendre une telle idée

    • L’écriture s’est développée après l’image pour résoudre le problème du fait que les images visuelles expriment mal les concepts abstraits
      L’écriture repose elle aussi, au fond, sur des images que sont les caractères, mais elle transmet des informations hautement codées en s’appuyant sur le schéma social qu’est la littératie
      Cette invention, que nous tenons aujourd’hui pour acquise, a été tellement vénérée par les générations précédentes qu’on en est parfois arrivé à l’extrême inverse, à vouloir chasser les images comme des iconoclastes
      Sa forme la plus extrême est la notation mathématique, qui exprime de manière concise les idées les plus abstraites
      Bien sûr, mélanger images et texte est très utile. Essayez donc d’expliquer uniquement par du texte un graphique, un diagramme ou une scène réelle. Mais pour d’autres objectifs, comme la littérature, cela peut aussi devenir une distraction qui oblige le cerveau à changer de mode et dégrade l’expérience
    • Ironiquement, l’endroit même où ce billet a été publié est un site rétro qui valorise davantage le contenu que l’expression
    • Il suffit de laisser chacun créer ce qu’il a envie de créer. Si vous voulez autre chose, créez-le vous-même. Ces gens ne font de mal à personne, alors pourquoi rabaisser leurs efforts ?
      « Si vous ne créez pas quelque chose, vous serez défini non par vos capacités, mais par vos goûts. Les goûts ne font que rétrécir les gens et exclure. Alors créez. »
      • Why the Lucky Stiff
    • Il y a chez certains vieux développeurs cool une forme de cargo cult : ils sont habitués à des choses comme l’email, IRC ou EMACS, apprises à l’université il y a 30 ans, et en viennent à vénérer l’absence de fonctionnalités
    • Rien qu’en regardant la démo vidéo, on voit que ce n’est pas un système ASCII, et la documentation confirme que les fichiers texte sont supposés être en UTF-8
      Cela ajoute une certaine ironie à l’analyse. Ce système autorise même l’un des anciens systèmes d’expression visuelle que vous évoquiez implicitement : les hiéroglyphes. Ils font partie d’Unicode
      Cela dit, il est probable que presque personne n’ait réellement utilisé des hiéroglyphes dans ce système au cours des neuf dernières années
  • Nostr est le microblog des hackers. Il suffit de signer et de relayer
    https://github.com/nostr-protocol/nips/blob/master/01.md
    https://news.ycombinator.com/item?id=42489954

    • Ce que j’aime dans Nostr, c’est qu’il y a beaucoup d’expérimentations côté clients, et qu’on peut emporter son identité d’un client à l’autre. C’est vraiment un modèle génial
      Je développe un site de discussion basé sur Nostr, fortement inspiré par HN/reddit : https://oddbean.com/
      Il n’y a pas besoin de se connecter et on peut changer de client à tout moment. Sur la page d’accueil, j’essaie de réduire au minimum les sujets bitcoin/politiques. Il y en a beaucoup sur Nostr, mais on y trouve aussi de nombreuses discussions aimables et réfléchies sur des sujets variés
    • La technologie Nostr en elle-même est excellente
      Le problème, c’est que 95 % des conversations portent sur la crypto
    • C’est comme un petit Usenet signé
  • Avec un nom comme Twtxt, je ne vois pas comment on est censé en parler facilement avec d’autres gens. Il n’y a pas une seule voyelle

    • Si ça se répand, j’ai l’intention de le prononcer « twixt », même si c’est faux
    • Les votes sur les suggestions de prononciation des commentaires frères devraient être considérés comme juridiquement contraignants et faire autorité. Il faut voter avec prudence
    • Moi, je le prononcerais sans doute comme « Twit-ext »
  • Parmi les autres réseaux sociaux smolweb, Bubble, qui tourne sur Gemini, mérite le détour
    http://portal.mozz.us/gemini/git.skyjake.fi/bubble/main/
    http://portal.mozz.us/spartan/hitchhiker-linux.org/gemlog/on...
    Il faut un client Gemini pour consulter la dernière URL
    Fait surprenant, Bubble ressemble un peu à Hacker News et prend même en charge la modération
    « Forum de discussion, microblogging et suivi d’issues Git pour la communauté Gemini. Il suffit d’un client Gemini pour participer. Bienvenue ! »
    gemini://bbs.geminispace.org/s/Bubble

  • Simon Willison tient un microblog assez actif et a récemment publié une méta-revue de son approche et de son fonctionnement. Comme on pouvait s’y attendre, c’est basé sur Django
    Cela pourrait intéresser ceux qui veulent creuser davantage ce fil
    My approach to running a link blog
    22 décembre 2024
    https://simonwillison.net/2024/Dec/22/link-blog/