Sioyek

Sioyek 是一款专注于教科书和研究论文的 PDF 阅读器。

安装

官方安装包

Windows、macOS 和 Linux 系统均有安装程序。请查看发布页面。

Homebrew Cask

有一个 Homebrew Cask 可用，地址：https://formulae.brew.sh/cask/sioyek。通过运行以下命令安装：

brew install --cask sioyek

Linux 第三方软件包

如果你更喜欢使用包管理器安装 Sioyek，可以查看以下列表。请注意，这些是由第三方打包者提供的。使用风险自负！如果你要报告第三方包的 bug，请说明你使用的是哪个包。

发行版	链接	维护者
Flathub	sioyek	@nbenitez
Alpine	sioyek	@jirutka
Arch	AUR sioyek	@goggle
Arch	AUR sioyek-git	@hrdl-github
Arch	AUR sioyek-appimage	@DhruvaSambrani
Debian	sioyek	@viccie30
NixOS	sioyek	@podocarp
openSUSE	Publishing	@uncomfyhalomacro
openSUSE	Factory	@uncomfyhalomacro
Ubuntu	sioyek	@viccie30

文档

你可以在这里查看官方文档。

功能视频概览

如需更深入的教程，请观看此视频：

功能特性

快速打开

https://user-images.githubusercontent.com/6392321/125321111-9b29dc00-e351-11eb-873e-94ea30016a05.mp4

你可以快速搜索并打开任何你之前使用 Sioyek 交互过的文件。

智能跳转

https://user-images.githubusercontent.com/6392321/125321419-e5ab5880-e351-11eb-9688-95374a22774f.mp4

你可以跳转到任何引用的图表或参考文献项目，即使 PDF 文件没有提供链接。你还可以通过鼠标中键点击/Shift+鼠标中键点击参考文献项目的名称，在 Google Scholar/Libgen 中搜索它们。

概览

https://user-images.githubusercontent.com/6392321/154683015-0bae4f92-78e2-4141-8446-49dd7c2bd7c9.mp4

你可以通过右键点击图表/参考文献/表格等，快速打开它们的概览（与智能跳转一样，即使文档没有提供链接，该功能也能正常工作）。

标记

https://user-images.githubusercontent.com/6392321/125321811-505c9400-e352-11eb-85e0-ffc3ae5f8cb8.mp4

有时在阅读文档时，你需要回到前几页（可能是查看定义或其他内容），然后快速跳回原来的位置。你可以通过使用标记来实现这一点。标记是PDF文件中的命名位置（每个标记都有一个单字符名称，例如'a'或'm'），你可以通过名称快速跳转到这些位置。在上述例子中，在回到定义之前，你可以标记当前位置，之后通过调用标记名称跳回该位置。小写标记仅限于当前文档，而大写标记是全局的（如果你使用过vim，这应该非常熟悉）。

书签

https://user-images.githubusercontent.com/6392321/125322503-1a6bdf80-e353-11eb-8018-5e8fc43b8d05.mp4

书签类似于标记，但它们是用文本字符串命名的，而且都是全局的。

高亮

https://user-images.githubusercontent.com/6392321/130956728-7e0a87fa-4ada-4108-a8fc-9d9d04180f56.mp4

使用不同类型的高亮标记文本。你可以在所有高亮中进行搜索。

传送门（此功能对多显示器用户最有用）

https://user-images.githubusercontent.com/6392321/125322657-41c2ac80-e353-11eb-985e-8f3ce9808f67.mp4

假设你正在阅读一个段落，其中引用了一个距离当前位置不太近的图表。在当前段落和图表之间来回跳转可能会很烦人。使用传送门，你可以将段落位置链接到图表位置。Sioyek在一个单独的窗口中显示最近的传送门目标（通常放在第二个显示器上）。当用户浏览文档时，这个窗口会自动更新以显示最近的传送门目标。

配置

https://user-images.githubusercontent.com/6392321/125337160-e4832700-e363-11eb-8801-0bee58121c2d.mp4

你可以通过编辑keys_user.config和prefs_user.config来自定义所有快捷键绑定和一些UI元素。默认配置在keys.config和prefs.config中。

构建说明

Linux

Fedora

运行以下命令在Fedora上安装依赖项、克隆仓库并编译sioyek（在Fedora Workstation 36上测试通过）。

sudo dnf install qt5-qtbase-devel qt5-qtbase-static qt5-qt3d-devel harfbuzz-devel mesa-libGL-devel glfw-devel
git clone --recursive https://github.com/ahrm/sioyek
cd sioyek
./build_linux.sh

通用发行版

安装Qt 5并确保qmake在PATH中。

运行qmake --version确保路径中的qmake使用的是Qt 5.x版本。
安装libharfbuzz：

sudo apt install libharfbuzz-dev

克隆仓库并构建：

git clone --recursive https://github.com/ahrm/sioyek
cd sioyek
./build_linux.sh

Windows

安装Visual Studio（在2019版本上测试通过，其他较新版本也应该可以）
安装Qt 5并确保qmake在PATH中。
克隆仓库并使用64位Visual Studio开发者命令提示符构建：

git clone --recursive https://github.com/ahrm/sioyek
cd sioyek
build_windows.bat

Mac

安装Xcode。
克隆仓库并构建：（以下代码使用Zsh，这是macOS的默认shell。）

(
setopt PIPE_FAIL PRINT_EXIT_VALUE ERR_RETURN SOURCE_TRACE XTRACE

git clone --recursive https://github.com/ahrm/sioyek
cd sioyek
chmod +x build_mac.sh

brew install 'qt@5' freeglut mesa harfbuzz

export PATH="/opt/homebrew/opt/qt@5/bin:$PATH"
#: 上面这行是为了确保能找到qt中的=qmake=。
#: 使用=brew info 'qt@5'=查找路径。

MAKE_PARALLEL=8 ./build_mac.sh

mv build/sioyek.app /Applications/
sudo codesign --force --sign - --deep /Applications/sioyek.app
)