Add README
This commit is contained in:
parent
1b4c4ee658
commit
6aef1631e3
2 changed files with 53 additions and 0 deletions
53
README.md
Normal file
53
README.md
Normal file
|
@ -0,0 +1,53 @@
|
|||
<img src="./paperoni-dark.png" width="400" style="display: block;margin-left: auto; margin-right: auto;">
|
||||
|
||||
<p style="text-align:center;"><i>Salami not included</i></p>
|
||||
|
||||
Paperoni is a web article downloader written in Rust. The downloaded articles are then exported as EPUB files.
|
||||
|
||||
> This project is in an alpha release so it is pretty unstable.
|
||||
|
||||
## Usage
|
||||
|
||||
```sh
|
||||
paperoni https://en.wikipedia.org/wiki/Pepperoni
|
||||
```
|
||||
|
||||
Paperoni also supports passing multiple links as arguments. If you are on a Unix-like OS, you can simply do something like this:
|
||||
|
||||
```sh
|
||||
cat links.txt | xargs paperoni
|
||||
```
|
||||
|
||||
## How it works
|
||||
|
||||
The URL passed to Paperoni is fetched and the returned HTML response is passed to the extractor.
|
||||
This extractor retrieves a possible article using a port of the [Mozilla Readability algorithm](https://github.com/mozilla/readability). This article is then saved in an EPUB.
|
||||
|
||||
> The port of the algorithm is still unstable as well so it is not fully compatible with all the websites that can be extracted using Readability.
|
||||
|
||||
## How it (currently) doesn't work
|
||||
|
||||
This program is still in alpha so a number of things currently break:
|
||||
|
||||
- Links with redirects will crash the program as it has no redirect logic.
|
||||
- Websites that only run with JavaScript cannot be extracted.
|
||||
- Website articles that cannot be extracted by Readability cannot be extracted by Paperoni either.
|
||||
|
||||
## Running locally
|
||||
|
||||
### Precompiled binaries
|
||||
|
||||
Check the [releases](https://github.com/hipstermojo/paperoni/releases) page for precompiled binaries. Currently there are only builds for Debian and Arch.
|
||||
|
||||
### Building from source
|
||||
|
||||
This project uses `async/.await` so it should be compiled using a minimum Rust version of 1.33. Preferrably use the latest version of Rust.
|
||||
|
||||
```sh
|
||||
git clone https://github.com/hipstermojo/paperoni.git
|
||||
cd paperoni
|
||||
## You can build and install paperoni locally
|
||||
cargo install --path .
|
||||
## or use it from within the project
|
||||
cargo run -- # pass your url here
|
||||
```
|
BIN
paperoni-dark.png
Normal file
BIN
paperoni-dark.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 7.9 KiB |
Loading…
Reference in a new issue