Zathura：Linux 下轻量高效的 PDF 阅读器全攻略

目录#

1. 什么是 Zathura？
2. 安装 Zathura
   • 主流 Linux 发行版安装
   • 从源码编译安装
   • 验证安装与后端选择
3. 基础操作：Vim 风格的核心体验
   • 启动与打开文件
   • 核心导航键位
   • 搜索与文本交互
4. 配置 Zathura：打造个性化体验
   • 配置文件路径与语法
   • 常用配置项示例
   • 自定义键位绑定
5. 插件生态：扩展 Zathura 能力
   • 核心插件介绍
   • 插件安装与管理
6. 高级功能：效率提升技巧
   • LaTeX 反向搜索（Inverse Search）
   • 标签页与多文档管理
   • 命令模式与批量操作
7. 最佳实践与场景案例
   • 与 LaTeX 工作流集成
   • 窗口管理器中的 Zathura
   • 无障碍与夜间模式配置
8. 常见问题与 troubleshooting
9. 参考资料

1. 什么是 Zathura？#

Zathura 是一款由 pwmt 开发的轻量级文档阅读器，最初仅支持 PDF，现已通过插件扩展到 DJVU、PostScript 等格式。其核心特点包括：

• Vim 风格操作：支持 h/j/k/l 导航、/ 搜索、:command 命令模式，无需鼠标即可高效操作。
• 模块化设计：核心与功能分离，通过后端插件（如 zathura-pdf-poppler）支持不同文档格式。
• 极简界面：默认隐藏工具栏，仅保留状态栏，专注内容展示。
• 高度可定制：通过配置文件调整键位、外观、行为，满足个性化需求。
• 低资源占用：启动速度快（毫秒级），内存占用远低于 Okular 等工具。

2. 安装 Zathura#

Zathura 的安装依赖于发行版的包管理器，同时需选择合适的后端插件（处理文档格式的核心）。

2.1 主流 Linux 发行版安装#

Debian/Ubuntu 及其衍生版#

# 安装 Zathura 核心 + PDF 后端（poppler，功能最全）
sudo apt install zathura zathura-pdf-poppler
 
# 可选：安装 DJVU/PostScript 支持
sudo apt install zathura-djvu zathura-ps

Fedora/RHEL/CentOS#

# 安装核心与 PDF 后端
sudo dnf install zathura zathura-pdf-poppler
 
# 可选：DJVU/PS 支持
sudo dnf install zathura-djvu zathura-ps

Arch Linux/Manjaro#

# Arch 官方仓库已包含全套组件
sudo pacman -S zathura zathura-pdf-poppler zathura-djvu zathura-ps

openSUSE#

sudo zypper install zathura zathura-pdf-poppler zathura-djvu zathura-ps

2.2 从源码编译安装#

若需最新版本（如体验标签页功能），可从源码编译：

# 安装依赖（以 Debian 为例）
sudo apt install git meson ninja-build libcairo2-dev libgirara-dev \
  libsynctex-dev libpoppler-glib-dev
 
# 克隆源码
git clone https://github.com/pwmt/zathura.git && cd zathura
 
# 编译安装
meson build --prefix=/usr
ninja -C build
sudo ninja -C build install
 
# 安装 PDF 后端（poppler）
git clone https://github.com/pwmt/zathura-pdf-poppler.git && cd zathura-pdf-poppler
meson build --prefix=/usr
ninja -C build
sudo ninja -C build install

2.3 验证安装与后端选择#

安装后，通过以下命令验证：

# 查看版本与已加载插件
zathura --version

输出示例（包含后端信息）：

zathura 0.5.2
(plugin) pdf-poppler (0.3.0)

后端选择建议：

• poppler（默认）：功能最全（支持文本复制、搜索、注释），推荐日常使用。
• mupdf：渲染速度更快，但功能较少（无注释），适合低配设备。
• djvu/ps：按需安装对应插件即可。

3. 基础操作：Vim 风格的核心体验#

Zathura 的灵魂在于键盘优先的操作逻辑，如果你熟悉 Vim，上手几乎零成本。

3.1 启动与打开文件#

# 直接启动（无文件）
zathura
 
# 打开指定文件
zathura document.pdf
 
# 从标准输入读取（如管道输出）
cat document.pdf | zathura -

3.2 核心导航键位#

3.3 搜索与文本交互#

• 搜索文本：

  • 按 / 进入搜索模式，输入关键词后按 Enter。
  • n 跳至下一个结果，N 跳至上一个结果。
  • Ctrl + / 清除搜索高亮。

• 复制文本：

  1. 按 v 进入可视化选择模式（类似 Vim）。
  2. 用 h/j/k/l 选择文本区域。
  3. 按 y 复制到剪贴板（需系统剪贴板支持，如 xclip）。

4. 配置 Zathura：打造个性化体验#

Zathura 的配置通过 zathurarc 文件实现，路径为 ~/.config/zathura/zathurarc（需手动创建）。配置语法为 key value，支持注释（# 开头）。

4.1 配置文件路径与语法#

# 创建配置文件
mkdir -p ~/.config/zathura && touch ~/.config/zathura/zathurarc

配置项分为全局设置（如缩放、字体）和模式设置（如 :set 命令），支持条件判断（如 map 定义键位）。

4.2 常用配置项示例#

以下是一个实用的 zathurarc 示例，含注释说明：

# ~/.config/zathura/zathurarc
 
# 外观设置
set statusbar-bg "#282828"       # 状态栏背景色（暗色主题）
set statusbar-fg "#ebdbb2"       # 状态栏前景色（文本颜色）
set statusbar-font "monospace 10" # 状态栏字体（名称 大小）
set inputbar-font "monospace 10"  # 输入框字体
 
