mirror of
https://gh.wpcy.net/https://github.com/bohdanbobrowski/blog2epub.git
synced 2026-04-25 02:22:29 +08:00
111 lines
No EOL
3.5 KiB
Markdown
Executable file
111 lines
No EOL
3.5 KiB
Markdown
Executable file
<p align="center">
|
|
<img src="./assets/blog2epub_256px.png" width="256" height="256" />
|
|
</p>
|
|
|
|
# blog2epub
|
|
|
|
[](https://github.com/bohdanbobrowski/blog2epub/graphs/commit-activity) [](https://lbesson.mit-license.org/)   
|
|
|
|
Convert blog to epub using command line or GUI.
|
|
|
|
### Supported blogs:
|
|
- *.blogspot.com
|
|
- *.wordpress.com and some blogs based on WordPress
|
|
|
|
### Main features
|
|
|
|
- command line (CLI) and graphic user interface (GUI)
|
|
- script downloads all text contents of selected blog to epub file,
|
|
- if it's possible, it includes post comments,
|
|
- images are downsized (to maximum 800/600px) and converted to grayscale,
|
|
- one post = one epub chapter,
|
|
- chapters are sorted by date ascending,
|
|
- cover is generated automatically from downloaded images.
|
|
|
|
### Example covers
|
|
|
|
<table style="width:100%;text-align:center;"><tr><td>
|
|
<img src="./assets/cover_1.jpg" width="400" style="margin:0 10px 10px 0" />
|
|
</td><td>
|
|
<img src="./assets/cover_2.jpg" width="400" style="margin:0 10px 10px 0" />
|
|
</td></tr><tr><td>
|
|
<img src="./assets/cover_3.jpg" width="400" style="margin:0 10px 10px 0" />
|
|
</td><td>
|
|
<img src="./assets/cover_4.jpg" width="400" style="margin:0 10px 10px 0;" />
|
|
</td></tr></table>
|
|
|
|
## Installation
|
|
|
|
- for __Windows__ and __macOS__ users: available [builds](https://github.com/bohdanbobrowski/blog2epub/releases)
|
|
- python3 setup.py install
|
|
|
|
### Running froum sources
|
|
|
|
git clone git@github.com:bohdanbobrowski/blog2epub.git
|
|
cd blog2epub
|
|
python -m venv venv
|
|
source ./venv/bin/activate
|
|
pip install -r ./requirements.txt
|
|
./blog2epubgui.py
|
|
|
|
## Screenshots of GUI
|
|
|
|
### Windows 10
|
|
|
|
<p align="center">
|
|
<img src="./assets/blog2epub_win10_screenshot.png" width="600px" />
|
|
</p>
|
|
|
|
### macOS
|
|
|
|
<p align="center">
|
|
<img src="./assets/blog2epub_macos_screenshot.png" width="600px" />
|
|
</p>
|
|
|
|
### Linux
|
|
|
|
Mint 21.2 Cinnamon
|
|
|
|
<p align="center">
|
|
<img src="./assets/blog2epub_linux_screenshot.png" width="600px" />
|
|
</p>
|
|
|
|
## CLI
|
|
|
|
blog2epub [blog url] <parameters>
|
|
|
|
### Parameters
|
|
|
|
-l/--limit=[x] - limit epub file to x posts
|
|
-s/--skip=[x] - skip x latest posts
|
|
-q/--images-quality=[0-100] - included images quality (default is 40)
|
|
-n/--no-images - don't include images
|
|
|
|
## Examples
|
|
|
|
blog2epub starybezpiek.blogspot.com
|
|
blog2epub velosov.blogspot.com -l=10
|
|
blog2epub poznanskiehistorie.blogspot.com -q=100
|
|
blog2epub classicameras.blogspot.com --limit=10 --no-images
|
|
|
|
## Planned features and known bugs
|
|
|
|
- [ ] utilize GitHub Pages for this project documentation
|
|
- [ ] there are some bugs in wordpress.com crawler
|
|
- [ ] Linux app/package(s)
|
|
- [ ] Android app
|
|
- [ ] code needs some refactor: classes are too "nested" within each other
|
|
- [ ] more crawlers (ex. GitHub Pages 🙃)
|
|
- [ ] improve existing crawlers (allow)
|
|
- [ ] improve GUI - configuration, allow to save in selected place etc.
|
|
|
|
## Change Log
|
|
|
|
### [v1.2.6](https://github.com/bohdanbobrowski/blog2epub/releases/tag/v1.2.6) - 2024-03-30
|
|
_bugfix release_
|
|
- [x] resistance to broken links
|
|
- [x] atom feed when skipped
|
|
- [x] better comments support
|
|
- [x] more random cover generator
|
|
|
|
[» Complete Change Log here «](https://github.com/bohdanbobrowski/blog2epub/blob/master/CHANGELOG.md) |
