Xournal++ 开源项目常见问题及解决方案

Xournal++ 开源项目常见问题及解决方案

xournalpp Xournal++ is a handwriting notetaking software with PDF annotation support. Written in C++ with GTK3, supporting Linux (e.g. Ubuntu, Debian, Arch, SUSE), macOS and Windows 10. Supports pen input from devices such as Wacom Tablets. 项目地址: https://gitcode.com/gh_mirrors/xo/xournalpp

Xournal++ 是一款高效的手写笔记与PDF注释软件，它采用C++编写，并基于GTK3框架。此项目旨在提供灵活性、功能性和速度，完美支持压力感应式的触控笔以及如Wacom、Huion、XP Pen等品牌的数字绘图板。Xournal++不仅允许用户在自定义纸张背景上进行书写和涂鸦，还能便捷地在PDF文档上添加标注，包括文本选取、高亮、下划线以及删除线等功能。

对新手的重要注意事项及解决步骤

1. 环境配置问题

问题描述： 新手在Linux（以Ubuntu为例）、macOS或Windows 10系统上安装Xournal++时可能会遇到依赖性问题。

解决步骤：

• 在Ubuntu上，确保已经安装了libgtk-3-dev、libpoppler-dev等必要的开发库。可以通过运行sudo apt-get install libgtk-3-dev libpoppler-dev ...来安装缺失的包。
• 在macOS，使用Homebrew，首先安装Homebrew，然后通过brew install gtk+3 poppler ...获取必要的依赖。
• Windows用户应使用提供的预编译二进制文件或者通过Chocolatey等包管理器简化安装过程。

2. 编译与构建问题

问题描述： 自行编译项目时，新手可能因不熟悉CMake而遭遇困难。

解决步骤：

• 确保已安装最新版本的CMake。在终端输入cmake --version检查版本。
• 进入项目根目录，执行mkdir build && cd build创建并进入构建目录。
• 执行cmake ..生成构建文件，随后使用make -j4（其中4是并发构建任务数）进行编译。若遇到错误，仔细阅读错误信息寻找缺少的依赖或配置错误。

3. 使用PDF注释功能时的兼容性问题

问题描述： 用户可能发现某些PDF文件在Xournal++中注释后，无法在其他PDF阅读器中正确显示注释。

解决步骤：

• 确认使用的PDF版本是否广泛支持。一般来说，尽量使用PDF 1.7或更低版本作为基础，避免使用PDF 2.0及以上特性。
• 在Xournal++保存注释后的PDF前，尝试导出为一个新的PDF文件，有时这可以改善兼容性。
• 若问题持续，考虑在论坛或Issues页面提交该问题，附上具体的PDF样本以便开发者调查。

以上步骤帮助新用户更好地入门Xournal++项目，解决常见的配置、编译和功能使用中的难题，享受这款强大工具带来的便利。

xournalpp Xournal++ is a handwriting notetaking software with PDF annotation support. Written in C++ with GTK3, supporting Linux (e.g. Ubuntu, Debian, Arch, SUSE), macOS and Windows 10. Supports pen input from devices such as Wacom Tablets. 项目地址: https://gitcode.com/gh_mirrors/xo/xournalpp