☰

帶標籤的輸入參數

tag-icon • tag-icon macros xparse etoolbox
帶標籤的輸入參數

我正在為各種考試創建一個首頁，並希望進一步實現自動化。目前，我在序言中寫入（或更確切地說是複製貼上）大量命令，如下所示：

\newcommand{\contact}{Lecturer name}
\newcommand{\date}{2019-07-12}
.
.
\settoggle{isVisit}{true}

在我的主要文件中，我透過編寫來呼叫它

\FrontpageUiT

下面顯示了一個最小的範例。我想更改命令，以便可以使用以下語法

\FrontpageUiTsetup{
    contact = Lecturer name, 
    date = 2019-07-12,
    pages =,
%   visit = Yes,
    visitWhen = approximately 11
    .
    .
    .
}

並通過編寫來調用它

\FrontpageUiT

在主文檔中。我對安裝檔案有一些非常基本的需求

  • 如果某行未包含在設定中（或註解掉）。該行不應存在於列印的表格中。它應該被忽略/刪除。
  • 如果一行為空白，則應將其作為空白包含在內。

是否可以建立一個具有設定檔和命名輸入的函數？

\documentclass{article}
\usepackage{etoolbox}
\usepackage{lastpage,hyperref}
\newtoggle{isVisit}   \settoggle{isVisit}{true}
\newtoggle{showVisit} \settoggle{showVisit}{true}
\usepackage[utf8]{inputenc}

\newcommand{\courseCode}{MAT~--~2200}
\newcommand{\courseNameEnglish}{Differential Equations}

% Default time is 09:00 - 13:00 | Uncomment and change the line below  \visif neccecary
% \newcommand{\examtime}{15:00--19:00}
\newcommand{\location}{Technical Studies 1}
\newcommand{\permittedAids}{Calculator}
\newcommand{\paper}{squares}
\newcommand{\pages}{} % Sets the total number of pages manually. Uncomment if neccecary
\newcommand{\contact}{John Doe}
\newcommand{\mobile}{}

\settoggle{isVisit}{false} % Uncomment this line if examinator / person in charge is visiting
\newcommand{\visitWhen}{ca. 11:00}
\settoggle{showVisit}{true} %Uncomment if unknown when visit

% \newcommand{\ExerciseNumber}{1}

\newcommand{\PublishedDate}{2018--09--25}% YEAR {dddd} MONTH {01 - 12} DAY {01 - 31} 
% \Deadline{2018}{11}{27}% Has to be set, not visible if exam

\newcommand{\nonEmptyExist}[3]{%
    \ifdef{#1}{%
        \ifdefempty{#1}{#2}{#3}%%
    }{%
        #2%
    }%
}

\newcommand{\FrontpageUiT}{%
    \begin{tabular}{|p{0.2\textwidth}|p{0.728\textwidth}|}
        \hline
            Exam: & \courseCode, \courseNameEnglish\\ \hline
            Date: & \PublishedDate \\ \hline
            Time: & \nonEmptyExist{\examtime}{09:00 -- 13:00}{\examtime} \\ \hline
            Location: & \location \\ \hline
            Permitted aids & \permittedAids \\
            \hline
            Type of paper & \paper \\ \hline
            Total pages & \bfseries\nonEmptyExist{\pages}{\pageref*{LastPage}}{\pages} \\ \hline
            Contact & John Doe \\ 
            Mobile & \mobile \\ \hline
            \iftoggle{showVisit}{%
            \multicolumn{2}{|l|}{Does lecturer visit \iftoggle{isVisit}{YES}{NO}} 
            \iftoggle{isVisit}{\\ \multicolumn{2}{|l|}{If yes: \visitWhen}}{} \\ \hline}{}%
        \end{tabular}
}

\begin{document}

\FrontpageUiT

\end{document}

答案1

傳統的介面是使用一個命令\location來儲存一些值\@location（並且對於所有其他參數來說都是相同的）。然後，排版命令應該使用儲存的值（如果存在）。 （這是\date、等標準類別使用的介面author）

以下是您可以執行此操作的方法（針對一小部分參數）：

\documentclass{article}

\usepackage{booktabs}

\makeatletter
  % Provide commands.
  \newcommand*\new@document@parameter[1]{%
    % Check if names are taken.
    \expandafter\newcommand\csname #1\endcsname{}%
    \expandafter\newcommand\csname @#1\endcsname{}%
    % Set up the parameter
    \expandafter\edef\csname #1\endcsname##1{%
      \gdef\expandafter\noexpand\csname @#1\endcsname{##1}%
    }%
    \expandafter\let\csname @#1\endcsname\@empty
  }
  \new@document@parameter{examtime}
  \new@document@parameter{location}
  \new@document@parameter{permittedaids}
  \new@document@parameter{contact}
  % Provide initial values.
  \examtime{09:00\,--\,13:00}
  % Provide names.
  \newcommand*\examtimename{Time}
  \newcommand*\locationname{Location}
  \newcommand*\permittedaidsname{Permitted aids}
  \newcommand*\contactname{Contact}
  % The typesetting command.
  \newcommand\FrontpageUiT{%
    \noindent
    \begin{tabular}{p{0.2\textwidth} p{\dimexpr 0.8\textwidth - 4\tabcolsep}}\toprule
      \ifx\@examtime\@empty\else
        \examtimename & \@examtime \\%
      \fi
      \ifx\@location\@empty\else
        \locationname & \@location \\%
      \fi
      \ifx\@permittedaids\@empty\else
        \permittedaidsname & \@permittedaids \\%
      \fi
      \ifx\@contact\@empty\else
        \contactname & \@contact \\%
      \fi
      \bottomrule
    \end{tabular}%
  }
\makeatother

\location{Room~101}
\contact{Mr.~O'Brien}

\begin{document}

\FrontpageUiT

\end{document}
  • 如果您確實想以相同的方式排版所有參數，當然可以添加一個巨集來節省一些打字。
  • 如果你不關心語言適應性，當然可以直接鍵入參數名稱，\FrontpageUiT而不是為每個參數定義一個巨集。
  • 我對你的桌子做了一些改進。看看你是否喜歡它們。

如果您喜歡鍵值接口，則可以使用提供該功能的各種套件輕鬆實現。看起來expl3像這樣： Load xparse，將提供命令和初始值的部分替換為

  \ExplSyntaxOn
    % Provide keys.
    \keys_define:nn { babylonia }
      {
        examtime      .tl_set:N  = \@examtime,
        examtime      .initial:n = {09:00\,--\,13:00},
        location      .tl_set:N  = \@location,
        permittedaids .tl_set:N  = \@permittedaids,
        contact       .tl_set:N  = \@contact,
      }
    % Provide key setting command.
    \NewDocumentCommand\FrontpageUiTsetup{ m }{
      \keys_set:nn { babylonia } { #1 }
    }
  \ExplSyntaxOff

並將按鍵設為

\FrontpageUiTsetup{
  location = Room~101,
  contact  = Mr.~O'Brien,
}

（當然，整個事情可以以與 更一致的方式設置和命名expl3，但這就是想法。）

相關內容