Windows环境下重装Jemdoc+MathJax遇到的技术问题求助

核心问题定位 #

所有问题本质都是未正确调用Jemdoc+MathJax核心脚本，或是配置文件未关联到位。

分步解决方案 #

1. 修正footer显示与MathJax渲染失效问题 #

• 确认运行的是Jemdoc+MathJax包内的jemdoc.py，而非原始jemdoc脚本——原始版本不识别MathJax配置，也不会显示对应footer。
• 检查mysite.conf配置：确保包含mathjax: yes字段，若未自定义footer，Jemdoc+MathJax默认会生成带MathJax标识的页脚。
• 运行时显式指定配置文件：

  python jemdoc.py -c mysite.conf yourpage.jemdoc
  

2. 解决复杂公式构建失败（缺少\usepackage）问题 #

• 打开Jemdoc+MathJax的jemdoc.py，找到处理LaTeX公式的代码段（通常对应$$或\[标记的处理逻辑）。
• 确认脚本是否自动添加了amsmath、amssymb等必要宏包，若没有，手动在生成临时TeX文件的代码区插入：

  \usepackage{amsmath}
  \usepackage{amssymb}
  

• 排查jemdoc文档中的语法错误，比如未闭合的公式标记，这类问题也会导致构建中断。

3. 彻底排查环境问题 #

• 运行python --version确认当前使用的是Python 2.7版本。
• 将Jemdoc+MathJax的完整目录加入Python路径，或直接在项目目录下运行脚本，避免调用到其他位置的原始jemdoc脚本。
• 对比之前正常生成的页面源码，检查<head>中是否加载了MathJax脚本，若未出现，说明配置未生效，需重新核对mysite.conf。

内容的提问来源于stack exchange，提问作者Aidan W. Murphy