summaryrefslogtreecommitdiff
path: root/graphics/pgf/contrib/tikz-ext/doc/tikz-ext-manual-en-library-calendar-plus.tex
blob: 14c78e9be0f667bf7e6c52151157180f03777e16 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
% !TeX spellcheck = en_US
% !TeX root = tikz-ext-manual.tex
% Copyright 2022 by Qrrbrbirlbel
%
% This file may be distributed and/or modified
%
% 1. under the LaTeX Project Public License and/or
% 2. under the GNU Free Documentation License.
%

\section{Calendar}
\begin{tikzlibrary}{ext.calendar-plus}
  This library extends the \tikzname\space library |calendar|\indexLibraryO{calendar}.
\end{tikzlibrary}

\begin{multicols}{2}

\subsection{Value-keys and nestable \texttt{if} key}

The values of following keys are originally stored in some macros that are not
accessible by the user. These are now simple value-keys.
The |@|-protected macros are still available, of course.

\begin{key}{/tikz/day xshift (initially 3ex)}
\end{key}
\begin{key}{/tikz/day yshift (initially 3.5ex)}
\end{key}
\begin{key}{/tikz/month xshift (initially 9ex)}
\end{key}
\begin{key}{/tikz/month yshift (initially 9ex)}
\end{key}

It is now also possible to nest |/tikz/if| occurrences.
\begin{key}{/tikz/if=|(|\meta{conditions}|)|\meta{code or options}\opt{|else|\meta{else code or options}}}
\end{key}

\subsection{Week numbering (ISO~8601)}

The actual week number algorithm is implemented by the |pgfcalendar-ext| package/module in section~\ref{calendar:weeknumbering}.
\begin{key}{/tikz/week code=\meta{code}}
  Works like |/tikz/day code| or |/tikz/month code|, only for weeks.\indexKeyO{day code}\indexKeyO{month code}
\end{key}

\begin{key}{/tikz/week text=\meta{text}}
  Works like |/tikz/day text| or |/tikz/month text|, only for weeks.\indexKeyO{day text}\indexKeyO{month text}
\end{key}

\begin{stylekey}{/tikz/every week}
  Works like |/tikz/every day| or |/tikz/every month|, only for weeks.\indexKeyO{every day}\indexKeyO{every month}
\end{stylekey}

\begin{stylekey}{/tikz/week label left}
    Places the week label to the left of the first day of the month. (For
    |week list| and |month list| where a week does not start on a Monday, the
    position is chosen ``as if'' the week had started on a Monday --  which is
    usually exactly what you want.)
    %
\begin{codeexample}[preamble={\usetikzlibrary{ext.calendar-plus}}]
\tikz
  \calendar [week list, month label above centered,
             dates=2022-07-01 to 2022-07-31,
             week label left,
             every week/.append style={gray!50!black,font=\sffamily}];
\end{codeexample}
    %
\end{stylekey}

\end{multicols}
\endinput