2 poin oleh GN⁺ 2024-12-23 | 1 komentar | Bagikan ke WhatsApp
  • Dokumentasi twtxt disusun agar pengguna dapat menelusuri instalasi, quick start, penggunaan CLI, dan API internal secara berurutan, berdasarkan v1.3.2-dev
  • Untuk pengguna baru, alur yang disarankan adalah menyiapkan lingkungan di Installation, lalu lanjut ke Quickstart
  • Jika konsep twtxt masih asing, baca Introduction terlebih dahulu; cara pengoperasian praktis dapat dilihat di Usage, terutama berfokus pada CLI
  • Detail tentang struktur internal dan perspektif pengembangan dibahas pada bab API dan API Reference
  • Proyek ini menerima kontribusi, dan kode sumbernya dikelola di GitHub

Urutan membaca dokumentasi

  • Dokumentasi ini berdasarkan Release v1.3.2-dev
  • Saat pertama kali memulai, susunan yang tepat adalah melihat instalasi dan quick start terlebih dahulu, lalu beralih ke penjelasan konsep dan penggunaan terperinci sesuai kebutuhan
    • Installation: instalasi
    • Quickstart: quick start
    • Introduction: dokumen yang sebaiknya dibaca terlebih dahulu jika belum tahu apa itu twtxt
    • Usage: cara lebih terperinci menggunakan twtxt lewat CLI
    • API: dokumentasi struktur internal twtxt

API Reference dan kontribusi

  • API Reference dapat dianggap sebagai pintu masuk bagi developer untuk melihat detail modul, class, function, dan detail kode sumber lainnya di twtxt
  • Kontribusi ke proyek dimungkinkan, dan kode sumbernya dikelola di GitHub

