Rebranding, adding README

yargs
gardenapple 4 years ago
parent 23f48e385f
commit 455d696305
No known key found for this signature in database
GPG Key ID: CAF17E9ABE789268

@ -0,0 +1,68 @@
# reader-view-cli
**Firefox Reader View in your terminal!**
**reader-view-cli** takes any HTML page and strips out unnecessary bloat by using [Mozilla's Readability library](https://github.com/mozilla/readability). As a result, you get a web page which contains only the core content and nothing more. The resulting HTML is suitable for terminal browsers, text readers, or perhaps other use-cases.
### An example of Reader View in Firefox:
**Standard view in Firefox**
![An article from The Guardian with standard view in Firefox](https://i.imgur.com/6xyyShd.png "Standard view in Firefox")
**Reader View in Firefox**
![An article from The Guardian with Reader View in Firefox](https://i.imgur.com/V27OUch.png "Reader View in Firefox")
#### An example of reader-view-cli with W3M browser:
**Standard view in W3M**
![An article from The Guardian in W3M](https://i.imgur.com/kAeCfh1.png "Standard view in W3M")
**reader-view-cli + W3M**
![An article from The Guardian in W3M using reader-view-cli](https://i.imgur.com/KaSY1JS.png "reader-view-cli with W3M")
## Usage
`readable [SOURCE] [options]`
`readable [options] -- [SOURCE]`
(where SOURCE is a file, an http(s) URL, or '-' for standard input)
Options:
```
--help Print help
-o --output OUTPUT_FILE Output to OUTPUT_FILE
-p --properties PROP1,[PROP2,...] Output specific properties of the parsed article
-V --version Print version
-u --url Interpret SOURCE as a URL
-q --quiet Don't output extra information to stderr
```
The --properties option accepts a comma-separated list of values (with no spaces in-between). Suitable values are:
```
html-title Outputs the article's title, wrapped in an <h1> tag.
title Outputs the title in the format "Title: $TITLE".
excerpt Article description, or short excerpt from the content, in the format "Excerpt: $EXCERPT"
byline Author metadata, in the format "Author: $AUTHOR"
length Length of the article in characters, in the format "Length: $LENGTH"
dir Content direction, is either "Direction: ltr" or "Direction: rtl"
html-content Outputs the article's main content as HTML.
text-content Outputs the article's main content as plain text.
```
Text-content and Html-content are mutually exclusive, and are always printed last.
Default value is "html-title,html-content".
### Usage examples
**Read HTML from a file and output the result to the console:**
`readable index.html`
**Fetch a web page and read it in W3M:**
`readable https://www.wikipedia.org/ | w3m -T text/html`
**Download a web page using cURL, get the title, the content, and an excerpt in plain text:**
`curl https://example.com/page | readable -p title,excerpt,text-content`

@ -1,5 +1,5 @@
{
"name": "readable-cli",
"name": "reader-view-cli",
"version": "0.0.1",
"description": "Firefox Reader Mode in your terminal - get useful text from a web page using Mozilla's Readability library",
"main": "index.js",
@ -9,7 +9,12 @@
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"author": "gardenapple",
"repository": "gitlab:gardenappl/reader-view-cli",
"author": "gardenapple <gardenapple@posteo.net>",
"bugs": "https://gitlab.com/gardenappl/reader-view-cli/-/issues",
"keywords": [
"console", "terminal", "cli", "readability", "html", "readability-cli"
],
"license": "GPL-3.0-only",
"dependencies": {
"he": "^1.2.0",

Loading…
Cancel
Save