如何在Doxygen页面实时渲染含tikzpicture的LuaTeX内容？

针对你想用LuaTeX笔记里的TikZ代码直接在Doxygen中实时渲染的需求，这里有几个实用方案：

方案1：针对HTML输出，用MathJax 3渲染TikZ #

这是最省心的实时渲染方式，无需手动转图，依赖MathJax的TikZ扩展：

• 修改Doxygen配置文件Doxyfile：
  • 开启MathJax：USE_MATHJAX = YES
  • 指定MathJax版本为3：MATHJAX_VERSION = 3
  • 添加TikZ扩展：MATHJAX_EXTENSIONS = https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex/tikz-full.js
  • 设置MathJax核心文件：MATHJAX_CODEFILE = https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
• 在Doxygen注释中，用@latexonly包裹你的TikZ代码：

  @latexonly
  \begin{tikzpicture}
    % 你的TikZ绘图代码
    \draw[blue, thick] (0,0) -- (2,1) -- (1,3) -- cycle;
  \end{tikzpicture}
  @endlatexonly
  

生成的HTML页面会自动通过MathJax加载并渲染TikZ图形，完全不需要手动导出图片。

方案2：针对PDF输出，用LuaTeX编译TikZ #

如果你的主要输出是PDF文档，直接利用Doxygen的LaTeX编译能力：

• 修改Doxyfile配置：
  • 开启LaTeX支持：USE_LATEX = YES
  • 指定编译器为LuaTeX：LATEX_CMD_NAME = lualatex
• 确保你的LaTeX环境已安装tikz包（你用LuaTeX的话应该已经具备）
• 同样用@latexonly包裹TikZ代码，Doxygen生成PDF时会调用LuaTeX直接编译渲染图形。

方案3：批量转换TikZ为SVG（适合已有大量.tex笔记） #

如果不想依赖在线MathJax扩展，可以用工具批量把TikZ代码转成SVG矢量图，再嵌入Doxygen：

• 安装tikz2svg工具（可通过TeX Live仓库或包管理器安装）
• 写简单脚本遍历你的.tex文件，提取所有\begin{tikzpicture}...\end{tikzpicture}代码块，用tikz2svg命令转成SVG文件
• 在Doxygen注释中用@image html 你的图形文件名.svg引用生成的SVG，这样HTML和PDF输出都能清晰显示矢量图。

内容的提问来源于stack exchange，提问作者Quasar