AKFQuiz

Homepage:
http://akfquiz.nongnu.org/


INSTALLATION

With binary packages:

You need the main package and the package with the binaries for your 
system. 

For example:
akfquiz-4.2.1.main.tar.gz
akfquiz-4.2.1.bin.Linux.x86.tar.gz

Unpack them in the same directory. Go into the newly created directory
"akfquiz/srcbin/" and play around with the binaries there.

To install everything, go into the directory "akfquiz/" and run 
"./configure" and have a look at the settings it shows. If you don't 
like the settings, use the parameters for configure, as described below.
Then become root, go into the directory "akfquiz/" and type 
"make install". 


INSTALLING THE CGI PROGRAM

You should make sure, that the CGI directory is configured correctly. 
Use the parameter "--cgidir=" with the command "./configure".
Then type "make install-cgi". 

Then have a look at the privileges of the exam directory (normally that 
is /var/lib/akfquiz/). The directory should be readable and writable 
by the web server. A web server normally runs with special user and 
group privileges. For example the user and the group may be called 
"www-data" or "www" or even "nobody", that depends on the server-setup.
That means for example the directory should be readable and writable 
for the group "www-data". The owner of the directory should be the 
teacher. If there are more than one teacher, you could put them into 
the group "www-data".
IMPORTANT: others should have no access to that directory!

Example:
drwxrwx---  2 teacher www-data 4096 2006-10-18 20:18 /var/lib/akfquiz/

After that you should call the exam-mode from a web-browser to complete 
the installation. Enter the address to "cgiquiz" and append "/exam/" to 
that address. Then you will be asked to enter a new password. If the 
password could successfully be saved to disk, the installation is 
completed. Then you can copy your exams (quiz-files) into that 
directory.

If you don't want to use the exam-mode, it is okay to simply delete 
that directory.


COMPILING:

If you cannot or don't want to use a binary package, you have to compile 
the programs yourself. 

Compiling with Free Pascal (FPC) 2.0.0 or newer:

You need the main package and SDL-1.2 has to be installed on your
system.

Unpack the main package. Go into the newly created directory 
akfquiz/ and type

  ./configure --with-fpc
  make 
  make clean

After that, it is ready to use, as described above.


Compiling with GNU Pascal (GPC) 20030303 or newer.

To compile grquiz with GPC, either the libSDL-1.2 or the GRX library 
with GPC support enabled must be installed. 
When grquiz cannot be compiled, that error is ignored in the Makefile. 

type

  ./configure --with-gpc
  make 
  make clean

If you have the GRX library installed, you should enter
"./configure --with-grx", but libSDL should be preferred.

After that, it is ready to use, as described above.


Using configure:
The configure script accepts the following parameters:

--help            shows a short help
--prefix=         where to install
--cgidir=         where to install the CGI binary
--examdir=        directory for the exam-mode (cgiquiz)
--disable-exam    compile without exam-mode (cgiquiz)
--enable-exam=no  compile without exam-mode (cgiquiz)
--variant=        Variant name
--with-*          compiler to use [*]
--arch=           CPU architecture (just a name for making packages)
--sys=            system (just a name for making packages)
--enable-exam=no  disables the exam-mode
--disable-exam    disables the exam-mode
--enable-sound    SDL sound for all interactive programs
--disable-sound   SDL Sound just for grquiz

[*] the compiler may be
--with-fpc  - Free Pascal 2.0 or newer
--with-gpc  - GNU Pascal 20030303 or newer with libSDL
--with-grx  - GNU Pascal 20030303 or newer with GRX
--with-xarm - Free Pascal Cross-Compiler for Linux on ARM
--with-xw32 - Free Pascal Cross-Compiler for Windows 
              (don't use it directly on Windows)


Windows Users:

The ./configure script needs a Bourne Shell. It is tested with MSys and 
MinGW as environment. Use "make windows". Do not use "make install" or 
"make install-cgi".


AKFQuiz contains the following programs:

grquiz         - interactive quiz in graphic mode [1]
scrquiz	       - interactive quiz on textconsole/terminal
linequiz       - interactive quiz in command-line mode [2]
diaquiz        - interactive quiz for X (needs Xdialog)
cgiquiz        - webserver based quiz program
mkquiz	       - creates HTML code for the JavaSript based quiz
getquiz	       - fetches all files needed for mkquiz files and 
                 copies them to the current directory

[1] grquiz can be compiled for different libraries.
    To use it with SVGALIB it must be installed setuid root.
[2] linequiz is meant as backend program

Manpages:
akfquiz(5), grquiz(1), scrquiz(1), diaquiz(1), linequiz(1), cgiquiz(8),
mkquiz(1)