Skip to main content

downwards lets you read a wikipedia page on command line as a manpage.

Project description

downwards

You want to read a wikipedia page right from your terminal, right? RIGHT?

I know because I wanted it.

downwards is downloading the article you want, converts it to mdoc and displays it using your local man binary.

$ downwards OpenBSD
$ downwards 'Theo de Raadt'
$ downwards 'Python (Programming Langauge)'
$ downwards --help
Usage: downwards [OPTIONS] ARTICLE

  downwards lets you read a wikipedia page on command line as a manpage.

Options:
  -l, --language TEXT  Language for wikipedia
  -s, --stdout         Print to stdout
  --help               Show this message and exit.

I found it very helpful to set export MANWIDTH=80 for nicely readable documents.

Image of an Example Wikipedia Page

Installation

Installation

pip3 install downwards

Development

pip3 install --upgrade .

Background

I wanted to play around with OpenBSDs mandoc and learn how mdoc works. Then I played around with Wikipedia and put both things together.

However, once I got a first prototype up and running, I started liking it. It feels like a "reader"-feature from your browser, but only from your terminal right at hand.

Bugs and Known Issues

There are always some things in automatically generated mdoc documents that throw warnings. Since you cannot make man ignoring them, I need to press ctrl+l to reset those warnings.

man is really not made to display a wide range of special utf8 characters (neither on OpenBSD, Linux nor macOS). I've done what I can to strip those away or replace german umlauts with ae for example.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

downwards-1.3.1.tar.gz (6.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page