Linglun-Converter/docs/download&start/Linux.md

一、【控制台】使用 Docker

请使用根目录下的 Dockerfile 来构建镜像，并运行镜像。

二、【图形化用户界面】暂无内容

未完待续

---

三、【控制台】手动安装（不建议）

运行环境安装

检验Python运行环境

0. 一般的Linux发行版都有安装Python环境，我们只需要保证其版本即可，理论上 ≥Python3.6 都可以运行我们的库

   我们可以使用

   python -V
   

   来查看 Python 版本，如下

   

1. 非必要环节：回退版本

   如果你跟作者一样，觉得 Python 3.10+ 太难用很烦人的话，那真是皆大欢喜，让我们一起来回退版本吧！

   • pacman 包管理器（多用于Arch Linux上）

     1. 让我们先来把 python3 加入忽略升级的列表中，使用vim修改/etc/pacman.conf，在IgnorePkg后加上python3

        sudo vim /etc/pacman.conf
        

        

     2. 然后我们开始从Arch Achieve上找Python的版本列表。（这里说明一下，在Arch中，Python默认指的是Python3，而与其他某些Linux发行版中Python默认指代Python2不同，所以在Arch Achieve中也是如此。）我这里找到的是Python3.8.6，于是我们用pacman把她下载下来并安装：

        sudo pacman -U https://archive.archlinux.org/packages/p/python/python-3.8.6-1-x86_64.pkg.tar.zst
        

        

     3. 完美！

   • 其他包管理器

     暂无

检查并安装pip包管理器依赖

1. 我们在安装依赖库之前，应该确认一下，Python自带的包管理器pip是否安装到位：

   python -m pip				# 确认pip是否安装
   # 当这个命令输入后有长段提示出现则为已经安装
   
   # 如果返回如下，那么则pip尚未安装
   /usr/bin/python: No module named pip
   # 可以使用如下命令来安装pip
   sudo pacman -S python-pip
   # 安装完成后记得验证
   python -m pip
   
   
   # 如果还是失败，那么就需要用其他工具安装pip：
   wget https://bootstrap.pypa.io/get-pip.py
   sudo python get-pip.py
   # 安装完成后一定要验证！！！
   python -m pip
   

本代码库的下载与使用

1. 使用Git下载本库及其示例代码

   git clone https://gitee.com/TriM-Organization/Linglun-Converter.git llc
   

   当上述命令执行成功，你会在执行此命令的所在位置发现一个名为 llc 的文件夹，其中包含的正是我们心心念念下载的本程序和示例代码。 而我们要运行的也正是示例代码，因此，赶快进入下载到的文件夹：

   cd llc
   

2. 新建虚拟环境

   在目录下打开终端，或者继续沿用我们刚才已经cd过llc的终端，执行以下命令以新建虚拟环境：

   python -m venv ./.venv
   

3. 运行示例程序

   执行以下命令以运行演示程序：

   source ./run_cli.sh
   

   该脚本会自动激活虚拟环境，你也可以通过手动执行source ./.venv/bin/activate来激活之。