1 komentar

 
GN⁺ 2024-12-23
Pendapat di Hacker News
  • Ternyata cukup sulit menemukan contoh situs yang benar-benar menjalankan ini
    Direktori https://git.mills.io/yarnsocial/we-are-twtxt mengalami error, tetapi saya bisa menemukannya di snapshot Internet Archive 19 September 2024: https://web.archive.org/web/20240919022045/https://git.mills...
    Dari daftar itu, contoh yang masih hidup adalah https://niplav.site/twtxt.txt, dan daftar follow-nya juga terlihat. Contoh yang punya tulisan terbaru adalah https://txt.sour.is/user/xuu/twtxt.txt dengan postingan dari Desember 2024
    Commit terakhir di https://github.com/buckket/twtxt/commits/master/ adalah Oktober 2023, jadi sulit menyebut proyeknya sangat aktif saat ini
    Selain itu, saya menemukan https://twtxt.readthedocs.io/en/latest/user/registry.html dan tautan lanjutannya https://registry.twtxt.org/api/plain/tweets, yang menampilkan konten terbaru dari keseluruhan jaringan
    https://registry.twtxt.org/api/plain/users tampak seperti daftar pengguna, tetapi berbeda dari yang tertulis di https://registry.twtxt.org/swagger-ui/, pagination dengan ?page=3 tidak berfungsi

    • Daftar situs yarn.social/twtxt yang saat ini aktif ada di https://feeds.twtxt.net/feeds dan jumlahnya cukup banyak
      Nama komunitasnya adalah YARN, sedangkan twtxt adalah nama protokolnya
    • twtxt tidak terlalu populer. Format feed-nya sendiri rapi, kecuali penggunaan karakter tab, tetapi tampaknya tidak ada cukup permintaan niche untuk itu
      Di situs saya, saya juga mengimplementasikan versi twtxt dari feed Atom dan JSON Feed: https://dbohdan.com/twtxt.txt
      Generator yang awalnya saya buat untuk situs tersebut juga membuat feed twtxt: https://github.com/tclssg/tclssg
      Saya belum pernah melihat dukungan dari generator situs statis atau plugin lain, jadi kalau ada yang tahu, saya ingin melihat tautannya
      tilde.institute, sebuah sistem Unix publik, juga memiliki registry twtxt: https://twtxt.tilde.institute/
      Daftar pengguna dapat dilihat di https://twtxt.tilde.institute/api/plain/users, dan agregator https://twtxt.tilde.institute/api/plain/tweets saat ini dipenuhi tulisan yang tampaknya memprotes frekuensi request
      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] Inilah alasan mengapa nama standar feed tidak seharusnya memasukkan kata “feed”
  • Tulisan terkait. Ada lagi?
    A Decentralised Social Network - https://news.ycombinator.com/item?id=33513022 - November 2022, 1 komentar
    https://news.ycombinator.com/item?id=25246533 - November 2020
    Twtxt Is a Self-Hosted, Twitter-Like Decentralised MicroBlogging Platform - https://news.ycombinator.com/item?id=25242996 - November 2020, 27 komentar
    Show HN: Twtxt v0.0.7 Your self-hosted, decentralised Twitter -like - https://news.ycombinator.com/item?id=23945300 - Juli 2020, 7 komentar
    Twtxt.net – Attempting to respark the twtxt community - https://news.ycombinator.com/item?id=23892491 - Juli 2020, 1 komentar
    Twtxt is a decentralised, minimalist microblogging service for hackers - https://news.ycombinator.com/item?id=23507640 - Juni 2020, 1 komentar
    Twtxt is a decentralised, minimalist microblogging service for hackers - https://news.ycombinator.com/item?id=23312756 - Mei 2020, 1 komentar
    Show HN: Txtnish – a client for the microblogging platform twtxt - https://news.ycombinator.com/item?id=13742949 - Februari 2017, 4 komentar
    Show HN: htwtxt – hosted twtxt server (written in Go) - https://news.ycombinator.com/item?id=11091592 - Februari 2016, 2 komentar
    Show HN: Twtxt – Decentralised, minimalist microblogging service for hackers - https://news.ycombinator.com/item?id=11043502 - Februari 2016, 65 komentar

  • Setelah memakainya selama beberapa tahun, pindah ke Mastodon, lalu ke Nostr
    Cukup berjalan dengan baik, mudah juga untuk coding, dan masih ada orang yang mengambil file twtxt saya. Namun aplikasinya terasa kasar, jadi hal-hal seperti mengelola follow makin lama makin merepotkan
    Karena tidak ada aplikasi mobile yang bagus, jadi kurang menyenangkan dalam situasi ketika saya paling sering memakai media sosial

  • Cukup banyak bug. Rasanya begitu sedikit saja keluar dari standar, seperti direktori konfigurasi atau direktori file txt, langsung rusak; pada akhirnya saya menyesuaikannya sesuai standar, tapi tetap ada masalah
    twtxt following mengeluarkan error. Awalnya saya kira karena belum mengikuti siapa pun, tetapi meski saya memilih untuk mengikuti feed berita twtxt, error-nya tidak hilang
    Meski file txt-nya ada, muncul error “feed not available”, dan mungkin saja karena perbedaan versi. Jujur saja ini menarik, tapi saya menyerah

  • Komunitas Twtxt/Yarn lebih besar dari yang saya kira. Sebagai pendiri Yarn.social[1], dan karena Yarn.social sendiri juga memakai spesifikasi serta ekstensi Twtxt[2], sekaligus mengoperasikan instance utama twtxt.net[3], saya sering berinteraksi dengan kira-kira sekitar 70 orang bahkan tidak termasuk feed berita
    [1]: https://yarn.social
    [2]: https://twtxt.net
    [3]: https://twtxt.net

    • Dengan segala hormat, 70 orang bukan angka yang lebih besar dari perkiraan saya
  • Saya sama sekali tidak mengerti mengapa sistem penerbitan konten minimalis seperti ini menganggap citra visual tidak diperlukan
    Manusia sudah mengekspresikan diri lewat gambar jauh sebelum lewat tulisan
    Sistem yang memaksa orang berekspresi hanya dengan ASCII, font monospace, dan satu warna itu kasar, dan menurut saya hampir tidak menghormati ekspresi manusia
    Itu masuk akal pada 1983, ketika teknologi yang memungkinkan ekspresi seperti ini belum banyak, tetapi saya tidak tahu mengapa kita harus melakukannya sekarang. Orang macam apa yang membatasi diri seperti ini? Apakah mereka menerimanya sebagai disiplin diri atau pengendalian diri, ataukah ini pernyataan artistik?
    Saya penasaran dengan proses sampai pada “Saya akan berkomitmen pada sistem ini, dan selalu berkomunikasi hanya dengan bahasa tulis dalam bentuk tipografi satu warna yang seragam. Saya akan masuk secara sukarela ke dalam batasan ini”
    Entah biarawan penyalin naskah abad pertengahan, atau orang-orang yang meninggalkan sejarah dan sastra di perkamen di Yunani, Romawi, Mesir, atau Tiongkok kuno, mereka pasti akan terkejut mendengar gagasan seperti ini

    • Tulisan berkembang setelah gambar untuk memecahkan masalah bahwa citra visual lemah dalam mengekspresikan konsep abstrak
      Tulisan pada akhirnya juga berbasis pada gambar berupa huruf, tetapi memanfaatkan pola sosial berupa literasi untuk menyampaikan informasi yang sangat terkodifikasi
      Penemuan yang kini kita anggap wajar ini begitu dipuja oleh generasi dahulu, sampai-sampai kadang bergeser ke ekstrem yang ingin menyingkirkan gambar, seperti kaum ikonoklas
      Bentuk paling ekstremnya adalah notasi matematika, yang mengekspresikan gagasan paling abstrak secara ringkas
      Tentu saja mencampur gambar dan teks punya banyak kegunaan. Coba jelaskan grafik atau diagram, atau adegan nyata, hanya dengan teks. Namun untuk tujuan lain seperti sastra, gambar juga bisa menjadi gangguan yang membuat otak harus berganti mode dan menurunkan pengalaman
    • Ironisnya, tempat tulisan ini diposting sendiri adalah situs bergaya retro yang lebih mementingkan konten daripada ekspresi
    • Biarkan saja tiap orang membuat apa yang ingin mereka buat. Kalau ingin membuat sesuatu yang lain, buatlah sendiri. Mereka tidak merugikan siapa pun, jadi mengapa meremehkan upaya mereka?
      “Jika kamu tidak membuat sesuatu, kamu didefinisikan oleh selera, bukan kemampuan. Selera hanya mempersempit dan mengecualikan orang. Jadi, buatlah sesuatu”
      • Why the Lucky Stiff
    • Ada semacam cargo cult yang memuja ketiadaan fitur, karena para pengembang keren generasi lama sudah terbiasa dengan hal-hal seperti email, IRC, dan EMACS yang mereka pelajari saat kuliah 30 tahun lalu
    • Dari video demonya saja terlihat bahwa ini bukan sistem ASCII, dan jika membaca dokumentasinya, terkonfirmasi bahwa file teks dianggap sebagai UTF-8
      Jadi ada sedikit ironi dalam analisis itu. Sistem ini juga mengizinkan hieroglif, salah satu sistem ekspresi gambar kuno yang Anda isyaratkan. Hieroglif ada di Unicode
      Hanya saja, saya kira hampir tidak ada orang yang benar-benar memakai hieroglif di sistem ini selama 9 tahun terakhir
  • Nostr adalah mikroblog para peretas. Cukup tanda tangani lalu relay
    https://github.com/nostr-protocol/nips/blob/master/01.md
    https://news.ycombinator.com/item?id=42489954

    • Hal yang saya sukai dari Nostr adalah eksperimen dengan berbagai klien sangat aktif, dan Anda bisa membawa identitas Anda ke klien mana pun. Model yang benar-benar keren
      Saya sedang membuat situs diskusi berbasis Nostr yang sangat terinspirasi oleh HN/reddit: https://oddbean.com/
      Tidak perlu login, dan kapan saja bisa beralih ke klien lain. Di halaman depan, saya berusaha meminimalkan pembicaraan soal bitcoin/politik. Di Nostr memang banyak konten seperti itu, tetapi juga ada banyak diskusi ramah dan penuh pertimbangan tentang berbagai topik
    • Teknologi Nostr sendiri hebat
      Masalahnya, 95% percakapan adalah tentang kripto
    • Seperti Usenet kecil dengan tanda tangan
  • Saya tidak tahu bagaimana orang bisa dengan mudah membicarakannya dengan nama seperti Twtxt. Tidak ada satu pun huruf vokal

    • Kalau sudah dipakai luas, saya akan mengucapkannya “twixt” meski itu salah
    • Jumlah upvote pada rekomendasi pelafalan di komentar-komentar saudara harus dianggap mengikat secara hukum, dan akan menjadi pelafalan yang berwenang. Harus berhati-hati saat memberi upvote
    • Saya sepertinya akan mengucapkannya seperti “Twit-ext”
  • Untuk jejaring sosial smolweb lainnya, Bubble yang berjalan di Gemini layak dilihat
    http://portal.mozz.us/gemini/git.skyjake.fi/bubble/main/
    http://portal.mozz.us/spartan/hitchhiker-linux.org/gemlog/on...
    URL terakhir memerlukan klien Gemini untuk membukanya
    Mengejutkannya, Bubble terlihat sedikit mirip Hacker News, dan juga mendukung fitur moderasi
    “Forum diskusi, mikroblogging, dan pelacakan issue Git untuk komunitas Gemini. Untuk berpartisipasi, Anda hanya perlu klien Gemini. Selamat datang!”
    gemini://bbs.geminispace.org/s/Bubble

  • Simon Willison menjalankan mikroblog yang cukup aktif, dan baru-baru ini membuat ulasan meta tentang pendekatan serta cara kerjanya. Seperti yang diduga, berbasis Django
    Ini mungkin menarik bagi orang yang ingin menggali thread ini lebih jauh
    My approach to running a link blog
    22 Desember 2024
    https://simonwillison.net/2024/Dec/22/link-blog/