diff options
author | Karl Berry <karl@freefriends.org> | 2025-01-09 21:08:09 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2025-01-09 21:08:09 +0000 |
commit | 9e3297dfd4d38694ab697c882fe5afd4ddf0108a (patch) | |
tree | 7bece125eed1381a09d891ab646b5e4e40d84467 /Master/texmf-dist/doc/latex/tikzquests | |
parent | 686a07c59345adf4648c18c9a62f924e0de3e017 (diff) |
tikzquests (9jan25)
git-svn-id: svn://tug.org/texlive/trunk@73386 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/tikzquests')
-rw-r--r-- | Master/texmf-dist/doc/latex/tikzquests/README.md | 5 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tikzquests/tikzquests.pdf | bin | 356126 -> 358179 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/tikzquests/tikzquests.tex | 18 |
3 files changed, 18 insertions, 5 deletions
diff --git a/Master/texmf-dist/doc/latex/tikzquests/README.md b/Master/texmf-dist/doc/latex/tikzquests/README.md index c15ca5ed940..6680b8fbf90 100644 --- a/Master/texmf-dist/doc/latex/tikzquests/README.md +++ b/Master/texmf-dist/doc/latex/tikzquests/README.md @@ -67,7 +67,10 @@ The Current Maintainer of this work is Alceu Frigeri - documentation in PDF format ------------- -* Version 1.1 (this) +* Version 1.2 (this) + - Added the concept of 'sub-repositories' (relevant when listing the questions of a repository). see documentation. + +* Version 1.1 - Documentation typos, and issue #1. * Version 1.0 diff --git a/Master/texmf-dist/doc/latex/tikzquests/tikzquests.pdf b/Master/texmf-dist/doc/latex/tikzquests/tikzquests.pdf Binary files differindex 6890e18507b..98085f15604 100644 --- a/Master/texmf-dist/doc/latex/tikzquests/tikzquests.pdf +++ b/Master/texmf-dist/doc/latex/tikzquests/tikzquests.pdf diff --git a/Master/texmf-dist/doc/latex/tikzquests/tikzquests.tex b/Master/texmf-dist/doc/latex/tikzquests/tikzquests.tex index 50d40b5adc3..cf067a83ab1 100644 --- a/Master/texmf-dist/doc/latex/tikzquests/tikzquests.tex +++ b/Master/texmf-dist/doc/latex/tikzquests/tikzquests.tex @@ -15,7 +15,7 @@ %% %% The Current Maintainer of this work is Alceu Frigeri %% -%% This is version {1.1} {2024/01/11} +%% This is version {1.2} {2025/01/09} %% %% The list of files that compose this work can be found in the README.md file at %% https://ctan.org/pkg/tikzquests @@ -47,7 +47,7 @@ This is a framework for building parametric questions' repositories, which can b \tableofcontents \section{Introduction} -One recurring problem when typesetting exams, specially in Engineering fields, is the need to have parameterized questions, specially parameterized schematics used in exam's questions. The intent of this is to allow the creation of repositories (one or more) with 'easily' parameterized text and/or graphic (\tsobj[pkg]{tikz}) questions, but not enforcing any style/format whatsoever, leaving it to the end user. +One recurring problem when typesetting exams, specially in Engineering fields, is the need to have parameterized questions, specially parameterized schematics used in exam's questions. The intent of this is to allow the creation of such repositories (one or more) with 'easily' parameterized text and/or graphic (\tsobj[pkg]{tikz}) questions, without enforcing any style/format whatsoever, leaving it to the end user. The package offers \begin{itemize} @@ -76,6 +76,8 @@ Questions are stored in a set of repositories. Per default there is one such rep \end{codesyntax} \tsobj{\defNewRepository} creates a new Repository, \tsobj[marg]{new-repository}. The starred version also switches to it, making it the ``current default''. \tsobj{\SelectRepository} activates \tsobj[marg]{repository} as the ``current default'' one. + +It is possible to construct a tree of related repositories by using a slash, ``/'', like ``repoA'', ``repoA/subA'', ``repoA/subB'', ``repoA/subC'', which can be handy when listing the questions of a repository, see \ref{quest list}. \end{codedescribe} \begin{tsremark} @@ -83,6 +85,11 @@ About repository's names: It can be almost anything, the name can contain string \end{tsremark} \begin{tsremark} +Do not create a repository with an ending slash, like ``repoName/''. Given the way sub-repositories are define, it will render impossible to list this repository questions, see \ref{quest list} +\end{tsremark} + + +\begin{tsremark} When creating a new repository, a warning is raised in case \tsobj[marg]{new-repository} already exists. When Selecting a repository, an error is raised if \tsobj[marg]{repository} doesn't exists. \end{tsremark} @@ -149,7 +156,7 @@ The \tsobj{\textQuestion} will just use the code in a local group. The \tsobj[oa An error is raised if \tsobj[marg]{repository} or \tsobj[marg]{quest-name} doesn't exist. \end{tsremark} -\begin{codedescribe}{\QuestionsList} +\begin{codedescribe}{\QuestionsList}\label{quest list} \begin{codesyntax}% \tsmacro{\QuestionsList}[repositories list]{} \end{codesyntax} @@ -157,9 +164,12 @@ An error is raised if \tsobj[marg]{repository} or \tsobj[marg]{quest-name} doesn \end{codedescribe} \begin{tsremark} -An error is raised if a repository in \tsobj[marg]{repositories list} doesn't exist. To reduce the clutter (and number of questions listed) one should consider the use of the option \tsobj[option]{no alias}. +If a \tsobj[oarg]{repositories list}'s term finishes with a slash, ``/'', it will be treated as a family of repositories and all sub-repositories will be listed too. \end{tsremark} +\begin{tsremark} +An error is raised if a repository in \tsobj[marg]{repositories list} doesn't exist. To reduce the clutter (and number of questions listed) one should consider the use of the option \tsobj[option]{no alias}. +\end{tsremark} \section{Parameters as pgfkeys and auxiliary macros.}\label{parameters} |