Strauman / exercisebank

A package for creating and managing exercise sets in LaTeX.
https://ctan.org/pkg/exercisebank
10 stars 3 forks source link
ctan exams latex latex-package

Exercisebank Gitter Build Status

Develop build status: Build Status

Check out the bleeding edge version in the releases section. Any testing help is appreciated!

Updated documentation

The latest release is stored in this zip: exercisebank.zip You can download the latest documentation here: release/exercisebank.pdf. This is the documentation for version 0.3.0, and might not be the same as for the one on CTAN. If you're using the CTAN version (if you didn't get the package from this repo) then use the CTAN documentation

Versions

Download latest(/github)-version here: exercisebank.zip GitHub at version: 0.3.0 (2019/03/18) build 137

CTAN at version: v0.3.0 (2019/03/18) build 137

It might take up to 24 hours from CTAN version is uploaded until you can download it, and then even a few more days until it is updated at TeXLive and MiKTeX

A build has no major changes in the core code (could be changes in documentation, or cosmetic changes in the code). Every time a minor version (that is the middle version number) changes, an upload is made to CTAN. If the patch version change (the last version number) is significant, it will also be uploaded to CTAN. The build number (ideally) never resets.

Contributing

Files

Check out documentation-doc.tex for instructions on how to document the code. All the documentation is automatically generated from the comments in the code using a custom perl-script. This file shows examples on how to document the code so that it shows up in the documentation properly. All of the code are distributed within the src-folder. Here is an overview. The src/packaging/ directory only contains info for building the package, but used for "compiling" it down to exercisebank.sty and documenting.

src/:

See how the tests/sanitycheck/main.tex is made, and you can make similar structures. Exercises are located in tests/exercises. You can read more on how the tests would work here. The best would be if you could clone this git, change stuff and make pull requests to this github with your tests. (Then the tests would actually be run!).

Also: If you have docker installed and are on OS X or Linux, you can use ./runtests.sh to run the tests locally on your computer.