annotate README @ 8:24d547e7ea09

Add README
author Andre Heinecke <andre.heinecke@intevation.de>
date Tue, 22 Mar 2016 15:22:44 +0100 (2016-03-22)
parents
children b574990e90a5
rev   line source
8
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
1 ClickerConvert
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
2 ==============
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
3
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
4 Copyright (C) 2016 by ETH Zürich
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
5 Software engineering by Intevation GmbH
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
6
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
7 This file is Free Software under the GNU GPL (v>=2)
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
8 and comes with ABSOLUTELY NO WARRANTY!
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
9 See LICENSE.txt for details.
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
10
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
11
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
12 Introduction
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
13 ------------
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
14
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
15 Clicker convert converts the text output of a classromm response system
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
16 ("clicker") to other doucment formats. Currently only xlsx is supported.
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
17
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
18 The orignal target platforms are Windows NT > 6.1 (Seven and later) and
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
19 GNU/Linux and MacOS.
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
20
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
21 Input File Format
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
22 -----------------
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
23 The input file is a text document with the following expected properties:
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
24
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
25 Questions:
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
26 - A Question is defined by last unquoted string before a line starting
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
27 with "Answer"
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
28 - A multiple choice Answer are all strings that match the pattern
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
29 "\"(.*)\",(\\d+),(\\d+\\.\\d+)" in all lines following a line
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
30 "Answer,Votes,Percent" before the next Question.
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
31 - A free text answer is a Quoted string following a Question and
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
32 the single line "Answer".
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
33 All text before the next question is interpreted as free text responses.
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
34 If a Quoted string is inside an Answer it is combined with that Answer.
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
35
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
36 See constants.h for definition.
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
37
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
38 Usage
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
39 -----
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
40
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
41 See clickerconvert --help
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
42
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
43 Installation
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
44 ------------
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
45 See the file INSTALL for build instructions.
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
46
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
47 Binaries may be available on the project homepage.
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
48
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
49
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
50 Documentation
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
51 -------------
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
52 The documentation is written as part of Doxygen comments.
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
53
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
54 Contact
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
55 -------
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
56 For additional information or custom modifications please contact:
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
57
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
58 Intevation GmbH <intevation@intevation.de>
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
59 Neuer Graben 17
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
60 49074 Osnabrück, Germany
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
61
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
62 The public development platform can be found at:
24d547e7ea09 Add README
Andre Heinecke <andre.heinecke@intevation.de>
parents:
diff changeset
63 https://wald.intevation.org/projects/clickerconvert/
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)