包中的互斥选项

Question 1

该kvoptions包提供了键值类型选项，也可以定义补充选项：

\DeclareBoolOption{draft}
\DeclareComplementaryOption{final}{draft}

这会生成一个 if-switch，由设置为 true，draft但由设置为 false final。

但是，如果您指的是互斥选项，例如三个选项中只有一个可用，那么最好定义三个 if 开关，并由其对应的选项设置为 true。然后，这些选项要么将其他选项的 if 开关设置为 false，要么如果其中一个 if 开关已设置为 true，则引发错误或警告。

% package 'foo'
% Example: three mutually options alpha, beta, gamma; last one 
\newif\iffoo@alpha
\newif\iffoo@beta
\newif\iffoo@gamma

\DeclareOption{alpha}{\foo@alphatrue\foo@betafalse\foo@gammafalse}
\DeclareOption{beta}{\foo@alphafalse\foo@betatrue\foo@gammafalse}
\DeclareOption{gamma}{\foo@alphafalse\foo@betafalse\foo@gammatrue}

\ProcessOptions*% process options it the order the user provides them

% package body:
\iffoo@alpha
   % alpha code
\fi
\iffoo@beta
   % beta code
\fi
\iffoo@gamma
   % gamma code
\fi

或者出现错误消息：

\def\foo@mutopterr{%
    \PackageError{foo}{Options 'alpha', 'beta' and 'gamma' are mutually exclusive.}{}%
}%
\DeclareOption{alpha}{%
    \iffoo@beta\foo@mutopterr\fi
    \iffoo@gamma\foo@mutopterr\fi
    \foo@alphatrue\foo@betafalse\foo@gammafalse
}
\DeclareOption{beta}{%
    \iffoo@alpha\foo@mutopterr\fi
    \iffoo@gamma\foo@mutopterr\fi
    \foo@alphafalse\foo@betatrue\foo@gammafalse
}
\DeclareOption{gamma}{%
    \iffoo@alpha\foo@mutopterr\fi
    \iffoo@beta\foo@mutopterr\fi
    \foo@alphafalse\foo@betafalse\foo@gammatrue
}

Answer

该kvoptions包提供了键值类型选项，也可以定义补充选项：

\DeclareBoolOption{draft}
\DeclareComplementaryOption{final}{draft}

这会生成一个 if-switch，由设置为 true，draft但由设置为 false final。

但是，如果您指的是互斥选项，例如三个选项中只有一个可用，那么最好定义三个 if 开关，并由其对应的选项设置为 true。然后，这些选项要么将其他选项的 if 开关设置为 false，要么如果其中一个 if 开关已设置为 true，则引发错误或警告。

% package 'foo'
% Example: three mutually options alpha, beta, gamma; last one 
\newif\iffoo@alpha
\newif\iffoo@beta
\newif\iffoo@gamma

\DeclareOption{alpha}{\foo@alphatrue\foo@betafalse\foo@gammafalse}
\DeclareOption{beta}{\foo@alphafalse\foo@betatrue\foo@gammafalse}
\DeclareOption{gamma}{\foo@alphafalse\foo@betafalse\foo@gammatrue}

\ProcessOptions*% process options it the order the user provides them

% package body:
\iffoo@alpha
   % alpha code
\fi
\iffoo@beta
   % beta code
\fi
\iffoo@gamma
   % gamma code
\fi

或者出现错误消息：

\def\foo@mutopterr{%
    \PackageError{foo}{Options 'alpha', 'beta' and 'gamma' are mutually exclusive.}{}%
}%
\DeclareOption{alpha}{%
    \iffoo@beta\foo@mutopterr\fi
    \iffoo@gamma\foo@mutopterr\fi
    \foo@alphatrue\foo@betafalse\foo@gammafalse
}
\DeclareOption{beta}{%
    \iffoo@alpha\foo@mutopterr\fi
    \iffoo@gamma\foo@mutopterr\fi
    \foo@alphafalse\foo@betatrue\foo@gammafalse
}
\DeclareOption{gamma}{%
    \iffoo@alpha\foo@mutopterr\fi
    \iffoo@beta\foo@mutopterr\fi
    \foo@alphafalse\foo@betafalse\foo@gammatrue
}

Question 2

有人可以提供一个简单的例子吗？

标准 LaTeX 文档类采用onesided和twosided、draft和final和titlepage作为notitlepage选项，每对都是互斥的。还有互斥的选项来指定纸张大小和点大小，但这里有多个选项而不是两个。这些选项的实现是一个简单的 `\DeclareOption'。虚构的 foo/nofoo 选项的示例：

\newif\@foo
\@footrue % Makes foo the default; use \@foofalse if the default is nofoo
\DeclareOption{foo}{\@footrue}
\DeclareOption{nofoo}{\@foofalse}

一个关键问题：如何处理指定矛盾选项的用户？例如，指定twosided,final,onesided,draft为基本 LaTeX 文档类之一的选项，您将获得（没有任何抱怨）以最终模式格式化的双面文档。

这是因为基本 LaTeX 文档类用于\ProcessOption处理选项。\ProcessOption按照选项声明的顺序遍历选项。如果使用这些类\ProcessOption*代替\ProcessOption，则结果twosided,final,onesided,draft将是草稿形式的单方面文档。发生\ProcessOption冲突时，获胜者是包本身，而\ProcessOption*发生冲突时，获胜者是包的用户。

如果您希望实现因用户指定互斥选项而责骂用户，那么您将必须做一些更复杂的事情。

Answer