blog2epub

Blog2epub

Konversi blog ke epub menggunakan baris perintah atau gui.

Tujuan utama saya dalam membuat aplikasi ini adalah untuk melestarikan warisan blogosphere untuk generasi mendatang.

Blog yang Didukung:

• *.blogspot.com
• *.wordpress.com
• Beberapa blog lain dan bahkan beberapa halaman web

Fitur utama

• Baris Perintah (CLI) dan Antarmuka Pengguna Grafis (GUI)
• Skrip Mengunduh Semua Isi Teks dari File Blog yang Dipilih ke Epub,
• Jika memungkinkan, itu termasuk komentar posting,
• Gambar dirampingkan (hingga maksimum 800/600px) dan dikonversi menjadi skala abu -abu,
• satu posting = satu bab epub,
• bab diurutkan berdasarkan tanggal naik,
• Sampul dihasilkan secara otomatis dari gambar yang diunduh.

Contoh sampul

Instalasi

Checkout untuk build terbaru yang tersedia.

Berlari dari sumber

Cara termudah

 pip install git+https://github.com/bohdanbobrowski/blog2epub.git

Lingkungan Pengembang

 git clone [email protected]:bohdanbobrowski/blog2epub.git
cd blog2epub
python -m venv venv

Windows:

 venvScriptsactivate
pip install -e .[dev]

MacOS/Linux:

 source ./venv/bin/activate
pip install -e .[dev]

Membangun sendiri yang dapat dieksekusi

Windows

 python blog2epub_build_windows.py

Akhirnya, Anda dapat menjalankan NSIS untuk membangun Windows Installer:

 "C:Program Files (x86)NSISmakensis" blog2epub_windows_installer.nsi

MacOS

 python blog2epub_build_macos.py

Dan kemudian untuk membuat gambar DMG dengan aplikasi:

 ./make_macos_dmg.sh

Android

Sebelum Anda mulai, Anda harus menginstal Buildozer mengikuti dokumentasi instalasi ini.

 buildozer -v android

Tangkapan layar GUI

Android (Google Pixel 6A)

Windows (11)

Linux (Manjaro Gnome)

MacOS (Sonoma 14.4.1)

Cli

 blog2epub --help
usage: Blog2epub Cli interface [-h] [-l LIMIT] [-s SKIP] [-q QUALITY] [-o OUTPUT] [-d] url

Convert blog (blogspot.com, wordpress.com or another based on Wordpress) to epub using CLI or GUI.

positional arguments:
  url                   url of blog to download

options:
  -h, --help            show this help message and exit
  -l LIMIT, --limit LIMIT
                        articles limit
  -s SKIP, --skip SKIP  number of skipped articles
  -q QUALITY, --quality QUALITY
                        images quality (0-100)
  -o OUTPUT, --output OUTPUT
                        output epub file name
  -d, --debug           turn on debug

Contoh:

 blog2epub starybezpiek.blogspot.com -l=2 -o=example.epub
Starting blogger.com crawler
Found 54 articles to crawl.
Downloading.
1. 10 lat kremlowskiej propagandy, czyli RT ujawnia swoje sekrety
Downloading.
2. "Komunę obaliliśmy, a nadal jest źle. Dlaczego?" Czyli 1984 Orwella właściwie odczytany
Locale set as en_US.UTF-8
Generating cover (800px*600px) from 1 images.
Cover generated: .starybezpiek.blogspot.comexample.epub.jpg
Epub created: .example.epub

Contoh

 blog2epub starybezpiek.blogspot.com
blog2epub velosov.blogspot.com -l=10
blog2epub poznanskiehistorie.blogspot.com -q=100
blog2epub classicameras.blogspot.com --limit=10 --no-images

Menjalankan tes

 pytest ./tests
pytest --cov=blog2epub ./tests
pytest --cov=blog2epub --cov-report=html ./tests

Versi saat ini

v1.5.0 - kandidat rilis 2

• pengujian integrasi
• Tingkatkan Cakupan Uji Unit
• Gunakan sitemaps.xml untuk mengikis
• Refactor Crawlers
  • Gunakan model data
  • Metode yang lebih umum di kelas crawler
  • Perluas Abstrak Crawler
• refactor antarmuka CLI
• Dukungan alfabet Yunani
• gambar unduhan dan lampiran bug diselesaikan (mis. Modernistyczny-poznan.blogspot.com)
• Peningkatan resistensi terhadap kesalahan HTTP
• Kelas crawler khusus untuk zeissikonveb.de
• (On GUI) Nilai lewati diperbesar pada nilai batas (jika disetel)
• Download Progress jauh lebih banyak verbose, juga di GUI dapat dibatalkan setiap kali
• Hapus puisi karena terlalu rumit untuk kasingnya,
• Penginstal Windows!
• Hasil unduhan yang dibatalkan mungkin dikonversi ke EPUB

»Lengkapi perubahan log di sini«

Backlog Proyek

Dan akhirnya, daftar bug yang diketahui dan rencana masa depan untuk beberapa fungsi dan peningkatan baru: backlog.md

Project Road Map:

• 1.0 - agak berfungsi
• 2.0 - Proyek yang berfungsi penuh, unit 90% diuji dan build yang tersedia untuk Android/Windows/Linux/MacOS