Unduhan NewsBlur - Unduhan kode sumber NewsBlur

NewsBlur

ular piton

1.0.0

Unduh

BeritaBlur

NewsBlur adalah pembaca berita pribadi yang menyatukan orang-orang untuk membicarakan dunia. Suara baru dari instrumen lama.
www.newsblur.com.
Dibuat oleh Samuel Clay.
X/Twitter: @samuelclay dan @newsblur.

Fitur

Menampilkan situs aslinya (Anda harus melihatnya untuk mempercayainya).
Menyembunyikan cerita yang tidak ingin Anda baca berdasarkan tag, kata kunci, penulis, dll.
Soroti cerita yang ingin Anda baca, berdasarkan kriteria yang sama.

Teknologi

Sisi server

Python 3.7+: Bahasa pilihan.
Django: Kerangka web yang ditulis dengan Python, digunakan untuk melayani semua halaman.
Celery & RabbitMQ: Server antrian asinkron, digunakan untuk mengambil dan mengurai RSS feed.
MongoDB, Pymongo, & Mongoengine: Basis data non-relasional, digunakan untuk menyimpan cerita, membaca cerita, riwayat pengambilan feed/halaman, dan situs proksi.
PostgreSQL: Basis data relasional, digunakan untuk menyimpan feed, langganan, dan akun pengguna.
Redis: Basis data pemrogram, digunakan untuk menyusun cerita untuk sungai, menyimpan id cerita, mengatur jadwal pengambilan feed, dan sedikit cache yang digunakan NewsBlur.
Elasticsearch: Pencarian database, digunakan untuk mencari cerita. Opsional.

Sisi klien dan desain

jQuery: Kode JavaScript yang sesuai dengan lintas browser. IE bekerja tanpa usaha.
Underscore.js: Pemrograman fungsional untuk JavaScript. Sangat diperlukan.
Backbone.js: Kerangka kerja untuk aplikasi web. Juga sangat diperlukan.
Plugin jQuery lain-lain: Semuanya mulai dari tata letak yang dapat diubah ukurannya, hingga bilah kemajuan, pengurutan, penanganan tanggal, warna, sudut, JSON, animasi. Lihat daftar lengkapnya.

Prasyarat

 * Docker
* Docker-compose

Petunjuk Instalasi

Kloning repo ini
Jalankan make nb untuk membuat semua container NewsBlur. Ini akan menyiapkan semua database yang diperlukan, aplikasi Django front-end, tugas seledri, aplikasi node, monitor dan metrik database flask, nginx, dan penyeimbang beban haproxy.
Arahkan ke:
```
 https://localhost
```
Catatan: Anda akan diperingatkan bahwa Anda menggunakan sertifikat yang ditandatangani sendiri. Untuk mengatasi peringatan ini Anda harus mengetik "thisisunsafe" sesuai postingan blog ini.

Menggunakan domain khusus

Jalankan skrip domain khusus
```
 bash ./utils/custom_domain.sh <domain name>
```
Skrip ini akan melakukan hal berikut:
- Ubah NEWSBLUR_URL dan SESSION_COOKIE_DOMAIN di newsblur_web/docker_local_settings.py
- Ubah domain di config/fixtures/bootstrap.json

Anda juga dapat mengubah domain: bash ./utils/custom_domain.sh <old domain> <new domain>

Jika Anda menggunakan subdomain khusus, Anda juga dapat menambahkannya ke ALLOWED_SUBDOMAINS di apps/reader/views.py
Cara untuk memastikan Anda memperbarui semua tempat yang benar:
- Buka alamat situs web di browser Anda
- Buka alat pengembang dan lihat tab jaringan
- Cobalah untuk masuk
- Lihat lagi alat pengembang, seharusnya ada panggilan POST ke /login
- Amati header Respons untuk panggilan itu
- Nilai header "set-cookie" harus berisi string "Domain="
Jika string setelah Domain= bukan domain yang Anda gunakan untuk mengakses situs web, maka konfigurasi Anda masih memerlukan domain khusus Anda.
Anda juga dapat mengonfirmasi bahwa ada ketidakcocokan nama domain dalam database dengan menjalankan make shell & mengetik Site.objects.all()[0] untuk menampilkan domain yang diharapkan NewsBlur.

Membuat komposisi buruh pelabuhan berfungsi dengan database Anda yang sudah ada

Agar docker-compose berfungsi dengan database Anda, tingkatkan database lokal Anda ke versi docker-compose dan kemudian volumekan jalur data database dengan mengubah bagian ./docker/volumes/ dari direktif volume di layanan agar mengarah ke database lokal Anda direktori data.

Agar docker-compose berfungsi dengan versi database yang lebih lama, ubah versi gambar untuk layanan database di file docker-compose.

Petunjuk Kontribusi

Membuat Perubahan:
- Untuk menerapkan perubahan pada kode Python atau JavaScript, gunakan perintah make .
- Untuk menerapkan perubahan pada file docker-compose.yml, gunakan perintah make rebuild .
- Untuk menerapkan perubahan pada file docker/haproxy/haproxy.conf, paket node, atau migrasi database baru apa pun, Anda perlu menggunakan perintah make nb .
Menambahkan paket Python: Saat ini, file docker-compose.yml menggunakan gambar newsblur/newsblur_python3. Itu dibangun menggunakan Dockerfile yang ditemukan di docker/newsblur_base_image.Dockerfile . Karena cara pengaturan gambar buruh pelabuhan, Anda perlu membuat gambar Anda sendiri dan mengarahkan file docker-compose.yml Anda untuk menggunakannya. Silakan ikuti langkah-langkah berikut untuk melakukannya.
1. Tambahkan paket situs baru Anda ke config/requirements.txt.
2. Tambahkan baris kode berikut ke file docker-compose.yml Anda untuk menggantikan di mana pun yang tertulis image: newsblur/newsblur_python3
build: context: . dockerfile: docker/newsblur_base_image.Dockerfile
1. Jalankan perintah make nb untuk membangun kembali kontainer penulisan buruh pelabuhan Anda
Men-debug Python
- Untuk men-debug kode Anda, hapus import pdb; pdb.set_trace() ke dalam kode Python tempat Anda ingin memulai debugging dan menjalankan make lalu make debug .
Menggunakan shell Django di dalam Docker
- Pastikan kontainer buruh pelabuhan Anda aktif dan jalankan make shell untuk membuka shell Django di dalam kontainer newsblur_web.

Menjalankan pengujian unit dan integrasi

NewsBlur dilengkapi dengan rangkaian pengujian yang menguji fungsionalitas rss_feeds, pembaca, dan pengimpor feed. Untuk menjalankan rangkaian pengujian:

 `make test`

Menjalankan tes kinerja

Pengujian kinerja menggunakan alat pengujian kinerja belalang. Untuk menjalankan tes kinerja melalui CLI, gunakan make perf-cli users=1 rate=1 host=https://localhost . Jangan ragu untuk mengubah variabel pengguna, tarif, dan host dalam perintah untuk memenuhi kebutuhan Anda.

Anda juga dapat menjalankan pengujian kinerja belalang menggunakan UI dengan menjalankan make perf-ui lalu menavigasi ke http://127.0.0.1:8089. Ini memungkinkan Anda membuat bagan dan mengekspor data kinerja Anda.

Untuk menjalankan belalang menggunakan buruh pelabuhan, jalankan saja make perf-docker dan navigasikan ke http://127.0.0.1:8089