必须从官方镜像安装TeX Live 2026完整版并正确配置环境变量与字体，否则xelatex无法调用系统字体、pandoc导出PDF失败、中文断行异常；Pandoc需补全文泉驿字体及模板配置；Sphinx须设zh_CN语言并启用中文搜索；Typora需用Snap或信创专用包并加--no-sandbox参数。
您在麒麟OS上需要安装LaTeX、Sphinx、Markdown+PDF生成链路等专业排版工具，但系统默认未预装且软件源中版本陈旧或缺失关键组件，必须按实际用途选择对应安装路径——错选方式会导致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→这步跳过会导致所有中文文档导出为空白。
配置Sphinx构建技术文档网站
Sphinx依赖Python环境，麒麟OS桌面版预装Python 3.9+，但缺少pip和sphinx-build命令，需先补全工具链。
第一步：升级pip并安装sphinxpython3 -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参数，否则在龙芯平台闪退】。
