From 0ab50bc3d1ddb30ac5f4a9ba8d147e8c2f834d65 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 3 May 2018 16:47:20 +0000 Subject: handin (11apr18) git-svn-id: svn://tug.org/texlive/trunk@47590 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/handin/README.txt | 2 +- Master/texmf-dist/doc/latex/handin/example.pdf | Bin 2137263 -> 2195153 bytes Master/texmf-dist/doc/latex/handin/handin-doc.pdf | Bin 126861 -> 161967 bytes Master/texmf-dist/doc/latex/handin/handin-doc.tex | 124 ++++++++++++++++++---- Master/texmf-dist/doc/latex/handin/layout.pdf | Bin 63859 -> 111833 bytes 5 files changed, 105 insertions(+), 21 deletions(-) (limited to 'Master/texmf-dist/doc/latex/handin') diff --git a/Master/texmf-dist/doc/latex/handin/README.txt b/Master/texmf-dist/doc/latex/handin/README.txt index f3ec0ee45ec..18f66e96245 100644 --- a/Master/texmf-dist/doc/latex/handin/README.txt +++ b/Master/texmf-dist/doc/latex/handin/README.txt @@ -17,7 +17,7 @@ https://github.com/Strauman/Handin-LaTeX-template/ Licence: -The LaTeX package handin - version v0.0.3 (2018/04/04) build 41 +The LaTeX package handin - version v0.1.0 (2018/04/10) build 47 handin.sty ------------------------------------------------------------------------------------------- Copyright (c) 2018 by Andreas Storvik Strauman diff --git a/Master/texmf-dist/doc/latex/handin/example.pdf b/Master/texmf-dist/doc/latex/handin/example.pdf index 1e60b785da0..94a8ccc766a 100644 Binary files a/Master/texmf-dist/doc/latex/handin/example.pdf and b/Master/texmf-dist/doc/latex/handin/example.pdf differ diff --git a/Master/texmf-dist/doc/latex/handin/handin-doc.pdf b/Master/texmf-dist/doc/latex/handin/handin-doc.pdf index 6945e5a6824..6cb13c74ced 100644 Binary files a/Master/texmf-dist/doc/latex/handin/handin-doc.pdf and b/Master/texmf-dist/doc/latex/handin/handin-doc.pdf differ diff --git a/Master/texmf-dist/doc/latex/handin/handin-doc.tex b/Master/texmf-dist/doc/latex/handin/handin-doc.tex index 557a5d290d0..0e6348c5152 100644 --- a/Master/texmf-dist/doc/latex/handin/handin-doc.tex +++ b/Master/texmf-dist/doc/latex/handin/handin-doc.tex @@ -1,5 +1,5 @@ -%% handin v0.0.3b41 - 2018/04/04 -%% The LaTeX package handin - version v0.0.3 (2018/04/04) build 41 +%% handin v0.1.0b47 - 2018/04/10 +%% The LaTeX package handin - version v0.1.0 (2018/04/10) build 47 %% #PACKAGE.sty %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2018 by Andreas Storvik Strauman @@ -24,7 +24,7 @@ moretexcs={arrayrulecolor,draw,includegraphics,ifthenelse,isodd,lipsum,path,pgfkeysalso}, classoffset=1, moretexcs={% core - problem,pproblem,title,author,logo,coursename,coursetitle,institute,containspages,pagetext,settable + problem,pproblem,title,author,logo,coursename,coursetitle,institute,containspages,pagetext,settable,handinsetup,currentProblem,currentPartProblem,currentProblemIfNewPage }, texcsstyle=*\color{Definition}\bfseries, classoffset=0,% restore default @@ -43,6 +43,7 @@ drop fuzzy shadow,#1} \makeatother \let\dac\docAuxCommand +\long\def\keyDef#1#2#3#4{\begin{docKey}{#1}{=\meta{#2}}{\meta{default}=#3}#4\end{docKey}} \tcbset{documentation listing style=mydocumentation} % Magenta HREF style \let\oldhref\href @@ -55,7 +56,7 @@ \setlength{\parindent}{0pt} -\title{{Handin - manual\\ v0.0.3{\\[-0.5em]\footnotesize(build 41)}}} +\title{{handin - manual\\ v0.1.0{\\[-0.5em]\footnotesize(build 47)}}} \author{Andreas Strauman} \begin{document} \maketitle @@ -66,15 +67,69 @@ This is a package that makes it easy for student to hand in a formatted document If you are a teacher, this package works just as well for creating exercises!\\ -If you found any bugs or want new functionality, to contribute, view the commented source, get latest version of this package or get in touch with me, you can do all of that at \url{https://github.com/Strauman/Handin-LaTeX-template/} +If you found any bugs or want new functionality, to contribute, view the commented source, get latest version of this package or get in touch with me, you can do all of that at \url{https://github.com/Strauman/Handin-LaTeX-template/}. If you have questions of functionality, kindly direct them to the community\\ \url{http://tex.stackexchange.com}. The author is active on this site regularly. + \tableofcontents \clearpage \section{Reference} +\subsection{Making exercises} +Here are commands related to creating exercises +\begin{docCommand}{problem}{\marg{text}} + This command will print out a problem header. For example \dac{problem}\{1\} + prints a nice big header \textbf{Problem 1} You can do a star (*) after \dac{problem} to + prevent it from showing in the table of contents +\end{docCommand} +\begin{docCommand}{problem*}{\marg{text}} + Does the same as \dac{problem}, but does not add the problem to the table of contents +\end{docCommand} +\begin{docCommand}{pproblem}{\marg{text}} + This command will print out a part problem header based on what problem you are on. + For example if you already have done \dac{problem}\{1\}, then \dac{pproblem}\{a\} + prints a nice big header \textbf{(1a)}. Note that the default behaviour is such that if you are on a + new page, then the part problems are shown with the exercise number in front of it. If not + it is omitted. If you want to change this behaviour, see \dac{keyRef}\{part problem header\} +\end{docCommand} +\begin{docCommand}{pproblem*}{\marg{text}} + Does the same as \dac{pproblem}, but does not add the part problem to the table of contents +\end{docCommand} +\subsection{Package options (\dac{handinsetup})} + You can do configurations on this package, and probably + even more to come in later versions! +\begin{docCommand}{handinsetup}{\marg{[key/values]}} + Here is a list of the different keys and their meaning +\end{docCommand} +\keyDef{problem header}{macro}{\dac{@tr}\{Problem\}~\dac{currentProblem}}{ +This options contains the formatting of the problem header. Use \dac{currentProblem} to access the number of the current exercise, and \dac{@tr}\{Problem\} to access the translation of Problem.\\ +Defaults to \dac{@tr}\{Problem\}~\dac{currentProblem} +} +\keyDef{part problem header}{macro}{See below}{ + This defaults to: \dac{currentProblemIfNewPage}\dac{currentPartProblem}). + See \refCom{currentProblemIfNewPage} and \refCom{currentPartProblem} +} +\keyDef{problem TOC}{macro}{\meta{contents of problem header}}{ + This key decides what is written to the table of contents. It defaults to extract the content in \refKey{problem header} +} +\keyDef{part problem TOC}{macro}{\meta{contents of part problem header}}{ + This key decides what is written to the table of contents. It defaults to \dac{currentPartProblem} + (which is what the user last sent to \dac{pproblem}). +} +\keyDef{logo width}{number}{0.4}{ + Give as factor (between 0 and 1) of total text width. + This is a temporary fix for logo not being customisable, and is scheduled to be updated in a later version. +} +\keyDef{title style}{wholepage or small}{wholepage}{ +If "wholepage", \dac{maketitle} will produce a full front-page. If "small", \dac{maketitle} will produce a smaller title containing the course name, course title, title, and author. +} + \subsubsection*{Example} If you don't want to have the exercise number ever in front of the letter, then you'd do +\begin{dispListing} + \handinsetup{part problem header=\currentPartProblem} +\end{dispListing} \subsection{Page formatting commands} This package redefines \dac{maketitle}. Here are some front-page commands. See layout.pdf for where they will appear. These commands all have to be executed in the preamble (that is after \dac{documentclass} and before \dac{begin}\{document\})\\ -The \dac{title} and \dac{author} commands are as per usual: +The \dac{title} and \dac{author} commands are as per usual, +but are made lasting (not cleared by \dac{maketitle}) with \dac{thetitle} and \dac{theauthor} for use in headers and footers \begin{docCommand}{title}{\marg{title}} \end{docCommand} \begin{docCommand}{author}{\marg{your name}} @@ -113,22 +168,36 @@ The current language is set by the \texttt{iflang} package, so you can use e.g. \usepackage[german]{babel} \end{dispListing} \subsection{General reference} -\begin{docCommand}{problem}{\marg{text}} - This command will print out a problem header. For example \dac{problem}\{1\} - prints a nice big header \textbf{Problem 1} You can do a star (*) after \dac{problem} to - prevent it from showing in the table of contents -\end{docCommand} -\begin{docCommand}{problem}{} - Does the same as \dac{problem}, but does not add the problem to the table of contents +\begin{docCommand}{currentProblem}{} +Contains the argument of the last call to \dac{problem} +\begin{dispListing} +\pproblem{hello} +\pproblem{world} +\currentPartProblem %<- contains world +\end{dispListing} \end{docCommand} -\begin{docCommand}{pproblem}{\marg{text}} - This command will print out a part problem header based on what problem you are on. - For example if you already have done \dac{problem}\{1\}, then \dac{pproblem}\{a\} - prints a nice big header \textbf{(1a)}. You can do a star (*) after \dac{pproblem} to - prevent it from showing in the table of contents +\begin{docCommand}{currentPartProblem}{} + Just as \refCom{currentProblem}, but contains the argument of the last call to \dac{pproblem} \end{docCommand} -\begin{docCommand}{pproblem}{} - Does the same as \dac{pproblem}, but does not add the part problem to the table of contents +\begin{docCommand}{currentProblemIfNewPage}{} +If the problem is not defined on the current page, then +The first time \dac{currentProblemIfNewPage} is called on a page, +it expands to the current problem number. If not, it expands to empty. +If the problem is defined on the current page, it also expands to empty. + This is used in the default key for the \dac{keyRef}\{part problem header\}. + Here are some examples +\begin{dispListing} +\problem{1} +\currentProblemIfNewPage % <- empty +\end{dispListing} + + +\begin{dispListing} +\problem{4} +\clearpage +\currentProblemIfNewPage % <- expands to 4 +\currentProblemIfNewPage % <- expands to empty +\end{dispListing} \end{docCommand} \begin{docCommand}{settable}{\marg{text}} \begin{dispListing} @@ -157,5 +226,20 @@ The current language is set by the \texttt{iflang} package, so you can use e.g. v0.0.3b41&2018/04/04&\begin{itemize} \item German language added by africola \newline (\url{https://github.com/africola}) \end{itemize}\\ + v0.0.4&2018/04/06&\begin{itemize} + \item Made proper margins for problem headers and part problem headers + \item Added \texttt{microtype} and Latin Modern font (\texttt{cfr-lm})\newline + Contributed by:\newline + \href{https://github.com/koppor}{koppor} (\url{https://github.com/koppor}) + \end{itemize}\\ + v0.1.0&2018/04/10&\begin{itemize} + \item Introduced package options + \item New slick, minimalistic, front page by \href{https://github.com/DanielTrosten/}{DanielTrosten} + \item Added support for \dac{thetitle} and \dac{theauthor} by \href{https://github.com/MadsAdrian/}{MadsAdrian} + \item Footer bar by default by \href{https://github.com/MadsAdrian/}{MadsAdrian} + \item New part problem counting features + \item Misc fixes of margin bugs + \item Better file structuring on page style by \href{https://github.com/MadsAdrian/}{MadsAdrian} + \end{itemize}\\ \end{tabularx} \end{document} diff --git a/Master/texmf-dist/doc/latex/handin/layout.pdf b/Master/texmf-dist/doc/latex/handin/layout.pdf index 2231225d5a8..dfa20382e25 100644 Binary files a/Master/texmf-dist/doc/latex/handin/layout.pdf and b/Master/texmf-dist/doc/latex/handin/layout.pdf differ -- cgit v1.2.3