我应该如何诊断这个问题?弄清楚何时将代码插入钩子以改变第三方包的行为

我应该如何诊断这个问题?弄清楚何时将代码插入钩子以改变第三方包的行为

这个问题对我来说似乎很令人困惑,所以我不确定你是否能够理解它。

我知道如何解决这个问题(现在)。我想知道的是我应该如何诊断和解决这个问题。解决这个问题花了我大约 24 小时(诚然,这个问题不是我唯一的工作)。考虑到我相对容易地隔离了问题,并且解决方案相对有据可查,这似乎是一个过长的时间。花时间的是弄清楚在哪里--- 或者更准确地说,什么时候放它。

我的实际代码相当复杂,但更大的复杂性并没有真正使发现问题变得更加困难。

基本问题是需要生成一个或多个词汇表,但不能glossaries在顶层创建标题、目录条目和分页符。但我确实想glossaries为子词汇表创建标题,其中两组或更多组词汇表条目分组在一个主标题下。

我很快发现:打印无标题的词汇表打印无标题的词汇表。[鉴于我使用了 SE 的搜索,所以速度非常快。]

因此我花了接下来的 23 个小时试图弄清楚在何时何地进行干预。

回想起来,事情之所以复杂,是因为我试图从类而不是文档本身进行干预。似乎使用哪个钩子是一个微妙的问题,即使你可以在文档中\begin{document}直接进行更改,也可以在更改之前或之后进行更改。

所做的更改begindocument似乎有效;所做的begindocument/after更改无效。\printglossary在类中所做的更改确实有效,但仅限于局部。尝试在类中更改部分命令似乎在begindocument非常非常接近之后失败\printglossary。但cmd/printglossary/before也不起作用。

因此,从干预的角度来看,很少有地方能起作用。我应该如何找到这些特定的地方?特别是,我如何才能确定我需要做出改变较早或仅很久以后而不是像我预期的那样,稍后

\begin{filecontents}[overwrite]{\jobname-g1.tex}
\ProvidesFile{\jobname-g1.tex}
\newglossaryentry{a}{name=a,description=A,type=ga}
\newglossaryentry{b}{name=b,description=B,type=gb}
\newglossaryentry{c}{name=c,description=C,type=gc}
\newglossaryentry{m}{name=m,description=M}
\end{filecontents}
\documentclass{book}
\ExplSyntaxOn
% the next line doesn't work
\hook_gput_code:nnn { begindocument / after } { . / my glossaries }
% the next line does work (begindocument/before works, too)
% \hook_gput_code:nnn { begindocument } { . / glossaries }
% the following line also works
% \hook_gput_code:nnn { package/glossaries/after } { . }
{
  \setglossarysection {subsection}
  \renewcommand* \glsclearpage {}
}
\ExplSyntaxOff
\NewDocumentCommand \mything {+m}
{%
  \cleardoublepage
  {\parindent=0pt
    \hrule\par
    {\Huge #1\par}%
    \hrule\par   
  }%
}
\NewDocumentCommand \mywords {ommo}
{% intervening up here somewhere doesn't work
  \mything{#3}%
  \addcontentsline{toc}{section}{#3}%
    \IfValueTF{#4}{%
      % intervening here works, but { cmd/printglossary/before } doesn't
      \printglossary[title={#2},type=#2]%
      \printglossary[title={#4},type=#4]%
    }{%
      \printglossary[title={},type=#2]%
    }
}
\usepackage[nonumberlist,subentrycounter,toc,xindy]{glossaries}
\newglossary[ga-glg]{ga}{ga-gls}{ga-glo}{As} 
\newglossary[gb-glg]{gb}{gb-gls}{gb-glo}{Bs} 
\newglossary[gc-glg]{gc}{gc-gls}{gc-glo}{Cs} 
\setglossarystyle{altlist}
\loadglsentries{\jobname-g1}
\makeglossaries
% Uncommenting the following line works
% \setglossarysection{subsection}
\begin{document}
% uncommenting this line works
% \setglossarysection{subsection}
\tableofcontents

\mything{T}
\gls{a} \gls{b}  \gls{c} \gls{m}

\mywords[b]{ga}{A-B-Words}[gb]

\mywords{gc}{C-Words}

\mywords{main}{M-Words}

\end{document}

例如,我可以查看begindocument钩子的内容:

-> The hook 'begindocument/after':
> The hook is not declared.
> Code chunks:
>     top-level/myglossaries -> \setglossarysection {subsection}\renewcommand *
\glsclearpage {}
> Document-level (top-level) code:
>     ---
> Extra code for next invocation:
>     ---
> Rules:
>     ---
> Execution order:
>     Not set because the hook is undeclared.
<recently read> }

l.895 \hook_show:n { begindocument/after }

?

-> The hook 'begindocument':
> Code chunks:
>     amsmath -> \reset@strutbox@ \MakeRobust \dddot \MakeRobust \ddddot \mathc
hardef \std@minus \mathcode `\-\relax \mathchardef \std@equal \mathcode `\=\rel
ax \expandafter \let \csname overleftarrow \endcsname \@undefined \expandafter
\let \csname overrightarrow \endcsname \@undefined \MakeRobust \overrightarrow
\MakeRobust \overleftarrow \MakeRobust \overleftrightarrow \MakeRobust \underri
ghtarrow \MakeRobust \underleftarrow \MakeRobust \underleftrightarrow
>     datatool-base -> \@ifundefined {texteuro}{}{\DTLnewcurrencysymbol {\texte
uro }}\@ifundefined {textdollar}{}{\DTLnewcurrencysymbol {\textdollar }}\@ifund
efined {textstirling}{}{\DTLnewcurrencysymbol {\textstirling }}\@ifundefined {t
extyen}{}{\DTLnewcurrencysymbol {\textyen }}\@ifundefined {textwon}{}{\DTLnewcu
rrencysymbol {\textwon }}\@ifundefined {textcurrency}{}{\DTLnewcurrencysymbol {
\textcurrency }}\@ifundefined {euro}{}{\DTLnewcurrencysymbol {\euro }}\@ifundef
ined {yen}{}{\DTLnewcurrencysymbol {\yen }}
>     glossaries -> \ifglsacronym \providecommand *{\printacronyms }[1][]{\prin
tglossary [type=\acronymtype ,##1]}\fi \ifx \gls@codepage \@empty \@ifpackagelo
aded {fontspec}{\def \gls@codepage {utf8}}{}\fi \gls@begindocdefs \@ifpackagelo
aded {amsmath}{\let \gls@if@measuring \@gls@if@measuring }{}\let \gls@org@refst
epcounter \refstepcounter \let \gls@org@label \label \renewcommand *{\@gls@adju
stmode }{\ifvmode \mbox {}\fi }
> Document-level (top-level) code (executed last):
>     ---
> Extra code for next invocation:
>     ---
> Rules:
>     ---
> Execution order:
>     amsmath, datatool-base, glossaries.
<recently read> }

l.896 \hook_show:n { begindocument }
?

-> The hook 'begindocument/before':
> The hook is empty.
<recently read> }

l.897 \hook_show:n { begindocument/before }

?

但这似乎证实了我的代码begindocument/after在完成任何默认设置后正在运行。这表明它应该等同于在之后使用文档中的代码\begin{document},但后者有效,而前者失败。

begindocument/after那么,当钩子中不包含其他可能干扰的代码时,钩子中运行的代码和之后运行的代码有什么不同\begin{document}?为什么代码需要进入较早钩子,即使插入到文档本身中时间并不重要?

相关内容