offpunk rrtp

Ini adalah garpu offpunk, repo resmi ada di: https://sr.ht/~lioploum/offpunk/

Command-line dan offline-first Smolnet Browser/Feed Reader untuk Gemini, Gopher, Spartan, RRTP, dan Web oleh Ploum.

Garpu khusus ini menambahkan dukungan untuk menjelajah sumber daya retikulum, menggunakan protokol transfer sumber daya retikulum (RRTP)

Tujuan dari Offpunk adalah untuk dapat menyinkronkan konten Anda sekali (sehari, seminggu, sebulan) dan kemudian menelusuri/mengaturnya sambil tetap terputus.

Halaman Proyek Resmi (Repositori/Daftar Surat): https://sr.ht/~lioploum/offpunk/

Offpunk adalah garpu dari AV-98 asli oleh SolderPunk dan awalnya disebut AV-98-Offline sebagai cabang eksperimental.

Cara menggunakan

Offpunk adalah file python tunggal. Instalasi adalah opsional, Anda dapat mengunduh dan menjalankan "./offpunk.py" atau "python3 offpunk.py" di terminal.

Anda menggunakan perintah go untuk mengunjungi URL, misalnya go gemini.circumlunar.space . (Gemini: // diasumsikan jika tidak ada protokol yang ditentukan. Protokol yang didukung adalah Gemini, Gopher, Finger, HTTP, HTTPS, Mailto, Spartan dan File).

Tautan di halaman ditetapkan indeks numerik. Cukup ketikkan indeks untuk mengikuti tautan itu. Jika halaman terlalu lama untuk dipasang di layar Anda, konten ditampilkan di pager yang lebih sedikit (secara default). Ketik q untuk berhenti dan kembali ke Offpunk Prompt. Ketik view atau v untuk menampilkannya lagi. ( view full atau v full memungkinkan untuk melihat halaman HTML lengkap alih -alih tampilan artikel. v feed Cobalah untuk menampilkan umpan RSS yang tertaut dan v feeds menampilkan daftar umpan yang tersedia. Ini hanya berlaku untuk halaman HTML)

Gunakan add untuk menambahkan kapsul ke bookmark dan bookmarks atau bm Anda untuk menampilkan bookmark Anda (Anda dapat membuat beberapa daftar bookmark, mengedit dan menghapusnya. Lihat manual list dengan help list ).

Gunakan offline untuk hanya menelusuri konten yang di -cache dan online untuk kembali online. Saat offline, perintah reload akan memaksa pengambilan ulang selama sinkronisasi berikutnya.

Gunakan perintah help untuk mempelajari tentang perintah tambahan. Beberapa abreviasi tersedia. Lihat abbrevs .

Saat diluncurkan dengan opsi "--Sync", Offpunk akan menjalankan non-interaktif dan mengambil konten dari bookmark, daftar, dan sumber daya Anda secara tentatif diakses saat offline. Konten baru yang ditemukan dalam langganan Anda (lihat help subscribe ) akan secara otomatis ditambahkan ke tur Anda (gunakan tour ls untuk melihat tur Anda saat ini, tour tanpa argumen untuk mengakses item berikutnya dan tour X di mana X adalah nomor tautan untuk menambahkan konten tautan ke tur Anda).

Dengan "--sync", orang dapat menentukan "-cache validitas" dalam hitungan detik. Opsi ini tidak akan menyegarkan konten jika ada cache dan kurang dari jumlah detik yang ditentukan.

Misalnya, berjalan

offpunk --sync --cache-validity 43200

Akan menyegarkan bookmark Anda jika mereka berusia setidaknya 12 jam. Jika cache-validitas tidak diatur atau diatur ke 0, cache apa pun dianggap baik dan hanya konten yang tidak pernah di-cache sebelumnya akan diambil. --assume-yes akan secara otomatis menerima sertifikat SSL dengan kesalahan alih-alih menolaknya.

Offpunk juga dapat dikonfigurasi sebagai browser oleh alat lain. Jika Anda ingin menggunakan offpunk secara langsung dengan URL yang diberikan, cukup ketik:

offpunk URL

Untuk memiliki Offpunk mengambil URL di Sync berikutnya dan tutup segera, jalankan:

offpunk --fetch-later URL

Lagi

Berita dan rilis penting akan diumumkan pada daftar surat devel offpunk => https://lists.sr.ht/~lioploum/offpunk-devel

Pertanyaan dapat diajukan pada milis pengguna: => https://lists.sr.ht/~lioploum/offpunk-users

Dependensi

Offpunk tidak memiliki "ketergantungan yang ketat", yaitu itu harus berjalan dan bekerja tanpa apa pun di luar perpustakaan standar Python dan pager "kurang". Namun, itu akan "mengimpor secara oportunistik" beberapa perpustakaan lain jika tersedia untuk menawarkan pengalaman yang lebih baik atau beberapa fitur lainnya. Permintaan perpustakaan Python, BS4 dan keterbacaan diperlukan untuk dukungan HTTP/HTML. Gambar ditampilkan jika chafa atau timg hadir (Python-PIL diperlukan untuk versi chafa sebelum 1.10). Saat menampilkan hanya gambar (bukan inline), rendering akan menjadi piksel sempurna di terminal yang kompatibel (seperti kitty) jika chafa setidaknya versi 1.8 atau jika timg digunakan.

Untuk menghindari penggunaan perpustakaan yang tidak stabil atau terlalu baru, aturan praktisnya adalah bahwa perpustakaan harus dikemas dalam Debian/Ubuntu. Perlu diingat bahwa Offpunk terutama diuji akan semua perpustakaan diinstal. Jika Anda mengalami kecelakaan tanpa satu dependensi opsional, silakan laporkan. Tambalan dan kontribusi untuk menghapus dependensi atau mendukung alternatif sangat dihargai.

• Pip: File Persyaratan untuk menginstal dependensi dengan PIP
• Ubuntu/Debian: Perintah untuk menginstal dependensi di Ubuntu/Debian tanpa Pip
• Arch: Paket AUR untuk Arch Linux, dikelola oleh Kseistrup
• Nix: paket, dikelola oleh damiencassou
• Alpine Linux: Paket dikelola oleh MIO
• Harap berkontribusi paket untuk sistem lain, ada daftar surat yang didedikasikan untuk kemasan.

Jalankan version perintah di offpunk untuk melihat apakah Anda kehilangan beberapa dependensi.

Wajib atau sangat direkomendasikan (pengemas mungkin harus membuat mereka wajib):

• Kurang: wajib tetapi mungkin sudah ada di sistem Anda
• File digunakan untuk mendapatkan jenis objek yang di -cache. Seharusnya sudah ada di sistem Anda.
• XDG-UTILS menyediakan XDG-Open yang sangat disarankan untuk membuka file tanpa renderer atau pawang. Ini juga digunakan untuk Mailto: Command.
• Perpustakaan kriptografi akan memberikan pengalaman yang lebih baik dan sedikit lebih aman saat menggunakan mode validasi sertifikat TOFU default dan disarankan (app-get install python3-cryptography).

Ketergantungan untuk mengaktifkan penjelajahan web (pengemas dapat menempatkan mereka di paket meta offpunk-web tetapi disarankan untuk memilikinya untuk pengalaman offpunk yang lebih baik)

• Python-Requests diperlukan untuk menangani permintaan HTTP/HTTPS secara asli (APT-Get Install Python3-Requests). Tanpa itu, tautan HTTP akan dibuka di browser eksternal
• BeautifulSoup4 dan keterbacaan keduanya diperlukan untuk membuat HTML. Tanpa mereka, HTML tidak akan diberikan atau dikirim ke parser eksternal seperti Lynx. (APT-GET menginstal python3-bs4 python3-readability atau PIP3 menginstal keterbacaan-lxml)
• Python-feedparser akan memungkinkan penguraian feed RSS/atom dan dengan demikian berlangganan mereka. (APT-GET INSTAL PYTHON3-FEEDPARSER)
• Chafa memungkinkan untuk menampilkan gambar di konsol Anda. Instal dan telusuri halaman HTML dengan gambar untuk melihat keajaiban.
• Timg adalah alternatif yang lebih lambat untuk Chafa untuk gambar inline. Tetapi memiliki rendering yang lebih baik saat hanya menampilkan gambar. Instal keduanya untuk mendapatkan yang terbaik dari kedua dunia tetapi jika Anda perlu memilih satu, pilih Chafa.
• Python-PIL diperlukan untuk hanya menampilkan bingkai pertama GIF animasi dengan chafa jika versi chafa lebih rendah dari 1,10.

Senang memiliki (packagers harus membuat mereka opsional):

• XSEL memungkinkan untuk go ke URL yang disalin di clipboard tanpa harus menempelkannya (baik X dan clipboard tradisional didukung). Juga perlu menggunakan perintah copy . (apt-get install xsel)
• Python-SetProctitle akan mengubah nama proses dari "Python" menjadi "offpunk". Berguna untuk membunuhnya tanpa membunuh setiap layanan Python.

Fitur

• Jelajahi https/gemini/gopher/spartan tanpa meninggalkan keyboard Anda dan tanpa gangguan
• Dokumentasi bawaan: Ketikkan help untuk mendapatkan daftar perintah atau bantuan khusus tentang perintah.
• Mode offline untuk menelusuri konten yang di -cache tanpa koneksi. Elemen yang diminta secara otomatis diambil selama sinkronisasi berikutnya dan ditambahkan ke tur Anda.
• Halaman HTML dipretifikasi untuk fokus pada konten. Baca tanpa terganggu atau lihat halaman lengkap dengan view full .
• Umpan RSS/Atom secara otomatis ditemukan dengan subscribe dan diterjemahkan sebagai Gemlog. Mereka dapat dieksplorasi dengan view feed dan view feeds .
• Mendukung "langganan" ke halaman. Konten baru yang terlihat di halaman berlangganan secara otomatis ditambahkan ke tur Anda berikutnya.
• Manajemen Bookmarks yang kompleks melalui beberapa daftar, edisi bawaan, daftar berlangganan/pembekuan dan konten pengarsipan.
• Alat navigasi canggih seperti tour dan mark (sesuai VF-1). Tidak seperti AV-98, Tour disimpan di Sesi Disk Accross.
• Kemampuan untuk menentukan program pawang eksternal untuk jenis mime yang berbeda (gunakan handler )
• Privasi yang ditingkatkan dengan redirect yang memungkinkan untuk memblokir domain HTTP atau untuk mengarahkan semua permintaan ke fronten ramah privasi (seperti nitter untuk Twitter).
• Pembangunan cache non-interaktif dengan kedalaman yang dapat dikonfigurasi melalui perintah --sync. Cache dapat dengan mudah digunakan oleh perangkat lunak lain.
• Dukungan IPv6
• Mendukung pengkodean karakter apa pun yang diakui oleh Python
• Cryptography: Tofu atau CA Sertifikat Sertifikat Sertifikat
• Cryptography: Dukungan Sertifikat Klien yang Luas Jika Biner openssl tersedia

File RC

Anda dapat menggunakan file RC untuk secara otomatis menjalankan urutan apa pun dari perintah offpunk yang valid saat memulai. Ini dapat digunakan untuk membuat pengaturan dikendalikan dengan set atau handler komandan persisten. Anda juga dapat memasukkan perintah go di file RC Anda untuk mengunjungi "beranda" secara otomatis saat startup, atau untuk pra-persiapan tour situs Gemini favorit Anda atau offline untuk offline secara default.

File RC harus dipanggil offpunkrc dan masuk $ xdg_config_dir/offpunk (atau .config/offpunk atau .offpunk jika XDG tidak tersedia). Dalam file itu, cukup tulis satu perintah per baris, sama seperti Anda akan mengetiknya di offpunk.

Desain cache

Konten offline disimpan dalam file. GMI/.html. Struktur ruang Gemini secara sementara diciptakan kembali. Salah satu elemen kunci dari desain adalah untuk menghindari database apa pun. Cache dengan demikian dapat dimodifikasi dengan tangan, konten dapat dihapus, digunakan atau ditambahkan oleh perangkat lunak selain dari Offpunk.

Tidak ada fitur untuk secara otomatis memangkas cache. Tetapi bagian dari cache dapat dengan aman dilepas secara manual.