LaTeX2AI 是一款适用于 Adobe Illustrator（macOS 和 Windows 系统）的插件，它能让您在 Illustrator 文档中使用通过 LaTeX 排版的可编辑文本标签。

概述

• 许可协议与引用方式
• 安装
  • 系统要求
  • Windows 系统
  • macOS 系统
• LaTeX2AI 使用方法
  • 创建/编辑 LaTeX2AI 标签
    • 放置方式
      • 基线对齐放置
  • 项目缩放行为
  • LaTeX 头部
  • 标签存储策略
• 已知问题
  • Creative Cloud 文档
• 使用 LaTeX2AI 的成果
• 贡献代码
• 从源代码构建 LaTeX2AI
• 更新日志

许可协议与引用方式

LaTeX2AI 基于 MIT 许可协议发布，详见 ./LICENSE。 如果您使用 LaTeX2AI 为您的成果创建图表，请通过链接形式注明本 GitHub 仓库。 例如：

• 本研究中的示意图使用 Adobe Illustrator 插件 LaTeX2AI（https://github.com/isteinbrecher/latex2ai）制作。

欢迎您在 GitHub 上为我们点亮 ⭐。 您也可以将您的成果添加到使用 LaTeX2AI 的成果中。

安装

系统要求

运行 LaTeX2AI 需要以下软件依赖：

• LaTeX 编译器，如 TeX Live 或 MiKTeX
• Ghostscript

Windows 系统

1. 从 GitHub 发布页面 下载适用于您 Illustrator 版本的 LaTeX2AI。

2. 解压 .zip 文件。

3. 复制用户界面文件夹 com.isteinbrecher.latex2ai：

   • 当前用户安装：
     • 将 com.isteinbrecher.latex2ai 复制到 C:\Users\<USERNAME>\AppData\Roaming\Adobe\CEP\extensions（您可能需要创建此目录）。
   • 所有用户安装（需要管理员权限）：
     • 将 com.isteinbrecher.latex2ai 复制到 C:\Program Files\Common Files\Adobe\CEP\extensions\

4. 复制插件：

   • 当前用户安装：
     • 将 LaTeX2AI.aip 复制到任意目录。通过 编辑 > 首选项 > 插件与暂存盘... > 其他插件文件夹 将此目录设置为 Adobe Illustrator 插件目录。
   • 所有用户安装（需要管理员权限）：
     • 将 LaTeX2AI.aip 复制到 C:\Program Files\Adobe\Adobe Illustrator <YOUR VERSION>\Plug-ins\

5. 重启 Adobe Illustrator。通过 窗口 > 工具栏 > 高级 显示 LaTeX2AI 工具。

要卸载 LaTeX2AI，请删除您复制的文件。

macOS

1. 从 GitHub 发布页面 下载适用于您 Illustrator 版本的 LaTeX2AI。

2. 解压文件。

3. 复制用户界面文件夹 com.isteinbrecher.latex2ai：

   • 当前用户 安装：
     • 将 com.isteinbrecher.latex2ai 复制到 ~/Library/Application Support/Adobe/CEP/extensions/
   • 所有用户 安装（需要管理员权限）：
     • 将 com.isteinbrecher.latex2ai 复制到 /Library/Application Support/Adobe/CEP/extensions/

4. 复制插件：

   • 当前用户 安装：
     • 将 LaTeX2AI.aip 复制到任意目录。通过 编辑 > 首选项 > 插件与暂存盘... > 其他插件文件夹 将此目录设置为 Adobe Illustrator 插件目录。
   • 所有用户 安装（需要管理员权限）：
     • 将 LaTeX2AI.aip 复制到 /Applications/Adobe Illustrator <YOUR VERSION>/Plug-ins/

5. 重启 Adobe Illustrator。通过 窗口 > 工具栏 > 高级 显示 LaTeX2AI 工具。

根据您的系统设置，启动 Illustrator 时可能会收到以下错误消息：

您可以通过明确允许“门控”运行 LaTeX2AI 来解决此问题（另请参阅此主题）。为此，请打开终端并输入：

xattr -d com.apple.quarantine <LaTeX2AI.aip 的路径>

如果您为所有用户安装了 LaTeX2AI，则需要使用管理员权限运行此命令：

sudo xattr -d com.apple.quarantine <LaTeX2AI.aip 的路径>

要卸载 LaTeX2AI，请删除您复制的文件。

如何使用 LaTeX2AI

LaTeX2AI 会在主工具栏中添加四个按钮：

• 创建/编辑：单击现有标签进行编辑，或在文档某处单击创建新标签。
• 重做 LaTeX2AI 标签：重新编译或重置所有现有 LaTeX2AI 标签的比例。
• LaTeX2AI 选项：打开一个表单以设置全局 LaTeX2AI 选项，并在外部应用程序中编辑 LaTeX 头文件。
• 另存为 PDF：将当前 .ai 文档保存为同名的 .pdf 文件，其中包含 LaTeX2AI 标签。

