sdapslayout package¶
This package provides a set of more complex layouting options on top of the sdapsarray package. The following environments are provided:
The rangearray is not quite as powerful, as it does not expose some of the sdapsarray options to the user. Note that much more complex custom layouts can be created directly with sdapsarray.
Warning
The documentation here is currently incomplete! Pleases refer to the sdapsclassic choicegroup
and markgroup
documentation!
-
\begin{choicearray} [kwargs]
\end{choicearray}¶ The following optional keyword parameters can be passed to the environment. These keyword parameters default to the values provided in the SDAPS context and can for example be modified globally for the document.
- Keyword Arguments
align – named alignment group, set to a common name to align multiple environments to each other
noalign – disable alignment (same as setting
align
to an empty value)horizontal – set horizontal mode where each question is one row (default)
layouter – set the sdapsarray layouter (e.g. rotated for rotated column headers)
angle – set the angle of the column headers when in rotated mode
vertical – set vertical mode where each question is one column
type – the question type “multichoice” or “singlechoice”
multichoice – switch to multichoice “Choice” question mode
singlechoice – switch to singlechoice “Option” question mode
The choicearray environment represents a tabular layout for a set of multiple choice questions which have the same possible answers. A new header is created in the metadata to group the questions.
Warning
The header is currently not shown in the PDF and it cannot contain fragile content due to implementation constraints! This is an issue with the class which will be fixed. The exact final behaviour is not yet specified.
\begin{choicearray}[layouter=rotated] \choice{Choice 1} \choice{Choice 2} \question{Question one} \question{Question two} \end{choicearray}
Example of a choicearray environment
\begin{choicearray}[layouter=rotated,vertical] \choice{Choice 1} \choice{Choice 2} \question{Question one} \question{Question two} \end{choicearray}
Example of a vertical choicearray environment
Todo
Right now all arguments can be overriden, this should not be the case. It would be correct if the variable name is loaded from the kwargs, and then the defaults for align and horizontal/vertical should be applied
Inside the environment you need to first define all possible answers with choice macro and each question using the question macro.
-
\begin{optionarray} [kwargs]
\end{optionarray}¶ Identical to
choicearray
with the singlechoice keyword arguemnt set by default.
-
\begin{rangearray} [kwargs]
\end{rangearray}¶ - Keyword Arguments
align – named alignment group, set to a common name to align multiple environments to each other
count – the number of choices in the scale (default: 5)
other – whether to show an alternative answer outside of the scale
layouter – set the sdapsarray layouter (unlikely to be useful in this case)
The rangearray environment is used for a scale with lower/upper labels plus optionally a further checkmark outside of the range.
Each question is added using the
\range
macro.- \range [kwargs] {question} {lower} {upper} {other}¶
- Arguments
question – The question text.
lower – The text for the lower end label.
upper – The text for the upper end label.
upper – The text for the alternative choice (only valid if other is passed to the environmet.
- Keyword Arguments
var – Variable name for this question (to be appended to context).
text – A replacement text for the metadata, if set fragile content is permitted inside the text argument.
upper – A replacement text for the metadata, if set fragile content is permitted inside the upper argument.
lower – A replacement text for the metadata, if set fragile content is permitted inside the lower argument.
other – A replacement text for the metadata, if set fragile content is permitted inside the other argument.
\begin{rangearray}[count=7,other] \range{Question one}{lower}{upper}{other} \range{Question two}{bad}{good}{unsure} \end{rangearray} \begin{rangearray} \range{Question three}{lower}{upper} \range{Question four}{bad}{good} \end{rangearray}
Example of a rangearray environment