2 ポイント 投稿者 GN⁺ 2024-12-23 | 1件のコメント | WhatsAppで共有
  • twtxt ドキュメントは v1.3.2-dev を基準に、インストール、クイックスタート、CLI の使い方、内部 API を順に参照できる構成になっている
  • 初めて使うユーザーには、Installation で環境を準備した後、Quickstart へ進む流れが推奨される
  • twtxt の概念に不慣れであれば、まず Introduction を読み、実際の操作方法は Usage で CLI 中心に確認できる
  • 内部構造や開発視点での詳細情報は API 章と API Reference で扱っている
  • プロジェクトはコントリビューションを受け付けており、ソースコードは GitHub で管理されている

ドキュメントを読む順番

  • ドキュメントは Release v1.3.2-dev を基準としている
  • 初めて参照する際は、まずインストールとクイックスタートを見て、必要に応じて概念説明や詳細な使い方へ進む構成が適している
    • Installation: インストール
    • Quickstart: クイックスタート
    • Introduction: twtxt が何かわからないときに最初に読むドキュメント
    • Usage: CLI で twtxt を使うためのより詳しい方法
    • API: twtxt の内部構造に関するドキュメント

API Reference とコントリビューション

  • API Reference は、twtxt のモジュール、クラス、関数、そのほかソースコードの詳細を確認するための開発者向け入口といえる
  • プロジェクトには貢献可能で、ソースコードは GitHub で管理されている