您也可以双击 LaTeX2AI 标签进入编辑模式。

创建/编辑 LaTeX2AI 标签

创建或编辑标签时会显示此表单：

放置方式

此选项定义标签大小更改时的行为方式。

以矩形内放置的著名公式 $\sum_{k=0}^{\infty}\frac{x^k}{k!}$ 为例：

绿色框显示标签的大小，点标记放置锚点。当 LaTeX 代码更改并影响标签大小时，此锚点相对于矩形保持在相同位置。

如果将标签更改为 \displaystyle：

大小会发生变化，但锚点位置保持固定。

基线放置

一个额外的放置选项是 基线，它将标签的基线垂直居中。这使得与其他基线 LaTeX2AI 标签或 Illustrator 文本轻松对齐：

项目缩放行为

默认情况下，LaTeX2AI 插入的标签比例为 1:1：LaTeX 中的 1pt 等于 Illustrator 中的 1pt。 例如，12pt 字体的 LaTeX 标签与设置为 12pt 的 Illustrator 文本匹配。

标签可以像其他 Illustrator 对象一样调整大小，但修改 LaTeX 代码会将它们重置为 1:1 比例。

建议的做法是将项目保持在 1:1 比例。这样在导出并使用 \includegraphics[scale=1] 将图形包含到 LaTeX 文档中时，可确保字体大小一致。

使用 重做项目 工具重置所有 LaTeX2AI 项目的比例。

LaTeX 头文件

LaTeX2AI 假定同一文件夹中的所有 Illustrator 文件共享同一个 LaTeX 头文件：LaTeX2AI_header.tex。

如果该文件不存在，将在需要时创建。您可以编辑此文件以添加宏包或宏。

标签存储策略

每个 LaTeX2AI 标签都是一个链接到 Illustrator 文档的独立 .pdf 文件。 LaTeX2AI 允许您选择这些由 LaTeX 生成的 .pdf 标签文件的存储位置。 您可以在 LaTeX2AI 选项 面板中配置此设置。

• 临时目录（默认）：

  • 标签 .pdf 文件存储在全局临时文件夹中，由 LaTeX2AI 自动管理。
  • 这是大多数用户的推荐选项。

• 本地 links 目录（旧版选项）：

  • 这是 LaTeX2AI v1.1 之前的默认行为。
  • 标签 .pdf 文件存储在 Illustrator 文档旁边的 links/ 子文件夹中，由 LaTeX2AI 自动管理。
  • 如果您计划将 .ai 文档移动到未安装 LaTeX2AI 的其他系统，此选项非常有用：只需将 links/ 文件夹与文档一起复制，Illustrator 仍然能够找到并显示标签。

已知问题

Creative Cloud 文档

LaTeX2AI 当前不支持 Creative Cloud 文档。

使用 LaTeX2AI 创作的成果

以下是使用 LaTeX2AI 创作的部分成果列表（不完全统计）：

• Toenniessen, F.: Die Homotopie der Sphären - Eine Einführung in Spektralsequenzen, Lokalisierungen und Kohomologie-Operationen，Springer Verlag Heidelberg，2023。
• Steinbrecher, I., Popp, A., Meier, C.: Consistent coupling of positions and rotations for embedding 1D Cosserat beams into 3D solid volumes. 《计算力学》（2021），开放获取
• Steinbrecher, I., Mayr, M., Grill, M.J., Kremheller, J., Meier, C., Popp, A.: A mortar-type finite element approach for embedding 1D beams into 3D solid volumes，《计算力学》（2020），66(6):1377-1398，开放获取
• Steinbrecher, I., Humer, A., Vu-Quoc, L.: On the numerical modeling of sliding beams: A comparison of different approaches，《声与振动杂志》，408:270-290，开放获取

贡献代码

我们欢迎对 LaTeX2AI 做出贡献。

如需咨询一般问题、提出功能需求或报告漏洞，请创建一个 issue。

代码贡献步骤：

1. Fork 本仓库并在功能分支中进行开发。
2. 如果您的修改内容较多，建议先创建一个 issue 进行讨论。
3. 完成后，创建拉取请求到 develop 分支。

为保证代码质量，LaTeX2AI 使用多种 pre-commit 钩子来检查提交的代码。请在提交修改前确保已设置好 pre-commit 钩子。

pre-commit install

同时也请：

• 编译调试版本并在 Illustrator 中运行框架测试 。
• 考虑在 ./src/tests 中添加测试。
• 将您的更改说明添加到 更新日志。
• 欢迎将您的名字添加到 ./贡献者 文件中。

从源代码构建 LaTeX2AI

相关说明请参见 此处。

更新日志

详细 更新日志 请参见此处。