Лучшие практики по настройке параметров пакета в середине документа

Лучшие практики по настройке параметров пакета в середине документа

В настоящее время я работаю над пакетом, в котором пользователь может устанавливать параметры пакета в середине документа или в локальной группе. В настоящее время пользователь может сделать это с помощью пользовательских команд \set<package>keysили \reset<package>keys, которые сначала сбрасывают параметры пакета до значений по умолчанию, прежде чем устанавливать новые параметры. Я предполагаю, что эти команды будут использоваться только на уровне документа; их не следует использовать непосредственно в преамбуле.

Мой вопрос: как лучше всего называть эти команды? Мое замешательство пришло из другой ветки обмена стеками Вариант пакета и команда настройки где верхний ответ рекомендует автору пакета предоставить пользовательскую команду с именем \<package>setup. Кроме того, многие другие пакеты следуют тому же соглашению: siunitxuses \sisetup, unicode-mathuses \unimathsetup, microtypeuses \microtypesetupи т. д. Однако я обнаружил, что имя \package<setup>подразумевает, в отличие от моего текущего пакета, что (1) \<package>setupможет/должно использоваться непосредственно в преамбуле и (2) \<package>setupустанавливает параметры пакетаглобальноскорее, чемлокально.

Я добавляю тег expl3к своему вопросу, потому что в настоящее время пишу пакет в expl3. Также параметры пакета определяются через l3keysи \ProcessKeyOptions.

Связанный контент