Definition eines Befehls mit einem optionalen und zwei obligatorischen Argumenten

Bekanntlich ist \newcommand mit einem obligatorischen Argument, gefolgt von zwei optionalen Argumenten, gefolgt von einem weiteren obligatorischen Argument definiert:

\newcommand{Befehl}[Argumentanzahl][Default-Wert]{Definition}

• Befehl ist der der Befehl, der definiert werden soll, im Beispiel aus der Frage also \Kalenderblatt.

• Argumentanzahl ist eine natürliche Zahl zwischen 1 und 9 und gibt die Anzahl aller Argumente an, die der Befehl verstehen soll. Im Beispiel aus der Frage ist das 2. Es wird also ein Befehl mit zwei Argumenten definiert. Wird \newcommand ohne optionales Argument verwendet, so hat der definierte Befehl selbst kein Argument.

• Default-Wert ist die Voreinstellung für ein optionales Argument für den neuen Befehl. Das optionale Argument wird bei Argumentanzahl mit gezählt. Es ist bei \newcommand immer das erste Argument, das dann statt in geschweifte in eckige Klammern zu setzen ist (wie die optionalen Argumente von \newcommand auch). Um einen Befehl mit einem optionalen Argument zu definieren, muss also Argumentanzahl min. 1 sein und es muss zumindest ein leerer Default-Wert angegeben werden. Beim Aufruf des neuen Befehls wird Default-Wert immer dann verwendet, wenn der neue Befehl ohne optionales Argument aufgerufen wird. Wird der neue Befehl dagegen mit einem leeren optionalen Argument aufgerufen, so ist optionale Argument dann auch tatsächlich leer. In diesem Fall wird also nicht der Default-Wert verwendet. In der Frage ist \Kalenderblatt ohne optionales Argument definiert.

• Definition ist die Definition von Befehl. Innerhalb der Definition dienen #1, #2, #3 … #9 als Platzhalter für das erste, das zweite, das dritte … das neunte Argument. Ist das erste Argument optional, so steht #1 entweder für das angegebene optionale Argument oder für Default-Wert, falls kein optionales Argument angegeben wurde. Für Experten (im Beispiel irrelevant): Falls Definitionen in Definitionen geschachtelt sind, muss die Anzahl der # für jede Schachtelungsebene (von außen nach innen) verdoppelt werden, um die Argumente von äußeren Definitionen von denen innerer Definitionen unterscheiden zu können.

Es gibt von \newcommand auch eine Sternform \newcommand*, die in der Frage auch verwendet wurde. Zu den Unterschieden siehe: Was ist der Unterschied zwischen \newcommand und \newcommand*?

Um nun also einen Befehl mit einem optionalen Argument zu definieren, sei zunächst noch einmal darauf hingewiesen, dass dieses optionale Argument dann das erste Argument sein muss, innerhalb der Definition also durch #1 repräsentiert wird. Ich würde auch nicht empfehlen, direkt den Skalierungsfaktor als optionales Argument zu verwenden. Es ist flexibler das optionale Argument einfach als optionales Argument für \includegraphics zu deklarieren. Das sähe dann in einem auf sinnvolles verkürzten Beispiel so aus:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
\documentclass[fontsize=20pt,ngerman]{scrartcl}
\usepackage{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{graphicx}
\newcommand*{\Kalenderblatt}[3][]{% drei Argumente, erstes optional mit leerem Default
  \cleardoublepage
  \begin{minipage}[c][.5\textheight]{\textwidth}
    \centering
    \includegraphics[#1]{#2}
  \end{minipage}
  \vfill
  Hier stünde dann der Kalender für #3.
  \clearpage
}
\begin{document}
\centering
\Kalenderblatt[scale=1.2]{example-image-a}{2018-05-01 to 2018-05-last}
\Kalenderblatt[scale=0.7]{example-image-b}{2018-06-01 to 2018-06-last}
\Kalenderblatt{example-image-c}{2018-06-01 to 2018-06-last}
\end{document}
 
 
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX