将 Latex \label 转换为 HTML ID 属性

Question 1

您可以尝试以下配置文件config.cfg：

\Preamble{xhtml}
\catcode`\:=11
% redefine \label to output link with the current label as id
% \o:label: calls the original label
\def\:tempa#1{\Link{}{#1}\EndLink\o:label:{#1}}
\HLet\label\:tempa
% configure \ref
% \Link{\RefArg}{} starts link. \RefArg contains the label
% we use \:gobble to remove the id generated by TeX4ht, it would 
% end in the hyperlinked text otherwise
\Configure{ref}{\Link{\RefArg}{}\:gobble}{\EndLink}{}
\catcode`\:=12
\begin{document}
\EndPreamble

您可以使用以下命令来使用它：

htlatex filename.tex "config"

或者，最好htlatex使用

make4ht -c config.cfg filename.tex

您可以阅读有关两者的区别这里

在配置文件中，我们重新定义\label插入额外的<a id="[label]"></a>标签。它使用\label参数来构造你可以链接到的id。要使用此idfrom\ref命令，我们需要提供一个\Configure{ref}命令。详细描述在配置文件中的注释中。

现在有一个问题。由于\label使用 after \section，目标链接插入在 section 之后，这将导致用户在单击标签的超链接时将结束 section 下方的页面。查看生成的 HTML 代码：

 <h3 class='sectionHead' id='section-heading'><span class='titlemark'>1   </span> <a id='x1-10001'></a>Section heading</h3>
<!-- l. 4 --><p class='noindent'><a id='sec:intro'></a>
...
</p><!-- l. 14 --><p class='indent'>   This is a test to link to Section this text is for searching in HTML Karen heading
<a href='#sec:intro'>1</a>. </p>

这个问题在 TeX 级别很难解决，所以我建议另一种选择，即使用make4ht构建文件。

make4ht支持 Lua 构建文件。它们可用于对生成的 HTML 文件进行后处理。它甚至支持 LuaXML DOM 对象，因此我们可以轻松遍历文档并更新所有<a>元素。

我们可以使用.aux文件中存储的信息。标签与 TeX4ht 分配的之间的映射id以以下形式存储在这里：

\newlabel{sec:intro}{{\rEfLiNK{x1-10001}{1}}{\rEfLiNK{x1-10001}{1}}}

可以看到标签存放在的第一个参数中\newlabel，ID 是的第一个参数\rEfLiNK。

这是构建文件build.lua：

local domfilter = require "make4ht-domfilter"

-- we need to parse the aux file to get mapping between labels and id attribute
-- of the corresponding <a> element
local function parse_aux(aux_filename)
  local mapping = {}
  local f = io.open(aux_filename, "r")
  local content = f:read("*all")
  f:close()
  -- labels are stored in this form:
  -- \newlabel{sec:intro}{{\rEfLiNK{x1-10001}{1}}{\rEfLiNK{x1-10001}{1}}}
  for label, id in content:gmatch("newlabel{(.-)}{{.-{(.-)}") do
    mapping[id] = label
  end
  return mapping
end

-- this will hold table with mapping between existing ids and labels
local aux

-- chain of functions that will process all generated HTML files
local process = domfilter {
  function(dom, properties)
    -- because there can be multiple HTML file, we want to reuse existing 
    -- mapping when we process subsequent files
    aux = aux or parse_aux(properties.input .. ".aux")
    -- process all <a> elements and replace ids generated by TeX4ht by original labels
    for _, a in ipairs(dom:query_selector("a")) do
      -- update id attributes
      local id = a:get_attribute("id")
      if aux[id] then a:set_attribute("id", aux[id]) end
      local href = a:get_attribute("href")
      -- fix links
      if href then
        -- get url and id from the hyperlink
        local url, id = href:match("(.*)#(.+)")
        if id and aux[id] then
          -- update hyperlink
          a:set_attribute("href", string.format("%s#%s", url or "", aux[id]))
        end
      end
    end
    return dom
  end
}

Make:match("html$", process)

此构建文件首先解析 AUX 文件并生成 TeX4ht 指定的 ID 属性与原始标签之间的映射。然后它循环遍历所有<a>元素并更新 ID 和超链接。

您可以使用以下命令编译您的文档：

make4ht -e build.lua filename.tex

结果如下：

<h3 class='sectionHead'><span class='titlemark'>1   </span> <a id='sec:intro'></a>Section heading</h3>
...
<p class='indent'>   This is a test to link to Section this text is for searching in HTML Karen heading
<a href='#sec:intro'>1<!-- tex4ht:ref: sec:intro  --></a>. </p>

结束语

我看得出您可能使用了自定义类，因为您的 HTML 代码片段生成的是<p>元素而不是<h3>部分。您可能希望为您的类创建一个配置文件，以获得结构更好的 HTML 文件。

当您为章节生成正确的标签时，当前版本的制作4小时（的现代替代品htlatex）产生以下代码：

<h3 id='section-heading' class='sectionHead'><span class='titlemark'>1   </span> <a id='x1-10001'></a>Section heading</h3>
...
<p class='indent'>   This is a test to link to Section this text is for searching in HTML Karen heading
<a href='#section-heading'>1<!-- tex4ht:ref: sec:intro  --></a>. </p>

因此，它会根据章节标题生成稳定的超链接目标。“章节标题”变为<h3 id="section-title">。对于您的用例来说，这可能比使用\label名称更好。

支持上述功能的版本make4ht尚未在 CTAN 上，因此您可能确实想使用\label我建议的方法之一来使用目前生成的所有超链接的标签。

Answer