1件のコメント

 
GN⁺ 2024-12-23
Hacker Newsのコメント
  • これを実際に動かしているサイトの例を見つけるのが、意外と難しかった。
    https://git.mills.io/yarnsocial/we-are-twtxt のディレクトリはエラーになっていたが、Internet Archive の 2024年9月19日のスナップショットで見つけられた: https://web.archive.org/web/20240919022045/https://git.mills...
    そのリストの中で生きている例は https://niplav.site/twtxt.txt で、フォロー一覧も見える。最近の投稿がある例としては、2024年12月の投稿がある https://txt.sour.is/user/xuu/twtxt.txt がある。
    https://github.com/buckket/twtxt/commits/master/ の最後のコミットは 2023年10月なので、今 プロジェクトが非常に活発だ と見るのは難しい。
    さらに https://twtxt.readthedocs.io/en/latest/user/registry.html と、そこから辿れる https://registry.twtxt.org/api/plain/tweets を見つけたが、ネットワーク全体の最近のコンテンツが見える。
    https://registry.twtxt.org/api/plain/users はユーザー一覧のように見えるが、https://registry.twtxt.org/swagger-ui/ に書かれているのとは違って、?page=3 ではページネーションが動かなかった。

    • 現在アクティブな yarn.social/twtxt サイトの一覧は https://feeds.twtxt.net/feeds にあり、かなり多い。
      コミュニティ名は YARN で、twtxt はプロトコル名である。
    • twtxt はそれほど一般的ではない。フィード形式自体はタブ文字を使う点を除けばすっきりしているが、それだけの ニッチ需要 が十分にないようだ。
      自分のサイトには Atom と JSON Feed の twtxt 版も実装してある: https://dbohdan.com/twtxt.txt
      もともと自分のサイト向けに作ったジェネレーターも twtxt フィードを生成する: https://github.com/tclssg/tclssg
      他の静的サイトジェネレーターやプラグインで対応しているのは見たことがないので、知っているものがあればリンクを見たい。
      公開 Unix システムの tilde.institute にも twtxt レジストリがある: https://twtxt.tilde.institute/
      ユーザー一覧は https://twtxt.tilde.institute/api/plain/users で見られ、アグリゲーター https://twtxt.tilde.institute/api/plain/tweets は現在、リクエスト頻度への抗議のような投稿で埋まっている。
      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] フィード標準の名前に “feed” という語を入れてはいけない理由は、まさにこういうことだ。
  • 関連記事。ほかにもあるだろうか?
    A Decentralised Social Network - https://news.ycombinator.com/item?id=33513022 - 2022年11月、コメント1件
    https://news.ycombinator.com/item?id=25246533 - 2020年11月
    Twtxt Is a Self-Hosted, Twitter-Like Decentralised MicroBlogging Platform - https://news.ycombinator.com/item?id=25242996 - 2020年11月、コメント27件
    Show HN: Twtxt v0.0.7 Your self-hosted, decentralised Twitter -like - https://news.ycombinator.com/item?id=23945300 - 2020年7月、コメント7件
    Twtxt.net – Attempting to respark the twtxt community - https://news.ycombinator.com/item?id=23892491 - 2020年7月、コメント1件
    Twtxt is a decentralised, minimalist microblogging service for hackers - https://news.ycombinator.com/item?id=23507640 - 2020年6月、コメント1件
    Twtxt is a decentralised, minimalist microblogging service for hackers - https://news.ycombinator.com/item?id=23312756 - 2020年5月、コメント1件
    Show HN: Txtnish – a client for the microblogging platform twtxt - https://news.ycombinator.com/item?id=13742949 - 2017年2月、コメント4件
    Show HN: htwtxt – hosted twtxt server (written in Go) - https://news.ycombinator.com/item?id=11091592 - 2016年2月、コメント2件
    Show HN: Twtxt – Decentralised, minimalist microblogging service for hackers - https://news.ycombinator.com/item?id=11043502 - 2016年2月、コメント65件

  • 数年使ったあと、Mastodonに移り、その後Nostrに移った
    かなりうまく動いていたし、コーディングもしやすく、今でも私の twtxt ファイルを取得している人がいる。ただ、アプリが粗削りで、フォロー管理のようなことがだんだん面倒になっていった
    まともな モバイルアプリ がなかったので、私がソーシャルメディアを最もよく使う場面では楽しさが薄れてしまった

  • かなりバグが多かった。設定ディレクトリや txt ファイルのディレクトリのように、標準から少しでも外れると壊れるようで、結局標準どおりに合わせても問題があった
    twtxt following がエラーを出す。最初は誰もフォローしていないからだと思ったが、twtxt ニュースフィードをフォローするように選んでもエラーは消えなかった
    txt ファイルがあるのに「feed not available」エラーが出て、バージョン差異のせいかもしれない。正直、興味深くはあるが諦めた

  • Twtxt/Yarn コミュニティは思ったより大きい。Yarn.social[1] の創設者であり、Yarn.social 自体も Twtxt 仕様と拡張[2]を使い、代表インスタンスである twtxt.net[3] も運営している立場からすると、ニュースフィードを除いてもおおよそ 70人前後 と頻繁にやり取りしている
    [1]: https://yarn.social
    [2]: https://twtxt.net
    [3]: https://twtxt.net

    • 敬意を込めて言うと、70人 は私が思っていたより大きな数字ではない
  • なぜこのようなミニマルなコンテンツ公開システムが視覚イメージを必要としないと考えるのか、どうしても理解できない
    人間は文字よりはるか以前から、イメージによって自分を表現してきた
    人にASCII、等幅フォント、単色だけで表現するよう強いるシステムは粗雑で、人間の表現に対してほとんど無礼なレベルだと思う
    こうした表現を可能にする技術が珍しかった1983年ならまだわかるが、なぜ今これをやるのかはわからない。自らをここまで制限する人たちはどんな人たちなのだろうか。自己鍛錬や節制として受け止めているのか、それとも芸術的な宣言なのか
    「このシステムに献身し、常に均一な単色タイポグラフィ形式の書き言葉でのみコミュニケーションする。この制約の中に自発的に入っていく」というところに至る過程が気になる
    中世の写本修道士であれ、古代ギリシャ・ローマ・エジプト・中国で羊皮紙に歴史や文学を残していた人であれ、こんな考えを聞いたら驚愕しただろう

    • 文章表現は、抽象概念を表現するうえで視覚イメージが弱いという問題を解くために、イメージの後に発展した
      文字も結局は文字というイメージに基づいているが、リテラシーという社会的パターンを活用して高度に符号化された情報を伝達する
      今では当然視されているこの発明は、以前の世代にはあまりに崇拝され、聖像破壊主義者のようにイメージを追い払おうとする極端さにまで至ることもあった
      最も極端な形は数学表記で、最も抽象的なアイデアを簡潔に表現する
      もちろん、イメージとテキストを混ぜることには大きな有用性がある。グラフや図表、実際の場面をテキストだけで説明してみればいい。しかし文学のような別の目的では、脳にモード切替を強いて体験を損なう妨げになることもある
    • 皮肉なことに、この投稿が載っている場所自体が、表現よりもコンテンツを重視するレトロ調のサイトだ
    • それぞれが作りたいものを作ればいい。別のものを作りたいなら自分で作ればいい。この人たちが害を及ぼしているわけでもないのに、なぜその努力をけなすのか?
      「何かを作らない限り、人は能力ではなく趣味で定義される。趣味は人を狭め、排除するだけだ。だから作れ」
      • Why the Lucky Stiff
    • 昔のかっこいい開発者たちが、30年前の大学時代に覚えたメール、IRC、EMACSのようなものに慣れ親しんでいて、機能のなさを崇拝するカーゴカルトがある
    • デモ動画を見るだけでも、これはASCIIシステムではなく、ドキュメントを読めばテキストファイルがUTF-8として扱われることも確認できる
      そのため、この分析には少し皮肉がある。このシステムは、あなたが示唆した古代のイメージ表現体系の一つである象形文字さえ許容している。象形文字はUnicodeに含まれている
      ただし、この9年間でこのシステム上で実際に象形文字を使った人はほとんどいなかったと思う
  • Nostrこそがハッカーのためのマイクロブログだ。署名してリレーするだけでいい
    https://github.com/nostr-protocol/nips/blob/master/01.md
    https://news.ycombinator.com/item?id=42489954

    • Nostrで気に入っている点は、さまざまなクライアントの実験が活発で、アイデンティティをどのクライアントにも持ち運べることだ。本当に素晴らしいモデルだ
      HN/redditに強く触発されたNostrベースの議論サイトを作っている: https://oddbean.com/
      ログインは不要で、いつでも別のクライアントに切り替えられる。ホームページではビットコイン/政治の話題を最小限にしようとしている。Nostrにはそうした内容が多いが、多様なトピックについて親切で思慮深い議論もたくさんある
    • Nostrの技術自体は素晴らしい
      問題は会話の95%が暗号資産に関することだ
    • 署名付きの小さなUsenetみたいなものだ
  • Twtxtみたいな名前で、どうやって他の人と簡単に会話しろというのかわからない。母音が一つもない

    • 広く使われるようになったら、たとえ間違っていても「twixt」と発音するつもりだ
    • 兄弟コメントの発音案についた賛成票は法的拘束力を持つものと見なされ、権威ある発音になるはずだ。慎重に投票すべきだ
    • 私なら「Twit-ext」みたいに発音すると思う
  • もう一つのsmolwebソーシャルネットワークとしては、Gemini上で動くBubbleも見ておく価値がある
    http://portal.mozz.us/gemini/git.skyjake.fi/bubble/main/
    http://portal.mozz.us/spartan/hitchhiker-linux.org/gemlog/on...
    最後のURLを見るにはGeminiクライアントが必要だ
    驚いたことに、BubbleはHacker Newsに少し似て見え、モデレーション機能もサポートしている
    「Geminiコミュニティ向けのディスカッションフォーラム、マイクロブログ、Gitの課題追跡。参加するにはGeminiクライアントさえあれば大丈夫です。ようこそ!」
    gemini://bbs.geminispace.org/s/Bubble

  • Simon Willisonはかなり活発なマイクロブログを運営しており、最近、自分のアプローチとその動作方式をメタレビューしていた。予想どおりDjangoベースだ
    このスレッドをさらに掘り下げる人には興味深いかもしれない
    My approach to running a link blog
    2024年12月22日
    https://simonwillison.net/2024/Dec/22/link-blog/