\fBreadability-cli\fR\- get useful text from a web page
.SHSYNOPSYS
.P
\fBreadable\fR\fI[SOURCE]\fR\fI[options]\.\.\.\fR
.SHDESCRIPTION
.P
\fBreadability\-cli\fR takes any HTML page and strips out unnecessary bloat, leaving only the core text content\. The resulting HTML may be suitable for terminal browsers, text readers, and other uses\.
.P
This package provides the \fBreadable\fR command, which uses Mozilla's Readability library\. The same library is used in Firefox's Reader View\.
.SHOPTIONS
.P
The \fISOURCE\fR can be a URL, a file, or '\-' for standard input\.
.P
\fB\-\-help\fP
.RS0
.IP\(bu2
Show help message, and exit\.
.RE
.P
\fB\-b\fP, \fB\-\-base\fP\fIURL\fR
.RS0
.IP\(bu2
Specify the document's URL\. This affects relative links: they will not work if \fBreadability\-cli\fR does not know the base URL\. You only need this option if you read HTML from a local file, or from standard input\.
.RE
.P
\fB\-i\fP, \fB\-\-insane\fP
.RS0
.IP\(bu2
Don't sanitize HTML\.
.RE
.P
\fB\-K\fP, \fB\-\-insecure\fP
.RS0
.IP\(bu2
Allow invalid SSL certificates\.
.RE
.P
\fB\-j\fP, \fB\-\-json\fP
.RS0
.IP\(bu2
Output all known properties of the document as JSON (see \fBProperties\fR subsection)\.
.RE
.P
\fB\-l\fP, \fB\-\-low\-confidence\fP\fIMODE\fR
.RS0
.IP\(bu2
What to do if Readability is uncertain about what the core content actually is\. The possible modes are:
.RS
.IP\(bu2
\fBkeep\fR\- When unsure, don't touch the HTML, output as\-is\.
.IP\(bu2
\fBforce\fR\- Process the document even when unsure (may produce really bad output)\.
.IP\(bu2
\fBexit\fR\- When unsure, exit with an error\.
.RE
.IP\(bu2
The default value is \fBkeep\fR\|\. If the \fB\-\-properties\fP or \fB\-\-json\fP options are set, the program will always run in \fBexit\fR mode\.
.RE
.P
\fB\-C\fP, \fB\-\-keep\-classes\fP
.RS0
.IP\(bu2
Preserve CSS classes for input elements\. By default, CSS classes are stripped, and the input is adapted for Firefox's Reader View\.
* By "standard error codes" I mean "close to a standard"\. And by that I mean: I actually don't remember any command line tools which use this convention\. You may find more info in \fBsysexits\fR(3), or maybe just \fIsysexits\.h\fR\|\.
\fBreadability\-cli\fR supports localization, using the environment variables \fBLC_ALL\fP, \fBLC_MESSAGES\fP, \fBLANG\fP and \fBLANGUAGE\fP, in that order\. Only one language at a time is supported\.
.P
\fBHTTPS_PROXY\fP will set the HTTPS proxy, as previously stated, however the \fB\-\-proxy\fP option overrides this\. Lowercase \fBhttps_proxy\fP and \fBhttp_proxy\fP are also recognized\.
.SHEXAMPLE
.P
\fBRead HTML from a file and output the result to the console:\fR
.P
.RS2
.nf
readable index\.html
.fi
.RE
.P
\fBFetch a random Wikipedia article, get its title and an excerpt:\fR