translateLocally 项目常见问题解决方案

translateLocally 项目常见问题解决方案

translateLocally Fast and secure translation on your local machine, powered by marian and Bergamot. 项目地址: https://gitcode.com/gh_mirrors/tr/translateLocally

1. 项目基础介绍和主要编程语言

translateLocally 是一个开源项目，旨在为用户提供快速且安全的本地机器翻译功能。该项目基于 marian 和 Bergamot 两个框架开发，并配备了图形用户界面（GUI）。用户可以在本地机器上进行快速翻译，而不需要将数据发送到外部服务器。主要使用的编程语言是 C++，同时使用了 Qt 框架进行 GUI 设计。

2. 新手在使用这个项目时需要特别注意的3个问题及解决步骤

问题一：编译依赖问题

问题描述： 新手在尝试编译项目时可能会遇到依赖库缺失的问题。

解决步骤：

1. 确保系统已安装必要的编译工具，如 CMake 和编译器（如 g++）。
2. 根据操作系统安装相应的依赖库。例如在 Ubuntu 20.04 上，需要运行以下命令安装依赖库：

   sudo apt-get install -y libpcre++-dev qttools5-dev qtbase5-dev libqt5svg5-dev libarchive-dev libpcre2-dev
   

3. 如果使用的是 Ubuntu 22.04，则安装依赖库的命令稍有不同：

   sudo apt-get install -y libxkbcommon-x11-dev libpcre++-dev libvulkan-dev libgl1-mesa-dev qt6-base-dev qt6-base-dev-tools qt6-tools-dev qt6-tools-dev-tools qt6-l10n-tools qt6-translations-l10n libqt6svg6-dev libarchive-dev libpcre2-dev
   

4. 确保安装了 Intel MKL 库，可以通过以下命令安装：

   wget -qO- "https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS-2019.PUB" | sudo apt-key add -
   sudo sh -c "echo deb https://apt.repos.intel.com/mkl all main > /etc/apt/sources.list.d/intel-mkl.list"
   sudo apt-get update -o Dir::Etc::sourcelist="/etc/apt/sources.list.d/intel-mkl.list"
   sudo apt-get install -y --no-install-recommends intel-mkl-64bit-2020.0.088
   

问题二：编译错误

问题描述： 在编译过程中可能会出现错误。

解决步骤：

1. 仔细阅读编译错误信息，确定错误类型和位置。
2. 根据错误信息，查看是否缺少某些编译依赖或配置。
3. 查看项目的 issue 页面或者社区论坛，看是否有其他开发者遇到过类似问题。
4. 如果错误信息提示不明确，可以尝试在项目页面上创建一个新的 issue，详细描述遇到的问题。

问题三：运行错误

问题描述： 编译成功后运行程序时出现错误。

解决步骤：

1. 确保所有依赖库都已正确安装。
2. 检查运行程序时是否有权限问题，确保当前用户有足够的权限运行程序。
3. 查看运行错误信息，分析错误原因。
4. 如果错误信息难以理解，可以在项目页面上创建 issue，附上错误信息和日志文件，寻求社区帮助。

通过以上步骤，新手在使用 translateLocally 项目时应能解决一些常见问题，并顺利开始使用这个项目。

translateLocally Fast and secure translation on your local machine, powered by marian and Bergamot. 项目地址: https://gitcode.com/gh_mirrors/tr/translateLocally