在麒麟OS上搭建专业的排版工作环境,其实是一项系统工程——您需要把LaTeX、Sphinx、Pandoc、Typora这些工具串联起来,同时确保中文支持稳定可靠。系统默认并不会预装这些组件,而且软件源里的版本往往比较陈旧或缺失关键模块。如果选错了安装方式,后续会遇到一系列麻烦:xelatex无法调用系统字体、Pandoc导出PDF失败、中文段落断行异常……总之,事先理清安装方法能节省大量时间。

安装TeX Live完整发行版(学术论文/书籍排版)
这一步至关重要。必须从官方镜像下载完整安装包,因为系统自带的texlive-*分包极不完整,缺少ctex宏包、xeCJK、fontspec等中文支持的核心组件。如果直接使用apt install,后面基本都会卡在编译阶段。
首先,在终端里创建安装目录并进入:
sudo mkdir -p /usr/local/texlive/2026 && cd /tmp
接着下载2026年最新完整版的安装脚本,可以走国内镜像加速:
wget https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/texlive2026.iso
然后挂载ISO并运行安装器:
sudo mount -o loop texlive2026.iso /mnt && sudo /mnt/install-tl
在启动的交互式安装界面中,务必取消勾选“create symlinks in system directories”。这一步不能跳过,否则它会覆盖系统原有的/usr/bin下的latex命令,导致LibreOffice的公式编辑器崩溃。
安装完成后,执行环境变量配置:
echo 'export PATH="/usr/local/texlive/2026/bin/x86_64-linux:$PATH"' >> ~/.bashrc && source ~/.bashrc
最后验证中文支持是否正常:新建一个test.tex文件,写入\documentclass{ctexart}\begin{document}你好世界\end{document},然后执行xelatex test.tex。生成的PDF中汉字能正常显示,就说明配置成功了。
部署Pandoc + LaTeX混合排版链路
仅仅安装Pandoc不足以直接导出PDF,它必须搭配XeLaTeX引擎和中文字体配置,否则中文会全部显示为方框。
方法一:通过APT安装基础组件,适合快速验证环境。
执行sudo apt update && sudo apt install pandoc texlive-xetex texlive-fonts-recommended -y——这套组合可以处理英文PDF,但中文支持还不够充分。
方法二:手动补全中文渲染能力,生产环境必须采用此方法。
首先安装文泉驿正黑字体:sudo apt install fonts-wqy-zenhei -y。
然后创建全局配置文件:echo 'mainfont: "WenQuanYi Zen Hei"' > ~/.pandoc/templates/default.latex。
如果跳过这一步,所有中文文档导出的PDF都会是空白内容。
配置Sphinx构建技术文档网站
Sphinx依赖于Python环境。麒麟OS桌面版预装了Python 3.9以上版本,但缺少pip和sphinx-build命令,需要先补全工具链。
第一步,升级pip并安装sphinx:
python3 -m pip install --upgrade pip && python3 -m pip install sphinx sphinx-rtd-theme
第二步,初始化项目结构:
sphinx-quickstart mydocs。按提示回答问题,两个关键选项:
Separate source and build directories? 输入y;
Project language []: 输入zh_CN。
第三步,启用中文支持:
编辑mydocs/conf.py,在末尾添加两行:
language = 'zh_CN'
html_search_language = 'zh'
如果不添加这两行,搜索框将无法识别中文关键词。
第四步,构建HTML站点:
cd mydocs && make html
生成的页面位于_build/html目录下,直接用浏览器打开index.html即可查看。
安装Typora离线Markdown编辑器(轻量写作)
Typora官方已经停止更新Linux版本,麒麟OS的适配版需要从第三方可信源获取。请勿使用官网的旧deb包,否则启动时会出现libnode.so缺失的错误。
方法1:通过Snap安装维护版
sudo snap install typora --classic
该版本会自动绑定系统字体,中文输入法兼容性也不错。不过首次启动时,需要手动授权访问用户主目录。
方法2:手动安装ARM64或AMD64专用包(信创环境)
下载地址:https://gitee.com/kylin-os/typora-releases/raw/main/typora_1.7.3_kylin_arm64.deb
双击安装后,在终端执行typora --no-sandbox启动。务必加上--no-sandbox参数,否则在龙芯平台会闪退。