# 行为设置
set default-zoom 120             # 默认缩放比例（120%）
set zoom-step 5                  # 缩放步长（5%）
set smooth-scrolling yes         # 启用平滑滚动
set confirm-exit no              # 关闭时不提示确认
 
# 显示设置
set show-statusbar yes           # 显示状态栏
set show-index no                # 默认不显示目录（按 `i` 切换）
set window-title "Zathura: %f"   # 窗口标题格式（%f 为文件名）
 
# 无障碍设置
set invert-colors no             # 反转颜色（夜间模式可设为 yes）
set highlight-color "#ffd700"    # 搜索高亮颜色（金色）

4.3 自定义键位绑定#

通过 map 命令自定义键位，语法：map <模式> <按键> <命令>。常用模式：

• normal：普通模式（默认）
• insert：输入模式（如搜索时）
• visual：可视化选择模式

示例：

# 自定义全屏切换键（默认 F11）
map normal <F> toggle_fullscreen
 
# 绑定 "Ctrl + s" 保存当前页面为图片
map normal <C-s> print -o %f_page_%p.png -p %p
 
# 绑定 "Alt + j/k" 快速翻页（一次 5 页）
map normal <A-j> goto +5
map normal <A-k> goto -5

5. 插件生态：扩展 Zathura 能力#

Zathura 本身仅提供基础框架，文档格式支持完全依赖插件。以下是常用插件及功能：

5.1 核心插件介绍#

5.2 插件安装与管理#

安装插件（以 PDF 后端切换为例）：#

# Ubuntu/Debian 安装 mupdf 后端（轻量 PDF 支持）
sudo apt install zathura-pdf-mupdf
 
# 切换后端（需先卸载 poppler 或修改优先级）
# 方法：编辑 /usr/share/applications/org.pwmt.zathura.desktop，修改 Exec 行为
Exec=zathura --backend=mupdf %f

查看已安装插件：#

zathura --list-plugins

6. 高级功能：效率提升技巧#

6.1 LaTeX 反向搜索（Inverse Search）#

Zathura 与 Vim/Neovim 结合，可实现 LaTeX 文档的正向/反向搜索（编辑 ↔ 预览联动），步骤如下：

1. 配置 Vim/Neovim：在 ~/.vimrc 中添加（需 vimtex 插件）：

   let g:vimtex_view_method = 'zathura'
   let g:vimtex_compiler_latexmk = {'continuous': 1}  # 实时编译

2. 配置 Zathura：在 zathurarc 中添加反向搜索键位：

   # 按 Ctrl + 点击文本，跳转到 Vim 对应行
   set synctex true
   map normal <C-click> synctex-editor-command

3. 使用流程：

   • 在 Vim 中用 \ll 编译 LaTeX。
   • Zathura 自动刷新预览。
   • 在 Zathura 中按住 Ctrl 点击文本，Vim 自动跳转到对应源码行。

6.2 标签页与多文档管理#

Zathura 0.5.0+ 支持标签页（需编译时启用 libgirara 标签功能）：

• 新建标签页：:open -t document2.pdf（命令模式输入）。
• 切换标签页：Alt + 1/2/3（切换到第 1/2/3 个标签）。
• 关闭标签页：:tab-close 或 Ctrl + w。

6.3 命令模式与批量操作#

按 : 进入命令模式，支持以下操作：

7. 最佳实践与场景案例#

7.1 与 LaTeX 工作流集成#

推荐组合：Vim + latexmk + Zathura，实现实时预览：

# 安装依赖
sudo apt install texlive-full latexmk neovim vimtex
 
# 配置 latexmk（~/.latexmkrc）
$pdf_previewer = 'zathura %O %S';
$continuous_mode = 1;  # 持续监控文件变化

使用时，在 Vim 中执行 \ll 启动编译，Zathura 自动更新预览。

7.2 窗口管理器中的 Zathura#

在 i3/sway 等平铺管理器中，可通过快捷键快速调整 Zathura 布局：

# i3 配置示例（~/.config/i3/config）
bindsym $mod+Shift+p exec --no-startup-id zathura  # 启动 Zathura
for_window [class="Zathura"] floating enable      # 设置为浮动窗口

7.3 无障碍与夜间模式配置#

夜间阅读时，通过以下配置减少眼部疲劳：

# 夜间模式（反转颜色 + 低亮度）
set invert-colors yes
set brightness 0.8    # 亮度（0.0-1.0）
set contrast 1.2      # 对比度（0.0-2.0）
 
# 高对比度文本
set highlight-color "#ff4500"  # 搜索高亮为橙色（更醒目）

8. 常见问题与 troubleshooting#

Q1：无法复制文本？#

A：需使用 zathura-pdf-poppler 后端，mupdf 不支持文本复制。检查后端：zathura --version，若显示 pdf-mupdf，则卸载并安装 zathura-pdf-poppler。

Q2：滚动卡顿？#

A：关闭平滑滚动：set smooth-scrolling no，或切换至 mupdf 后端提升性能。

Q3：反向搜索（Synctex）失效？#

A：确保：

1. LaTeX 编译时添加 -synctex=1 选项（latexmk 默认启用）。
2. Zathura 配置中 set synctex true。
3. Vim/Neovim 安装 vimtex 并正确配置 view_method。

9. 参考资料#

• Zathura 官方文档
• Zathura GitHub 仓库
• Arch Wiki: Zathura
• VimTeX + Zathura 配置指南
• Zathura 插件列表

通过本文的指南，你已掌握 Zathura 的核心使用与定制方法。无论是日常阅读、学术研究还是开发文档查阅，Zathura 都能以高效、简洁的方式提升你的工作流。尝试配置自己的 zathurarc，探索更多高级功能吧！