Setting up a SDAPS Project
Once we are happy with the questionnaire, we can create the survey directory that SDAPS uses to store all the data that belongs to the project.
This is the first time that we need to run an SDAPS command. The syntax for the command is generally the following:
$ sdaps COMMAND PROJECT_DIR [arguments]
Where PROJECT_DIR is the directory for the survey, and command is the
SDAPS command that is executed. Most commands will require some arguments.
You can always get a help by running:
$ sdaps COMMAND PROJECT_DIR --help
So we create the project using the provided example.tex. The tutorial
assumes that the LaTeX file is in the current directory.
$ sdaps setup tex /tmp/project example.tex
------------------------------------------------------------------------------
- SDAPS -- setup_tex
------------------------------------------------------------------------------
Running pdflatex now twice to generate the questionnaire.
This is pdfTeX, Version 3.1415926-2.4-1.40.13 (TeX Live 2012/Debian)
restricted \write18 enabled.
entering extended mode
This is pdfTeX, Version 3.1415926-2.4-1.40.13 (TeX Live 2012/Debian)
restricted \write18 enabled.
entering extended mode
Running pdflatex now twice to generate the questionnaire.
This is pdfTeX, Version 3.1415926-2.4-1.40.13 (TeX Live 2012/Debian)
restricted \write18 enabled.
entering extended mode
This is pdfTeX, Version 3.1415926-2.4-1.40.13 (TeX Live 2012/Debian)
restricted \write18 enabled.
entering extended mode
The Title
Date: 10.03.2013
Author: The Author
Questionnaire
1(Head) Range Questions
1.1(Mark) How often do you use SDAPS? {1}
never - daily
0(Checkbox) 87.8 78.4 3.5 3.5
[SNIP]
Now, what does the output tell us? First the document is compiled four times. After the first two compiles SDAPS reads all the metadata and calculates the “Survey-ID” using the box positions and sizes and some other metadata. After that, the document is recompiled again using the correct “Survey-ID”.
The rest of the output is a textual representation of the questionnaire. We can ignore it, especially because the “annotate” command creates a much nicer view of everything.
Overview
The following topics are covered: