summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-09-23 23:06:59 +0000
committerKarl Berry <karl@freefriends.org>2017-09-23 23:06:59 +0000
commit4703727d234147fdadfd31af75329850476dde45 (patch)
tree568e74cd608c40d39d9d53ee47f30409713d3d09 /Master/texmf-dist/doc
parent44376c98a6543220ca702536b7f618f7cc62168f (diff)
mensa-tex (23sep17)
git-svn-id: svn://tug.org/texlive/trunk@45390 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/mensa-tex/README.md7
-rw-r--r--Master/texmf-dist/doc/latex/mensa-tex/mensa-tex-doc.pdfbin0 -> 67735 bytes
-rw-r--r--Master/texmf-dist/doc/latex/mensa-tex/mensa-tex-doc.tex554
3 files changed, 561 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/mensa-tex/README.md b/Master/texmf-dist/doc/latex/mensa-tex/README.md
new file mode 100644
index 00000000000..2628673cd3c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/mensa-tex/README.md
@@ -0,0 +1,7 @@
+# mensa-tex
+A LaTeX class for typesetting school cafeteria menus consisting of two lunches (with dessert) and dinner
+
+This work, consisting of the files `mensa-tex.cls` and `mensa-tex-doc.tex`, is licensed under the LPPL, Version 1.3c (or, at your option, any later version)
+Current maintainer of the work is Sebastian Friedl.
+
+mensa-tex requires LaTeX2e and depends on the packages `array`, `colortbl`, `datetime2`, `datetime2-calc`, `geometry`, `graphicx`, `lmodern`, `textcomp` and `xcolor`
diff --git a/Master/texmf-dist/doc/latex/mensa-tex/mensa-tex-doc.pdf b/Master/texmf-dist/doc/latex/mensa-tex/mensa-tex-doc.pdf
new file mode 100644
index 00000000000..f843ff1961e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/mensa-tex/mensa-tex-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/mensa-tex/mensa-tex-doc.tex b/Master/texmf-dist/doc/latex/mensa-tex/mensa-tex-doc.tex
new file mode 100644
index 00000000000..3edd579cf23
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/mensa-tex/mensa-tex-doc.tex
@@ -0,0 +1,554 @@
+%% This is file 'mensa-tex-doc.tex', Version 2017-09-23
+%% Copyright 2017 Sebastian Friedl <sfr682k@t-online.de>
+%%
+%% This work may be distributed and/or modified under the conditions of the LaTeX Project
+%% Public License, either version 1.3c of this license or (at your option) any later version.
+%% The latest version of this license is available at
+%% http://www.latex-project.org/lppl.txt
+%% and version 1.3c or later is part of all distributions of LaTeX version 2008-05-04 or later.
+%%
+%% This work has the LPPL maintenance status 'maintained'.
+%% Author: Sebastian Friedl
+%% Current maintainer of this work is Sebastian Friedl
+%%
+%% This work consists of the files mensa-tex.cls and mensa-tex-doc.tex
+%%
+%% ---------------------------------------------------------------------------------------------------------------------------------------------
+%%
+%% A LaTeX class for typesetting school cafeteria menus consisting of two lunches (with dessert) and dinner
+%%
+%% ---------------------------------------------------------------------------------------------------------------------------------------------
+%%
+%% Please report bugs and other problems as well as suggestions for improvements to the following email address: sfr682k@t-online.de
+%%
+%% ---------------------------------------------------------------------------------------------------------------------------------------------
+
+
+% !TeX spellcheck = en_US
+% !TeX program=lualatex
+
+
+
+\documentclass[11pt]{ltxdoc}
+
+\usepackage[utopia]{mathdesign}
+\usepackage[no-math]{fontspec}
+
+\usepackage{polyglossia}
+\setdefaultlanguage{english}
+\usepackage[english]{selnolig}
+
+\usepackage{array}
+\usepackage{csquotes}
+\usepackage{hyperref}
+\usepackage{multicol}
+\usepackage{textcomp}
+\usepackage{xcolor}
+
+
+\parindent 0pt
+
+\setmainfont[Numbers=OldStyle]{erewhon}
+\setsansfont[Numbers=OldStyle,Scale=MatchLowercase]{Source Sans Pro}
+\setmonofont[Numbers=OldStyle,Scale=MatchLowercase]{Source Code Pro}
+
+\usepackage[left=4.50cm,right=2.75cm,top=3.25cm,bottom=2.75cm,nohead]{geometry}
+
+\hyphenation{}
+
+\title{The \texttt{mensa-tex} class \\ {\large\url{https://github.com/SFr682k/mensa-tex}}}
+\author{Sebastian Friedl \\ \href{mailto:sfr682k@t-online.de}{\ttfamily sfr682k@t-online.de}}
+\date{2017/09/23}
+
+\hypersetup{pdftitle={The mensa-tex class},pdfauthor={Sebastian Friedl}}
+
+\begin{document}
+ \maketitle
+ \thispagestyle{empty}
+
+ \begin{center} \itshape
+ \enquote{I can't go to a restaurant and order food \\ because I keep looking at the fonts on the menu} \\
+ --- \textsc{\upshape Donald E. Knuth} ---
+ \end{center}
+
+ \medskip
+ \begin{abstract}
+ \noindent%
+ A \LaTeX\ class for typesetting school cafeteria menus consisting of two lunches (with dessert) and dinner
+ \end{abstract}
+
+
+ \tableofcontents
+
+ \clearpage
+
+
+
+ \subsection*{Dependencies and other requirements}
+ \addcontentsline{toc}{subsection}{Dependencies and other requirements}
+ The \texttt{mensa-tex} class requires \LaTeXe\ and the following packages:
+ \begin{multicols}{3}\ttfamily\centering
+ array \\ colortbl \\ datetime2 \\ datetime2-calc \\ geometry \\ graphicx \\ lmodern \\ textcomp \\ xcolor
+ \end{multicols}
+
+
+ \subsection*{License}
+ \begin{small}
+ \addcontentsline{toc}{subsection}{License}
+ \textcopyright\ 2017 Sebastian Friedl
+
+ \smallskip
+ This work may be distributed and/or modified under the conditions of the \LaTeX\ Project Public License, either version 1.3c of this license or (at your option) any later version.
+
+ \smallskip
+ The latest version of this license is available at \url{http://www.latex-project.org/lppl.txt} and version 1.3c or later is part of all distributions of \LaTeX\ version 2008-05-04 or later.
+
+ \smallskip
+ This work has the LPPL maintenance status \enquote*{maintained}. The current maintainer of this work is Sebastian Friedl. \\
+ This work consists of the following files:
+ \begin{itemize} \itemsep 0pt
+ \item \texttt{mensa-tex.cls} and
+ \item \texttt{mensa-tex-doc.tex}
+ \end{itemize}
+ \end{small}
+
+
+ \subsection*{Call for cooperation}
+ \addcontentsline{toc}{subsection}{Call for cooperation}
+ Please report bugs and other problems as well as suggestions for improvements by using the \href{https://github.com/SFr682k/mensa-tex/issues}{issue tracker on GitHub} or sending an email to \href{mailto:sfr682k@t-online.de}{\texttt{sfr682k@t-online.de}}.
+
+
+ \clearpage
+
+
+
+ % DOCUMENTATION PART ----------------------------------------------------------------------
+
+ \section{Using the \texttt{\textbackslash documentclass} command} \label{sec:docclass}
+ Using this class is as easy as using the \verb|\documentclass{mensa-tex}| command.
+
+ \bigskip
+ Following class options are available:
+ \begin{itemize}
+ \item[\texttt{app}] Use a layout optimized for small screens using DIN/ISO A6 paper
+ \item[\texttt{en-GB}] Use an English localization, British variant \textit{(default)}
+ \item[\texttt{en-US}] Use an English localization, American variant
+ \item[\texttt{german}] Use a German localization
+ \end{itemize}
+
+
+
+ \section{Creating a menu}
+ This section deals with creating a menu using \texttt{mensa-tex}. \\
+ \textit{\color{red} All the commands described in this section are to be used inside the preamble} since the menu gets created instantly when using \verb|\begin{document}|.
+
+ \subsection{Setting up the basic information}
+ The basic information consists of the name of the cafeteria, the institute (or school) it is located at and the image used on the single pages. \\
+ It can be set by using the following commands:
+
+ \medskip
+ \DescribeMacro{\mensaname}
+ This command is used to declare the name of the cafeteria -- maybe something like \verb|\mensaname{Food Corner}| \textit{(default is the plain old boring \enquote{Mensa})}. \\
+ You may want to change the font size by using arbitrary \LaTeX\ font size commands.
+
+ \medskip
+ \DescribeMacro{\institute}
+ Sets the name of the institute the cafeteria is located at -- for example, you can insert \verb|\institute{University of LOL}| in your preamble if your cafeteria is located at some institute called the \enquote{University of LOL}. \\
+ Note that information about the institute is only printed when using the normal layout.
+
+ \medskip
+ \DescribeMacro{\setimage}
+ Add an image to your diet plans using this command. \\
+ Note that you \textit{have} to declare the image by using the \verb|\includegraphics| inside \verb|\setimage| (e.~g.~\verb|\setimage{\includegraphics[width=\linewidth]{path/to/picture}}|). \\
+ The space available for the image depends on the used layout (see table \ref{tab:image-sizes}).
+
+ \begin{table}[b]\centering\sffamily\small\renewcommand{\arraystretch}{1.25}
+ \begin{tabular}{r*{2}{|>{\centering\ttfamily}m{.25\textwidth}<{\arraybackslash}}}
+ & \textsf{normal layout} & app \textsf{layout} \tabularnewline\hline\hline
+ width & \verb|.50\textwidth| \newline $\approx$ \verb|9.0cm| & \verb|.58\textwidth| \newline $\approx$ \verb|4.9cm| \tabularnewline\hline
+ height & \verb|.15\textheight| \newline $\approx$ \verb|4.0cm| & \verb|.15\textheight| \newline $\approx$ \verb|1.9cm|
+ \end{tabular}
+
+ \rmfamily
+ \caption{Available space for the header image}
+ \label{tab:image-sizes}
+ \end{table}
+
+
+ \subsection{Adding food}
+ For adding information about the food, the commands described in this subsection are provided.
+
+ \medskip
+ \DescribeMacro{\startdate}
+ This commands defines the \enquote{start date}, the date of the first entry \textit{(the start date's weekday mostly happens to be a Monday)}. The start date has to be present in \textsf{YYYY-MM-DD} format, e.~g.~\verb|\startdate{2007-01-01}| \textit{(Default is 2001-01-01)}.
+
+ \medskip
+ \DescribeMacro{\monday}\DescribeMacro{\tuesday}\DescribeMacro{\wednesday}\DescribeMacro{\thursday}\DescribeMacro{\friday}
+ Use these five commands to insert food into the empty diet. \\
+ Every single command requires the same four arguments:
+ \begin{multicols}{4}
+ \begin{enumerate}\itemsep0pt
+ \item Menu I
+ \item Menu II
+ \item Dessert
+ \item Lunch
+ \end{enumerate}
+ \end{multicols}
+
+ For example, to obtain Monday's menu consisting of
+ \begin{multicols}{2}
+ \begin{tabbing}
+ \hspace{2cm}\=\kill
+ Menu I: \> Fish and chips \\
+ Menu II: \> Crispy fried chicken \\
+ Dessert: \> Chocolate fudge \\
+ Lunch: \> DIY hamburgers
+ \end{tabbing}
+ \end{multicols}
+ you have to write \\
+ \verb|\monday{Fish and chips}% <-- % is required when| \\\nopagebreak[4]
+ \verb| {Crispy fried chicken}% commands are continued| \\\nopagebreak[4]
+ \verb| {Chocolate fudge}% in the following line| \\\nopagebreak[4]
+ \verb| {DIY hamburgers}|
+
+ \smallskip
+ It is possible to insert the command listed above without line breaks, however, doing so will result in the source being less human--readable.
+
+ \smallskip
+ Due to the menu being implemented in a \texttt{tabular} environment, you have to use \verb|\linebreak| instead of \,\verb|\\|\, to produce additional lines. \\
+ Possible, additional hyphenations not found by \LaTeX\ can be marked by manually inserting discretionary hyphens (\verb|\-|) (e.~g.~\verb|hyphen\-ation|).
+
+
+ \subsection{Adding additional information}
+ \subsubsection{Remarks at the bottom of the page} \label{sec:remarks}
+ Some people may want to insert some remarks or annotations at the bottom of the page. \\
+ These remarks are defined using two commands, depending on the used layout.
+
+ \medskip
+ \DescribeMacro{\longremarks}
+ This command defines the remarks used for the normal layout. \\
+ They may be quite short (like \verb|\longremarks{Try it!}|) or very, very long.
+
+ \medskip
+ \DescribeMacro{\shortremarks}
+ This command defines the remarks used for the \texttt{app}--Layout \\
+ Maybe, you should reduce the font size by inserting arbitrary \LaTeX\ font size commands (e.~g.~\verb|\shortremarks{\footnotesize Now using a smaller font size}|)
+
+
+ \subsubsection{Remarks for additive ingredients}
+ When food contains additive ingredients, these additive ingredients are usually indicated by adding superscript figures. \\
+ You have to insert the legend manually by using remarks (see section \ref{sec:remarks}).
+
+ \medskip
+ \DescribeMacro{\sup}
+ This command is a shortcut providing access to the \verb|\textsuperscript| command. \\
+ It can be used to produce a superscript 4 with \verb|\sup{4}|.
+
+
+ \subsubsection{Symbols for vegetarian and vegan food}
+ Due to the recent development I decided to declare symbols for labeling vegetarian and vegan food. \\
+ However, you have to insert the legend manually by using remarks (see section \ref{sec:remarks}).
+
+ \medskip
+ \DescribeMacro{\vgt}
+ Produces a symbol consisting of one green leaf ({\color{green!50!black}\textleaf}) for labeling vegetarian food
+
+ \medskip
+ \DescribeMacro{\vgn}
+ Produces a symbol consisting of two green leaves ({\color{green!50!black}\textleaf\textleaf}) for labeling vegan food
+
+ \medskip
+ Since the leaf symbol is obtained by loading the \texttt{textcomp} package and using the \verb|{\rmfamily\textleaf}| command, please avoid packages loading another roman font not supporting this symbol. This should not be a big limitation since the class only uses sans--serif fonts. \\
+ Otherwise, \verb|\vgt| and \verb|\vgn| have to be redefined.
+
+
+ \subsection{Using fancy colors}
+ To avoid a very boring look of the menu, some parts can be highlighted by using colors. \\
+ The class defines three colors: one for the background of certain boxes, another one for the text inside these boxes and a third one for structure text.
+
+ \subsubsection{Changing colors}
+ Colors can be changed globally by using three commands. The colors themselves are described using the normal syntax of the \texttt{xcolor} package.
+
+ \medskip
+ \DescribeMacro{\setbgcolor}
+ Changes the background color of certain boxes (e.~g. \verb|\setbgcolor{blue}|)
+
+ \medskip
+ \DescribeMacro{\setcolorfg}
+ Changes the color of text inside these colored boxes (e.~g. \verb|\setcolorfg{white}|)
+
+ \medskip
+ \DescribeMacro{\setctextcolor}
+ Changes the color of structure text (e.~g. \verb|\setctextcolor{red}|)
+
+
+ \subsubsection{A short note about color selection}
+ Please ensure, that the colors set with \verb|\setbgcolor| and \verb|\setcolorfg| are distinctive enough from each other. \verb|\setbgcolor{black}| and \verb|\setcolorfg{black!85}| are usually a very, very bad choice when being used together. \\
+ Also, a clear difference between \verb|\setctextcolor| and the background of the sheet of paper is recommended.
+
+
+ \subsubsection{Using class--defined colors in normal text}
+ The colors defined with \verb|\setbgcolor|, \verb|\setcolorfg| and \verb|\setctextcolor| can be used with \verb|\color| and other color commands. \\
+ The corresponding defined colors are called \verb|\bgcolor|, \verb|\colorfg| and \verb|\ctextcolor|.
+
+ \medskip
+ Examples: \verb|\color{\bgcolor}|, \verb|\color{\colorfg}| and \verb|\color{\ctextcolor}|
+
+
+
+ \section{How to add support for other languages}
+ Currently, the class natively supports English (GB/US) and German. \\
+ However, with the instructions in this section, you are able to define additional localizations yourself. \\
+ It is recommended to select the localization closest to your localization by using the class options described in section \ref{sec:docclass} \textit{before} redefining commands (see the examples in table \ref{tab:locals-example}). \\
+ Code described in this section is to be placed \textit{before} the \verb|\begin{document}| command. \\
+ Only redefine commands when necessary.
+
+ % TODO: Table with example of pre-defined localizations
+ \begin{table}\centering\sffamily\renewcommand{\arraystretch}{1.25}
+ \begin{tabular}{r*{3}{|>{\centering}p{.2\textwidth}<{\arraybackslash}}}
+ & \texttt{en-GB} & \texttt{en-US} & \texttt{german} \tabularnewline \hline\hline
+ \verb|\menuname| & \multicolumn{2}{c|}{Menu} & Menü \tabularnewline \hline
+ \verb|\dessertname| & \multicolumn{2}{c|}{Dessert} & Dessert \tabularnewline \hline
+ \verb|\dinnername| & \multicolumn{2}{c|}{Dinner} & Abendessen \tabularnewline \hline
+ \verb|\dietname| & \multicolumn{2}{c|}{Weekly menu} & Speiseplan vom \tabularnewline \hline
+ \verb|\shortdate| & 18/09/17 & 09/18/17 & 18.09. \tabularnewline \hline
+ \verb|\dowshortdate| & Monday, 18/09/17 & Monday, 09/18/17 & Montag, 18.09.17 \tabularnewline \hline
+ \verb|\longdate| & 18/09/2017 & 09/18/2017 & 18.09.2017 \tabularnewline \hline
+ \verb|\daterange| & 18/09/17\,--\,22/09/17 & 09/18/17\,--\,09/22/17 & 18.09.\,--\,22.09.2017
+ \end{tabular}
+
+ \rmfamily
+ \caption{Examples for natively supported localizations}
+ \label{tab:locals-example}
+ \end{table}
+
+
+
+
+ \subsection{Weekday names}
+ Weekday names are stored in the \verb|\wdayname| and \verb|\swdayname| commands. \\
+ To modify them, copy the code printed below into your preamble and replace the English weekday names (and their abbreviations) with the appropriate form of your localization (but leave the \verb|%|s untouched)
+
+ \medskip
+ \verb|% Weekday names| \\
+ \verb|\renewcommand{\wdayname}[1]{%| \\
+ \verb| \ifcase\DTMfetchdow{#1}| \\
+ \verb| Monday%| \\
+ \verb| \or| \\
+ \verb| Tuesday%| \\
+ \verb| \or| \\
+ \verb| Wednesday%| \\
+ \verb| \or| \\
+ \verb| Thursday%| \\
+ \verb| \or| \\
+ \verb| Friday%| \\
+ \verb| \or| \\
+ \verb| Saturday%| \\
+ \verb| \or| \\
+ \verb| Sunday%| \\
+ \verb| \fi| \\
+ \verb|}|
+
+ \bigskip
+ \verb|% Short weekday names| \\
+ \verb|\renewcommand{\swdayname}[1]{%| \\
+ \verb| \ifcase\DTMfetchdow{#1}| \\
+ \verb| Mon%| \\
+ \verb| \or| \\
+ \verb| Tue%| \\
+ \verb| \or| \\
+ \verb| Wed%| \\
+ \verb| \or| \\
+ \verb| Thu%| \\
+ \verb| \or| \\
+ \verb| Fri%| \\
+ \verb| \or| \\
+ \verb| Sat%| \\
+ \verb| \or| \\
+ \verb| Sun%| \\
+ \verb| \fi| \\
+ \verb|}|
+
+
+ \subsection{Keywords}
+ There are four keywords stored in separate commands. \\
+ To modify them, copy the code printed below into your preamble and replace the English words by vocabulary appropriate for your localization.
+
+ \medskip
+ \verb|\def\menuname{Menu}| \\
+ \verb|\def\dessertname{Dessert}| \\
+ \verb|\def\dinnername{Dinner}| \\
+ \verb|\def\dietname{Weekly menu}|
+
+
+ \subsection{Date formats}
+ This part is probably the most complicated one when defining own localizations. \\
+ Basically, there are four commands that may be redefined:
+ \begin{itemize}
+ \item \verb|\shortdate| \\
+ The short form of the date (e.~g. 10/11)
+
+ \item \verb|\dowshortdate| \\
+ The short form of the date, including the weekday (e.~g. Sat., 10/11)
+
+ \item \verb|\longdate| \\
+ The long form of the date (e.~g. 10/11/2012)
+
+ \item \verb|\daterange| \\
+ A range between two dates (e.~g. 10/11--14/11/2012)
+ \end{itemize}
+
+ \medskip
+ When redefining these commands, you have to assemble the templates available for day, month and year in an order matching the localization.
+
+ \subsubsection*{Date templates}
+ \begin{itemize}
+ \item[\sffamily\bfseries DD]
+ \verb|\DTMtwodigits{\DTMfetchday{#1}}| \\
+ Prints the day using two digits \\
+ If the day consists of only one digit, a zero is inserted (e.~g. 01 instead of 1)
+
+ \item[\sffamily\bfseries D]
+ \verb|\DTMfetchday{#1}| \\
+ Prints the day using one or two digits
+ \end{itemize}
+
+ \subsubsection*{Month templates}
+ \begin{itemize}
+ \item[\sffamily\bfseries MM]
+ \verb|\DTMtwodigits{\DTMfetchmonth{#1}}| \\
+ Prints the month using two digits
+
+ \item[\sffamily\bfseries M]
+ \verb|\DTMfetchmonth{#1}| \\
+ Prints the month using one or two digits
+ \end{itemize}
+
+ \subsubsection*{Year templates}
+ \begin{itemize}
+ \item[\sffamily\bfseries YYYY]
+ \verb|\DTMfetchyear{#1}| \\
+ Prints the year using as many digits as required
+
+ \item[\sffamily\bfseries YY]
+ \verb|\DTMtwodigits{\DTMfetchyear{#1}}| \\
+ Prints the year using two digits
+ \end{itemize}
+
+ \subsubsection*{Inserting weekday names}
+ \begin{tabular}{>{\sffamily\bfseries}rl}
+ \enquote{normal} weekday names: & \verb|\wdayname{#1}| \\
+ short weekday names: & \verb|\swdayname{#1}|
+ \end{tabular}
+
+ \subsubsection*{Redefining commands using templates}
+ Now, you only have to redefine the commands. Use the following basic structure: \\
+ \verb|\renewcommand{ %% COMMAND %% }[1]{%| \\
+ \verb| %% INSERT THE TEMPLATE COMBINATIONS HERE %%| \\
+ \verb|}|
+
+ \bigskip
+ The templates listed above can be combined suitable. \\
+ For example, if you want the long date to be displayed in the \textsf{YYYY-MM-DD} format, the following code does the trick: \\
+ \verb|\renewcommand{\longdate}[1]{%| \\\nopagebreak[4]
+ \verb| \DTMfetchyear{#1}% The YYYY template| \\\nopagebreak[4]
+ \verb| -% Year/month separator| \\\nopagebreak[4]
+ \verb| \DTMtwodigits{\DTMfetchmonth{#1}}% The MM template| \\\nopagebreak[4]
+ \verb| -% Month/day separator| \\\nopagebreak[4]
+ \verb| \DTMtwodigits{\DTMfetchday{#1}}% The DD template| \\\nopagebreak[4]
+ \verb|}| \pagebreak[0]
+
+ \medskip
+ The same principle applies to redefinitions of \verb|\shortdate| and \verb|\dowshortdate|. \\
+ The \verb|%|s avoid spaces after templates and separators when inserting line breaks.
+
+ \medskip
+ If you have already redefined \verb|\shortdate| and \verb|\longdate|, you may reuse these definitions when redefining \verb|\dowshortdate|, for example: \\
+ \verb|\renewcommand{\dowshortdate}[1]{%| \\\nopagebreak[4]
+ \verb| \wdayname{#1}% Insert the weekday| \\\nopagebreak[4]
+ \verb| ,~% Weekday/day seperator (~ = space)| \\\nopagebreak[4]
+ \verb| \shortdate{#1}% Use the short day template| \\\nopagebreak[4]
+ \verb|}| \pagebreak[0]
+
+ \bigskip
+ \textit{Redefining the} \verb|\daterange| \textit{command is special} since it requires two arguments. \\
+ Here, you have to use \dots
+ \begin{itemize}
+ \item
+ {\ttfamily\#1} for commands and templates referring to the start date and
+
+ \item
+ {\ttfamily\#2} for commands and templates referring to the end date
+ \end{itemize}
+
+ For example, a working redefinition of \verb|\daterange| can be achieved with this code: \\
+ \verb|\renewcommand{\daterange}[2]{% <-- »[2]« instead of »[1]«!!| \\\nopagebreak[4]
+ \verb| \shortdate{#1}% Start date| \\\nopagebreak[4]
+ \verb| \,--\,% Seperator: -- with spaces| \\\nopagebreak[4]
+ \verb| \shortdate{#2}% End date: #2 inst. of #1| \\\nopagebreak[4]
+ \verb|}|
+
+
+
+ \section{A working example}
+ \verb|\documentclass[en-US]{mensa-tex}| \\
+
+ \verb|\usepackage[american]{babel}| \\
+ \verb|\usepackage[utf8]{inputenc}| \\
+
+ \verb|\setbgcolor{blue}| \\
+ \verb|\setcolorfg{white}| \\
+ \verb|\setctextcolor{red}| \\
+
+
+
+ \verb|\institute{Some university far, far away}| \\
+ \verb|\mensaname{Café}| \\
+
+ \verb|\setimage{\includegraphics[width=.95\linewidth]{cafe-logo}}| \\[\bigskipamount]
+
+
+ \verb|\startdate{2017-09-18}| \\
+
+ \verb|\monday{Scrambled Eggs \linebreak\vgt}%| \\
+ \verb| {Curry Potato Salad with Peas, Mint \& Red Onion \linebreak\vgn}%| \\
+ \verb| {Ice Cream}%| \\
+ \verb| {Turkey Burger}| \\
+
+ \verb|\tuesday{Philly Cheese Steak\sup{1)}}%| \\
+ \verb| {Sesame Noodles \linebreak\vgn}%| \\
+ \verb| {Donuts}%| \\
+ \verb| {Orzo Pasta}| \\
+
+ \verb|\wednesday{-/-}{-/-}{-/-}{-/-}| \\
+
+ \verb|\thursday{Buffalo Wings}%| \\
+ \verb| {Vegetarian Eggrolls \linebreak\vgt}%| \\
+ \verb| {Sacher Cake}%| \\
+ \verb| {Chicken Tortilla}| \\
+
+ \verb|\friday{Pastrami Melt}%| \\
+ \verb| {Grilled Cheese \linebreak\vgt}%| \\
+ \verb| {Tiramisu}%| \\
+ \verb| {Salmon Burger}| \\[\bigskipamount]
+
+ \verb|\longremarks{%| \\
+ \verb| {\color{\ctextcolor}| \\
+ \verb| Due to a training course of our staff, the café is closed| \\
+ \verb| on Wednesday, 09/20/17.}| \\
+
+ \verb| \medskip| \\
+ \verb| In our efforts to sustain a seasonal menu, sometimes| \\
+ \verb| substitutions may be required, and menu items may change| \\
+ \verb| without notice.| \\
+
+ \verb| \bigskip| \\
+ \verb| \textbf{Key:} \quad| \\
+ \verb| \vgt: vegetarian \quad| \\
+ \verb| \vgn: vegan \quad| \\
+ \verb| \sup{1)}: spicy| \\
+ \verb|}| \\
+
+ \verb|\begin{document}| \\
+ \verb|\end{document}|
+\end{document} \ No newline at end of file