selfoss

selfoss 2.20-SNAPSHOT

selfoss adalah aplikasi web pembaca RSS multiguna dan agregasi feed. Ini memungkinkan Anda dengan mudah mengikuti pembaruan dari berbagai situs web, jejaring sosial, dan platform lainnya, semuanya di satu tempat. Itu ditulis dalam PHP, memungkinkan Anda menjalankannya di mana saja.

Untuk informasi lebih lanjut kunjungi situs web kami.

Status

selfoss saat ini dikelola oleh Jan Tojnar di waktu luangnya. Karena keterbatasan kapasitas, pemeliharaan lebih diprioritaskan dibandingkan fitur baru. Permintaan penarikan dipersilakan, lihat panduan Berkontribusi.

Unduh

• Rilis stabil – jika Anda hanya ingin menggunakan selfoss.
• Versi pengembangan – jika Anda ingin mencoba fitur yang belum dirilis atau perbaikan bug, atau membantu mengujinya. Diselenggarakan oleh Cloudsmith
• Kode sumber yang dilacak Git – jika Anda ingin bergabung dengan pengembangan selfoss. Diperlukan beberapa perakitan.

Instalasi

1. Unggah semua file di direktori ini (PENTING: unggah juga file .htaccess yang tidak terlihat).
2. Jadikan direktori data/cache , data/favicons , data/logs , data/thumbnails dan data/sqlite dapat ditulisi.
3. Masukkan data akses database di config.ini (lihat di bawah). Anda tidak perlu mengubah apa pun jika ingin menggunakan SQLite.
4. Anda tidak perlu membuat tabel database, tabel tersebut akan dibuat secara otomatis (pastikan pengguna database Anda diizinkan membuat pemicu).
5. Buat pengatur waktu cronjob atau systemd untuk memperbarui feed dan arahkan ke https://yourselfossurl.com/update melalui wget atau curl. Anda juga dapat menjalankan cliupdate.php dari baris perintah.

Jika Anda memperoleh selfoss menggunakan Git, diperlukan beberapa langkah lagi. Lihat bagian pengembangan.

Untuk pertanyaan lebih lanjut atau masalah apa pun, gunakan forum dukungan kami: https://forum.selfoss.aditu.de/

Konfigurasi

Tidak diperlukan konfigurasi untuk menggunakan selfoss tetapi Anda dapat menyesuaikan pengaturannya sebagai berikut:

1. Ganti nama config-example.ini menjadi config.ini .
2. Edit config.ini dan hapus baris apa pun yang tidak ingin Anda timpa.
3. Lihat https://selfoss.aditu.de/ untuk contohnya.

Memperbarui

1. Cadangkan database dan direktori data/ Anda.
2. (PENTING: JANGAN hapus direktori data/ ) hapus semua file dan direktori lama kecuali direktori data/ dan file config.ini
3. Unggah semua file dan direktori baru kecuali direktori data/ (PENTING: unggah juga file .htaccess yang tidak terlihat).
4. Lihat file NEWS untuk mempelajari tentang perubahan yang tidak kompatibel.
5. Bersihkan cache browser Anda.
6. Masukkan koneksi database Anda saat ini dan konfigurasi individual Anda di config.ini . Penting: kami mengubah config.ini dan menambahkan opsi baru di versi yang lebih baru. Anda harus memperbarui config.ini juga.
7. Basis data akan diperbarui secara otomatis (pastikan pengguna basis data Anda diizinkan membuat pemicu).

Jika Anda memperoleh selfoss menggunakan Git, beberapa langkah lagi mungkin diperlukan. Lihat bagian pengembangan.

Untuk pertanyaan lebih lanjut atau masalah apa pun, gunakan forum dukungan kami: https://selfoss.aditu.de/forum

Mendukung

• Pelacak masalah untuk melaporkan masalah dan meminta fitur baru
• Forum untuk pertanyaan umum tentang penggunaan
• Ngobrol di Gitter (atau #selfoss:matrix.org mirror) untuk mendiskusikan pengembangan selfoss atau apa saja

Impor OPML

Selfoss mendukung impor file OPML. Temukan ekspor OPML di aplikasi lama, biasanya terletak di suatu tempat di pengaturan. Kemudian kunjungi halaman https://yourselfossurl.com/opml dan unggah di sana.

Aplikasi Pihak Ketiga

Kami merekomendasikan Reader For Selfoss untuk perangkat Android.

Perkembangan

Selfoss menggunakan composer dan npm untuk menginstal perpustakaan eksternal. Saat Anda mengkloning repositori, Anda harus mengeluarkan composer install untuk mengambil sumber eksternal.

Untuk sisi klien, Anda juga perlu menginstal dependensi JavaScript dengan memanggil npm install di direktori client/ . Anda dapat menggunakan npm run install-dependencies sebagai pintasan untuk menginstal kedua set dependensi.

Kami menggunakan Parcel (diinstal dengan perintah di atas) untuk membangun sisi klien selfoss. Setiap kali ada perubahan di direktori client/ , Anda perlu menjalankan npm run build agar klien dapat dibangun dan diinstal ke direktori public . Saat mengembangkan, Anda juga bisa menggunakan npm run dev ; ia akan mengamati perubahan aset, membangun kembali bundel sesuai kebutuhan, dan memuat ulang selfoss secara otomatis. Saat beralih antara npm run dev dan npm run build , Anda mungkin perlu menghapus client/.cache .

Jika Anda ingin membuat paket dengan semua dependensi yang dibundel, Anda dapat menjalankan perintah npm run dist untuk menghasilkan zipball.

Setiap patch diharapkan mematuhi gaya pengkodean kami, yang diperiksa secara otomatis oleh CI. Anda dapat menginstal pemeriksa secara lokal menggunakan npm run install-dependencies , lalu menjalankan pemeriksaan menggunakan npm run check sebelum mengirimkan permintaan penarikan. Ada juga npm run fix , yang akan mencoba memperbaiki pemformatan.

Kredit

selfoss dibuat oleh Tobias Zeising, dan kode sumbernya dilisensikan di bawah lisensi GNU General Public versi 3, atau (sesuai pilihan Anda) versi yang lebih baru.

Beberapa bagian dari kode sumber hanya dapat dilisensikan di bawah versi 3, saat ini kami sedang mencoba menyelesaikannya.

Paket dengan dependensi yang dibundel mungkin hanya didistribusikan di bawah versi 3.

Terima kasih yang sangat khusus kepada semua kontributor permintaan tarik di GitHub, serta penerjemah di Weblate. Peningkatan Anda luar biasa!

Terima kasih khusus kepada pemrogram hebat dari perpustakaan berikut yang digunakan oleh selfoss:

• Kerangka PHP Bebas Lemak
• kue sederhana
• Gambar Lebar
• htmHukum
• Pembuat Umpan Universal PHP
• Elphin IcoFileLoader
• ambil
• Filter FullTextRSS
• satu lagi-reaksi-lightbox

Ikon dibuat oleh http://blackbooze.com/

Paket hosting repositori disediakan dengan baik oleh Cloudsmith. Cloudsmith adalah satu-satunya solusi manajemen paket universal yang sepenuhnya dihosting, cloud-native, yang memungkinkan organisasi Anda membuat, menyimpan, dan berbagi paket dalam format apa pun, di mana pun, dengan penuh keyakinan.