关于 TeX 在用 ltxdoc 找到注释条件后会做什么

Question 1

正如您正确指出的那样，当您执行时pdflatex test.dtx，文件会读取%注释字符。当 TeX 发现时\DocInput，它基本上会忽略%行首并生成^^A注释字符。因此，您的输入基本上是

% \iffalse meta-comment    ^^A This /iffalse
\documentclass{ltxdoc}
\def\showfi{\immediate\write0{{/fi\ on line \the\inputlineno}}}%
\title{Doc Test}%
\newif\ifitsme\itsmetrue
\ifitsme\author{Me :)}%
\else   \author{Not me :/}%
\fi\showfi
\begin{document}%
\iffalse meta-comment    ^^A This /iffalse
\documentclass{ltxdoc}
\def\showfi{\immediate\write0{{/fi\ on line \the\inputlineno}}}%
\title{Doc Test}%
\newif\ifitsme\itsmetrue
\ifitsme\author{Me :)}%
\else   \author{Not me :/}%
\fi\showfi
\begin{document}%
  \DocInput{\jobname}%
\end{document}%
\fi\showfi               ^^A should match this /fi
\fi\showfi               ^^A but it's matching this one
\maketitle
\endinput
\end{document}%
% \fi\showfi               ^^A should match this /fi
% \fi\showfi               ^^A but it's matching this one
% \maketitle
% \endinput

现在\iffalse已经看到了，但是\ifitsme 是在跳过的文本中出现了两次条件，因此\fi需要查找两个匹配项。这就是问题所在，因为不再有匹配项\fi，\iffalse除非您像现在这样添加一个。

未注释的行中带有\fi“应该匹配这个 /fi”的行在\ifitsme之后匹配\newif。

在条件语句中定义条件语句总是会出现这种问题。使用

\expandafter\newif\csname ifitsme\endcsname

因此当代码位于跳过的文本中时，根本不会有任何条件。

Answer

正如您正确指出的那样，当您执行时pdflatex test.dtx，文件会读取%注释字符。当 TeX 发现时\DocInput，它基本上会忽略%行首并生成^^A注释字符。因此，您的输入基本上是

% \iffalse meta-comment    ^^A This /iffalse
\documentclass{ltxdoc}
\def\showfi{\immediate\write0{{/fi\ on line \the\inputlineno}}}%
\title{Doc Test}%
\newif\ifitsme\itsmetrue
\ifitsme\author{Me :)}%
\else   \author{Not me :/}%
\fi\showfi
\begin{document}%
\iffalse meta-comment    ^^A This /iffalse
\documentclass{ltxdoc}
\def\showfi{\immediate\write0{{/fi\ on line \the\inputlineno}}}%
\title{Doc Test}%
\newif\ifitsme\itsmetrue
\ifitsme\author{Me :)}%
\else   \author{Not me :/}%
\fi\showfi
\begin{document}%
  \DocInput{\jobname}%
\end{document}%
\fi\showfi               ^^A should match this /fi
\fi\showfi               ^^A but it's matching this one
\maketitle
\endinput
\end{document}%
% \fi\showfi               ^^A should match this /fi
% \fi\showfi               ^^A but it's matching this one
% \maketitle
% \endinput

现在\iffalse已经看到了，但是\ifitsme 是在跳过的文本中出现了两次条件，因此\fi需要查找两个匹配项。这就是问题所在，因为不再有匹配项\fi，\iffalse除非您像现在这样添加一个。

未注释的行中带有\fi“应该匹配这个 /fi”的行在\ifitsme之后匹配\newif。

在条件语句中定义条件语句总是会出现这种问题。使用

\expandafter\newif\csname ifitsme\endcsname

因此当代码位于跳过的文本中时，根本不会有任何条件。

Question 2

您的\newif命令位于内\iffalse，因此看不到它，并且\ifitsme现在根本不是“if”，或者如果\newif已经先前执行过，那么\ifitsme后面的\newif也算数，并且您有一个太多的“if”：

这有效：

\documentclass{article}
\begin{document}

\newif\ifitsme
\iffalse

\ifitsme hello \fi

\fi 
\end{document}

这失败了

\documentclass{article}
\begin{document}


\iffalse
\newif\ifitsme
\ifitsme hello \fi

\fi 
\end{document}

这也失败了

\documentclass{article}
\begin{document}

\newif\ifitsme

\iffalse
\newif\ifitsme %\newif not seen, but \ifitsme so one fi missing
\ifitsme hello \fi

\fi 
\end{document}

士气：最好不要\newif在里面使用\if—— \fi。

Answer

您的\newif命令位于内\iffalse，因此看不到它，并且\ifitsme现在根本不是“if”，或者如果\newif已经先前执行过，那么\ifitsme后面的\newif也算数，并且您有一个太多的“if”：

这有效：

\documentclass{article}
\begin{document}

\newif\ifitsme
\iffalse

\ifitsme hello \fi

\fi 
\end{document}

这失败了

\documentclass{article}
\begin{document}


\iffalse
\newif\ifitsme
\ifitsme hello \fi

\fi 
\end{document}

这也失败了

\documentclass{article}
\begin{document}

\newif\ifitsme

\iffalse
\newif\ifitsme %\newif not seen, but \ifitsme so one fi missing
\ifitsme hello \fi

\fi 
\end{document}

士气：最好不要\newif在里面使用\if—— \fi。

Question 3

这里有一个更安全地跳过内容的技巧。将其放在

\bgroup\catcode2 0 \catcode`\\ 12 ^^Biffalse

和

^^Bfi^^Begroup

这样做的目的是抑制启动控制序列。因此，您可以确定，在这期间对、、或等\进行的任何操作都不会产生任何影响。\if\fi\else\if...

0x02并且它将起始控制序列的含义分配给 ascii 字节。我们可以做一件安全的^^Biffalse/^^Bfi事情。

我没有使用^^A文档为其分配注释字符，并且我们希望保留它（特别是如果编辑器适当地突出显示）。

我猜你的 MWE 看起来会像这样

% \tracingall
% \bgroup\catcode2 0 \catcode`\\ 12 ^^Biffalse
\documentclass{ltxdoc}
\def\showfi{\immediate\write0{{/fi\ on line \the\inputlineno}}}%
\title{Doc Test}%
\newif\ifitsme\itsmetrue
\ifitsme\author{Me :)}%
\else   \author{Not me :/}%
\fi\showfi
\begin{document}%
  \DocInput{\jobname.dtx}%
  \tracingnone
\end{document}%
% \fi\showfi
% ^^Bfi^^Begroup
% \tracingnone
% \maketitle
% \endinput

文件另存为test.dtx。

警告：虽然我使用 doc，但dtx我从未使用过\DocInput（因为它导致了我想要处理保护的方式的无穷无尽的问题，并且因为我不希望文档部分（不是代码实现，而是用户手册）被“注释掉”）所以我不知道这是否会是你的用例。

Answer