暗无天日

=============>DarkSun的个人博客

把archwiki搬回家

archlinux最令人惊叹的莫过于它完善的wiki了。今天偶然发现archlinux上有两个package分别为 arch-wiki-litearch-wiki-docs,装好之后就能在本地浏览archwiki了。

关于 arch-wiki-litearch-wiki-docs 这两个package的描述为:

[lujun9972@T520 ~]$ pacman -Ss arch-wiki
community/arch-wiki-docs 20180105-1 [已安装]
    Pages from Arch Wiki optimized for offline browsing
community/arch-wiki-lite 20170410-1 [已安装]
    The wiki without html. 1/9 as big, easily searched and viewable on console.

其中 arch-wiki-docs 提供了离线的html格式的文档,而且文档较新,而 arch-wiki-lite 提供的是文本格式的文档,而且提供了 wiki-searchwiki-search-html 两个工具来搜索wiki。

使用wiki-search搜索离线wiki

直接运行 wiki-search 会列出使用说明

wiki-search
Search and view your local copy of the Arch wiki.

Search with 'wiki-search [query]' where query is a regex
or a list of terms to match individually.
If 'dialog' is not installed you will have to choose
pages with 'wiki-search [number]' where number can be a search
result (0-9), partial ID (NNNN), or full ID (0000NNNN).
Regex is case insensitive.
See every page title with --all.
Get a summary of languages with --lang.
Viewer is 'less' or $PAGER.  $PAGER disables colored output.
Access non-english pages by exporting $wiki_lang first.
Force the width (and bypass dialog) by exporting $wiki_width.

最简单的方法就是直接带上要搜索的内容,比如要搜索pacman相关内容可以:

wiki-search pacman

在安装了 dialog 的情况下,会显示一个选择框,列出了所有包含关键字的主题让你选择,如下图所示

screenshot-04.png

将光标移动到要查看的主题上按下回车后就会显示具体内容了

screenshot-06.png

按下 SPACEPAGEDOWN 向下翻页,按下 bPAGEUP 向上翻页

按下 j 向下一行,按下 k 向上一行

除了搜索英文资料外,还能搜索中文资料:

wiki_lang=zh-CN wiki-search pacman

screenshot-07.png

screenshot-09.png

不过,并不推荐搜索中文wiki,资料更新慢是一方面,最关键是中文字的截断很明显是有问题的。

如何真的想看中文资料,推荐使用 wiki-search-html 来代替 wiki-search,它唯一的区别是用浏览器打开相应的html页面来看,至少不存在中文字截断的问题。

而如果没有安装 dialogwiki-search 会列出每个主题对应的编号,

Now choose a page with wiki-search [number]

0  Pacman                                             00003045
1  Pacman/Tips and tricks                             00004600
2  Pacman/Rosetta                                     00004598
3  Pacman/Package signing                             00004597
4  Migrating between architectures                    00004127
5  DeveloperWiki:Package Signing Proposal for Pacman  00003237
6  Mirrors                                            00002732
7  System maintenance                                 00003087
8  Pacman/Restore local database                      00004601
9  Update packages from crontab                       00004151

然后需要你再执行一次 wiki-search 编号 来查看具体的内容。

wiki-search 00003045

通过 --lang 可以查看每种语言的资料数

wiki-search --lang

结果为

2240 en
 570 zh-CN
 530 ru
 429 es
 350 it
 153 cs
 130 zh-TW
 105 pt
  87 ko
  80 uk
  77 el
  74 ar
  71 pl
  65 sr
  49 nl
  37 sk
  31 hu
  30 da
  27 lt
  25 th
  25 bg
  24 id
  12 hr
  11 he
   6 fi
   6 eo
   4 ca
   1 sv
   1 nb

可以看到最多的是英文资料,有两千多篇。而排在第二的居然是中文有570篇。