downwards

您想在终端中直接阅读维基百科页面，对吧？ RIGHT?

我知道因为我想要它。

downwards会下载您想要的文章，将其转换为mdoc，并使用您的本地man二进制文件显示它。

$ 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.

我发现设置export MANWIDTH=80以获得易于阅读的文档非常有帮助。

安装

安装

pip3 install downwards

开发

pip3 install --upgrade .

背景

我想与OpenBSD的mandoc玩耍，并学习mdoc是如何工作的。然后我玩了一下维基百科，并把这两件事结合起来。

然而，一旦我得到了一个原型并开始运行，我就开始喜欢它了。它感觉就像浏览器中的“阅读器”功能，但只在您的终端中直接使用。

错误和已知问题

在自动生成的mdoc文档中，总有一些东西会抛出警告。由于您无法让man忽略它们，我需要按下ctrl+l来重置这些警告。

man实际上并不是为了显示广泛范围的特殊utf8字符而设计的（无论是OpenBSD、Linux还是macOS）。我已经尽力去除这些字符或用ae等替换德语重音符号。