前言
在近期的项目中，需要在Confluence平台内搭建Latex工具，来实现数学公式的编写和渲染等功能。不同于其他基于java的封闭plugin包，Confluence的Latex-plugin是需要依赖server端本地的latex和dvipng工具才能进行页面内的渲染的。如果是通常情况下，这个问题很好解决，但是实验室的Confluence是通过docker images直接起的，并且这个image的基底kernel是alpine这个可以称得上是裸kernel的发行版。所以通常的安装没办法进行了，于是只能动手编译撸一遍。
过程
一、说明
因为confluence容器所依托的linux基底是alpine，一个非常轻量几乎没有任何依赖和包的linux裸核心，所以在alpine上配置latex和dvipng会比较麻烦一点。
二、组件和依赖安装
2.1 用root用户进入confluence容器的bash界面
docker exec -it -u root confluence bash
2.2 安装编译器
apk add gcc
apk add g++
2.3 安装latex(texlive)全部组件
apk add texlive-20170524-r6
apk add texlive-xetex-20170524-r6
apk add texmf-dist-latexextra-2018.48566-r0
apk add texlive-dvi-20170524-r6
apk add texlive-full-20170524-r6
apk add texlive-dev-20170524-r6
2.4 编译安装dvipng
- 前往官网下载dvipng的包：https://www.ctan.org/pkg/dvipng
- 根据编译包内README的说明根据如下步骤进行编译安装：
./configure autoconf --enable-selfauto-set
make (如果有报错，make test或者根据报错提示修复)
make install
2.5 验证安装
- 在临时文件夹中创建一个文件：
touch simple.tex
- 在文件中添加如下内容：
\documentclass[12pt]{article}
\usepackage{a4}
\begin{document}
\( E=mc^{2} \)
\end{document}
- 然后运行如下内容，如果成功生成了png文件，则表示组件安装运行正常：
latex simple.tex
dvipng simple.dvi
2.6 在$CONFLUENCE_HOME_DIR下面创建一个latex文件夹，并且创建三个配置文件：
- latex.properties:
# Specify a comma separated list of parameters to pass to the dvipng process.
dvipng.parameters=-T;tight;-bg;transparent
- latexfooter.tex:
\end{document}
- latexheader.tex:
\documentclass{article}
\usepackage{amsmath}
\usepackage{amsthm}
\usepackage{amssymb}
\usepackage{bm}
\newcommand{\mx}[1]{\mathbf{\bm{#1}}} % Matrix command
\newcommand{\vc}[1]{\mathbf{\bm{#1}}} % Vector command
\newcommand{\T}{\text{T}} % Transpose
\pagestyle{empty}
\begin{document}
2.7 配置confluence latex plugin
- 在Confluence的Manage app页面中，展开Latex plugin，点击Configure
- 在Configure中配置latex和dvipng的路径，正常情况为如下：
/usr/bin/latex
/usr/bin/dvipng - 然后点击
Save保存 - 如果没有提示报错，正常情况下Confluence容器的latex插件配置已经完成。可以创建任意页面进行测试latex渲染是否正常运作。
