☰

将 LaTex 转换为 HTML，保留方程式为 LaTeX（标签除外）

tag-icon • tag-icon numbering tex4ht html
将 LaTex 转换为 HTML，保留方程式为 LaTeX（标签除外）

将 LaTeX 转换为 HTML，保留公式为 LaTeX解释如何在 tex4ht 中使用 \VerbMath 将 LaTeX 转换为 HTML，同时保持方程式不变。作为参考，我将补充一点，对于多行，可以使用对齐环境，如所述这里。

但是这些解决方案不适用于标签。所以我想要一种方法来

\begin{equation}
1=1 \label{eq}
\end{equation}

Equation \ref{eq}

进入

\begin{equation}
1=1~~~(7)
\end{equation}

Equation (7)

其中 (7) 是方程的正确编号。可以使用 tex4ht 完成此操作吗，或者是否有其他脚本可以执行此操作？

注意：Mathjax 可以解析标签/引用，但我不想使用 Mathjax。

答案1

编辑：

因为您不想使用 MathJax，所以您需要对文本进行后处理以替换标签和交叉引用并插入公式编号。幸运的是，我们可以使用make4ht构建文件来实现这一点。

示例文件：

\documentclass{article}
% \usepackage[T1]{fontenc}
\usepackage{amsmath}

\newcommand\mjref[1]{\ref{#1}}
\begin{document}
\begin{equation}
1=1 \label{eq}
\end{equation}

\begin{align}
  1 + a = 2\\
  2 - a = 1
\end{align}

Equation \mjref{eq} 
\end{document}

有关的详细信息\mjref在原始答案中，这些详细信息仍然适用。我们将使用修改后的包来保持 LaTeX 数学不变，latex-unchanged.sty：

\RequirePackage{verbatim,etoolbox}
\AtBeginDocument{%
  \def\AltMathOne#1${\HCode{\detokenize{\(#1\)}}$}
  \Configure{$}{}{}{\expandafter\AltMathOne} 
  \def\AltlMath#1\){\HCode{\detokenize{\(#1\)}}\)}
  \Configure{()}{\AltlMath}{}
  \def\AltlDisplay#1\]{\HCode{\detokenize{\[#1\]}}\]}
  \Configure{[]}{\AltlDisplay}{}
% 
\newcommand\VerbMath[1]{%
\ifcsdef{#1}{%
  \renewenvironment{#1}{%
    \NoFonts%
    \Configure{verbatim}{}{}
    \HChar{92}begin\{#1\}%
    \verbatim}{\endverbatim\HChar{92}end\{#1\}\EndNoFonts}%
}{}%
}

\VerbMath{align}
\VerbMath{equation}
\VerbMath{equation*}
  }

稍微修改的.cfg文件：

\RequirePackage{latex-unchanged} 
\Preamble{xhtml,html5}
\begin{document}
\renewcommand\mjref[1]{\NoFonts\HChar{92}eqref\{#1\}\EndNoFonts}
\EndPreamble

现在有趣的是：

构建文件名为youfilename.mk4：

local filter = require "make4ht-filter"
local crossref = require "crossref"
local process = filter { crossref }

Make:match(".html$", process)

这声明了所有 html 文件都应该用crossref库来处理，库将完成所有艰苦的工作。将以下代码保存为crossref.lua：

-- counter values for particular counters will be saved here
local eqcounter = 0
-- pattern which will be inserted as equation number
local counter_pattern = "~~~(%i)"

-- list of environments to insert counters
local processed = {"equation", "align"}
local labels = {}


-- this function takes pattern for ending text (it is end environment or
-- \\ as line breaks in aligns) and insert counter numbers before the matched text
-- it also removes \labels and store them for future use
local function insert_counter(text, pattern, counter)
  local counter_pat = string.format(counter_pattern, counter)
  -- remove labels
  local removed_labels = text:gsub('%s*\\label{(.-)}', function(name)
    -- save counter under label name
    print("save label", name, counter)
    labels[name] = counter
    return ''
  end)
  local inserted = removed_labels:gsub(pattern, counter_pat .. '%0')
  print("inserted", inserted)
  return inserted
end

local function handle_counter(env, name)
  eqcounter = eqcounter + 1
  -- we need to support align environments, which will have multiple counters
  if env:match('\\\\') then
    local parts = {}
    local ending = env:gsub('(.-)\\\\', function(part)
      table.insert(parts, part)
      return ''
    end)
    local results = {}
    -- we first process lines ending with \\, the last line without this will be processd
    -- with usual code for end environment
    for _, part in ipairs(parts) do
      print("part", part)
      table.insert(results, insert_counter(part, '(%s*)$',eqcounter))
      eqcounter = eqcounter + 1
    end
    env  = table.concat(results, '\\\\') .. '\\\\' ..ending
  end
  -- now insert counter for the whole environment
  return insert_counter(env, '(%s*\\end{'.. name ..'}', eqcounter)
end

local function handle_refs(text)
  -- modify the pattern to match the referencing macro you use
  return text:gsub('\\eqref{(.-)}', function(label)
    local counter = labels[label]
    if not counter then return '??' end
    return string.format("(%i)", counter)
  end)
end

return function(s)
  -- process math environments defined in processed table
  for _, name in ipairs(processed) do
    -- match the whole environments and replace them with modified version
    s = s:gsub('(\\begin{' ..name .. '}.-\\end{'.. name ..'})', function(environment)
      return handle_counter(environment, name)
    end)
  end
  -- handle ref commands in text
  s = handle_refs(s)
  return s
end

详细信息请参阅源代码中的注释。

编译使用：

make4ht -uc myconfig4.cfg -e youfilename.mk4 sample.tex

结果如下：

<!--l. 7--><p class="noindent" >\begin{equation}
1=1~~~(1)
\end{equation}

</p><!--l. 11--><p class="noindent" >\begin{align}
1+a=2~~~(2)\\
2-a=1~~~(3)
\end{align}
</p><!--l. 16--><p class="noindent" >Equation (1)</p>

原始答案：

MathJax 本身支持标签和交叉引用，因此让它不仅处理\label，而且处理也许更为现实\ref。我将定义自定义宏来引用数学环境，可以\ref{labelname}在使用编译文档时重新定义以插入tex4ht。我不会重新定义\ref自身，因为您可能不想失去引用章节或图形的能力。

像这样：

\documentclass{article}
\usepackage{amsmath}

\newcommand\mjref[1]{\ref{#1}}
\begin{document}
\begin{equation}
1=1 \label{eq}
\end{equation}

Equation \mjref{eq} 
\end{document}

可以找到带有 LaTeX 宏的 MathJax 的当前版本代码helpers4ht 捆绑包。它不在 CTAN 上，你可以使用mathjax-latex4ht.sty包裹。

配置文件可以稍微简化一下：

\RequirePackage{mathjax-latex-4ht} 
\Preamble{xhtml}
\begin{document}
\renewcommand\mjref[1]{\NoFonts\HChar{92}eqref\{#1\}\EndNoFonts}
\EndPreamble

唯一有趣的是\mjref命令的重新定义，它暂时禁止插入字体的 HTML 标签，而是使用ASCII 代码\HChar{92}插入字符。\

生成的 HTML 代码如下：

<!--l. 7--><p class="noindent" >\begin{equation}
1=1\label{eq}
\end{equation}
</p><!--l. 11--><p class="noindent" >Equation \eqref{eq}</p>

MathJax 将其呈现如下：

在此处输入图片描述

相关内容