使用自制archwiki查看器代替arch-wiki-lite

arch官方源里带了一个叫arch-wiki-lite的包,可以用在终端下离线查看archwiki(或打开archwiki的html文件),但是我个人不太喜欢它的TUI界面(dialog),于是就有了自己做的想法

必要的软件包

fzf - 强大的模糊查找器
ripgrep - 提供rg命令(grep工具的替代品)

1
sudo pacman -S fzf ripgrep

实例

1
2
3
4
5
6
7
#!/bin/bash
cd /usr/share/doc/arch-wiki/html/en &&
rg -l "$1" | fzf \
--bind 'ctrl-o:execute(xdg-open {})+abort' \
--bind 'ctrl-p:preview-up,ctrl-n:preview-down,ctrl-b:preview-page-up,ctrl-f:preview-page-down' \
--preview 'w3m {}' \
--bind 'enter:execute(xdg-open {})+abort'

在此之前您需要安装arch-wiki-docs包以提供archwiki的html文档

  • Ctrl + o 会直接使用xdg-open打开浏览器查看,tty/ssh下会打开w3m之类的终端浏览器
  • --bind 'enter:execute(xdg-open {})+abort' 这条设置了在fzf中对文件回车后执行上述操作(使用xdg-open打开浏览器)
  • --preview 'w3m {}' 左边会有一个预览,用w3m查看html实现
  • --bind 'ctrl-p:preview-up,ctrl-n:prev… 这是预览窗口的快捷键,Ctrl+p或n上/下滚动,Ctrl+b/f上/下翻页

下一步将以上代码粘贴到一个文件里,我假设您的文件名叫作wiki

1
2
3
4
5
#使文件可执行
chmod + x wiki

#直接使用,用于仅搜索标题
./wiki

1

1
2
#如果你想搜索文章的内容,如一个关键词“XBOOTLDR”,可以这样做
./wiki XBOOTLDR

2

如图所示,搜索的范围会再次缩小

另外,如果您使用arch-wiki-docs-zh-cn只需要将脚本中的/usr/share/doc/arch-wiki/html/en替换为/usr/share/doc/arch-wiki-zh-cn/html即可

题外话

本来不想同时使用两个博客(博客园与rethlibc.github.io),但是因为github.io在国内访问困难,想了想于是干脆同步更新了~


使用自制archwiki查看器代替arch-wiki-lite
http://example.com/2025/07/13/archlinux-wiki-search-for-fzf/
作者
RethLibc
发布于
2025年7月13日
许可协议