自制 ShareLaTeX 映像

Overleaf 官方的 sharelatex 映像的 TeX Live 版本可能较旧，无法安装最新的宏包，并且往往只包含了少量的基础宏包。为了方便使用，我们可以自己构建一个使用最新 TeX Live 的映像，并一次安装全部宏包。下面是自制映像的过程。

⚠️: 自制映像需要 40 分钟左右

构建映像

自建映像有两种方法：

  1. 修改官方的构建配置文件并从头构建映像（推荐）
  2. 在官方已经构建好的映像的基础上重新构建自己的映像

如果你和我一样，使用 ARM 架构的芯片，那么你最好修改官方配置并从头构建映像。因为官方预构建的 ShareLaTeX 映像只有 amd64 版本，我们无法利用它构建 arm64 版本的映像。

使用官方配置构建映像

Overleaf 官方提供了一个仓库 overleaf，该仓库包含了构建 ShareLaTeX 映像的全部配置文件。不过，其默认配置只会安装基础宏包套件 scheme-basic。我们需要修改配置文件以安装全部宏包套件 scheme-full。

  1. 克隆 overleaf 仓库：

    # 克隆仓库
git clone https://github.com/overleaf/overleaf.git
# 进入 overleaf/server-ce 目录
cd overleaf/server-ce

  2. 修改安装套件为 scheme-full：

    # 修改配置文件以使用 scheme-full 套件
sed -i 's/scheme-basic/scheme-full/g' Dockerfile-base
# TeX Live 换源（可选）
sed -i 's@TEXLIVE_MIRROR=.*@TEXLIVE_MIRROR=https://mirrors.ustc.edu.cn/CTAN/systems/texlive/tlnet@g' Dockerfile-base

  3. 安装字体（可选）：

    在 server-ce 目录下新建一个目录 fonts，并将你需要用到的字体拷贝进来，然后在 Dockerfile 合适的位置添加如下命令：

    ADD server-ce/fonts/ /usr/local/share/fonts/

  4. 安装依赖：

    在 Dockerfile 合适的位置添加如下命令：

    RUN ln -s /usr/local/texlive/2024/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf && \
    fc-cache -fv && \
    apt-get update && \
    apt-get install -y inkscape python3-pygments && \
    echo "shell_escape = t" >> /usr/local/texlive/2024/texmf.cnf
    • 记得将路径中的 2024 改为你当前最新版使用的年份
    • 你也可以在 APT 安装命令中添加 Windows 字体包 ttf-mscorefonts-installer
    • 提示：在使用 APT 安装软件包时可以换源加快安装速度

  5. 构建映像

    make

    构建之后你会获得一个自己版本的 sharelatex/sharelatex:latest 映像。为了方便后面使用我们最好重新给它设置一个名字：

    docker tag sharelatex/sharelatex:latest xxx/sharelatex:5.0.3
    • 将 xxx 替换为你喜欢的名字。版本号可以随意设置，不过要和之后运行 Overleaf 时 toolkit/config/version 中的版本号一致。

在官方映像的基础上构建

新建一个 Dockerfile：

FROM sharelatex/sharelatex:5.0.3

# 拷贝字体文件。把你需要用到的字体放到 fonts 文件夹
ADD fonts/ /usr/local/share/fonts/

# 更新 TeX Live
RUN cd /tmp \
&& tlmgr path remove \
&& mv /usr/local/texlive/2023 /usr/local/texlive/2024 \
&& wget https://mirror.ctan.org/systems/texlive/tlnet/update-tlmgr-latest.sh \
&& export PATH="/usr/local/texlive/2024/bin/x86_64-linux:$PATH" \
&& sh update-tlmgr-latest.sh -- --upgrade \
&& tlmgr update --self --all \
&& tlmgr install scheme-full \
&& luaotfload-tool -fu \
&& tlmgr path add \
&& ln -s /usr/local/texlive/2024/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf \
&& fc-cache -fv

# 安装依赖
RUN apt-get update && \
    apt-get install -y inkscape python3-pygments && \
    echo "shell_escape = t" >> /usr/local/texlive/2024/texmf.cnf

EXPOSE 80

ENTRYPOINT ["/sbin/my_init"]
  • 记得将所有路径中的 2024 改为你当前最新版使用的年份
  • 提示：在使用 APT 安装软件包时可以换源加快安装速度

如果需要设置 TeX Live 镜像源，可以在上面配置中添加：

&& tlmgr option repository https://mirrors.ustc.edu.cn/CTAN/systems/texlive/tlnet \

即：

RUN cd /tmp \
...
&& tlmgr option repository https://mirrors.ustc.edu.cn/CTAN/systems/texlive/tlnet && \
# 添加到 tlmgr update 之上
&& tlmgr update --self --all \
...

接下来编译映像：

docker build . --tag xxx/sharelatex:5.0.3

将 xxx 替换为你喜欢的名字。版本号可以随意设置，不过要和之后运行 Overleaf 时 toolkit/config/version 中的版本号一致。

启动 ShareLaTeX

  1. 克隆 toolkit 仓库并初始化：

    git clone https://github.com/overleaf/toolkit.git overleaf-toolkit
cd overleaf-toolkit
bin/init  # 初始化

  2. 检查 ShareLaTeX 版本，打开 config/version，检查其中的版本号和你之前构建的镜像的版本号是否一致。

  3. 编辑配置文件 config/overleaf.rc，将 OVERLEAF_IMAGE_NAME 设置为你刚刚编译好的映像名：

    # Uncomment the OVERLEAF_IMAGE_NAME variable to use a user-defined image.
OVERLEAF_IMAGE_NAME=xxx/sharelatex

    然后重新运行 bin/up，之后再用 bin/start 启动。

参考：实践自部署 Overleaf

参见：本地部署 Overleaf 服务

posted @ 2024-04-24 18:57  Undefined443  阅读(162)  评论(0)  编辑  收藏  举报