Vejledning i brug af valgprogram til prioritetsvalg.

# Copyright (C) 2000-2003 Henrik Christian Grove <grove(at)sslug.dk>
#                 og Frank Damgaard <frank(at)diku.dk>
#    This program is free software; you can redistribute it and/or modify
#    it under the terms of the GNU General Public License as published by
#    the Free Software Foundation; either version 2 of the License, or
#    (at your option) any later version.
#
#    This program is distributed in the hope that it will be useful,
#    but WITHOUT ANY WARRANTY; without even the implied warranty of
#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#    GNU General Public License for more details.
#
#    You should have received a copy of the GNU General Public License
#    along with this program; if not, write to the Free Software
#    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA


Krav til udstyr:
1) webserver f.eks. apache
2) perl, valg.pl er et selvstændig program, og st.pl/indl.pl er perl-cgi
3) gnu awk til at lave stemmeseddel 
4) TeX/LaTeX for at udskrive stemmeseddel
5) WebBrowser, gerne med JavaScript, da dette anvendes til delvis
   kontrol af indtastede felter. (Virker med Mozilla 0.95 og MSIE)
   Lynx kan også anvendes til indtastning.....


Filer til valgprogram:

kanditater.txt
	Fil med navne, en linie per kandidat
stemmeseddel-prototype.tex
	Prototype på stemmeseddel
stemmeseddel-tex.awk
	Awk script der fletter kandidater.txt med stemmeseddel :
	gawk -f stemmeseddel-tex.awk < stemmeseddel-prototype.tex >
	ny.tex
ssluglogo.eps
	logo der anvendes af stemmeseddel.tex
indl.pl og st.pl
	Vis indtastede stemmer, og indtast stemmeseddel.
	Filer tilrettes og lægges hvor cgi-script kan udføre:

	Start URL til indtastning er f.eks.:
	  http://stem/cgi-bin/st.pl?state=0
	Efter "send" skal man bekræftige det indtastede med "Gem".

stemmer.txt
	Indeholder de indtastede stemmesedler. Filen skal være
	tom ved start. Husk korrekte læse/skrive rettigheder for cgi-scripts
	til denne fil fra webserver/cgi. !!

stemme_0.incl og stemme_2.incl
	Bruges af st.pl, og indeholder bla. noget javascript og tekst.

valg.pl
	Selvstændigt Perl program til at lave optælling og html filer.
	Eventuelle lodtrækningsdata vil der bliver spurgt om
	undervejs.
	Filerne endeligt-resultat.html og res-??.html genereres.


............
Simpel adgangsseddel der kan udleveres til møder hvor der ikke er
personvalg:

adgangseddel.tex  
	LaTeX fil der kan bruges som skabelon. Tilpas dato og evt. 
	baggrundsbillede (vælg et andet). Brug evt. også forskellige
	farve papir til efterfølgende møder.
	Adgansseddel kan anvendes ved håndsoprækning.
linux-back-2agr.ps
	Ekspempel på baggrundsbillede.

##.............. data + programplacering

# I eksemplet her forventes at st.pl og indl.pl er placeret
# i /home/valg/public_html/valg .
#
# $mypath
#   Andre placeringer kan vælges ved at ændre "$mypath" i 
#   toppen af st.pl og indl.pl
#
# $valgurl, $indlurl og $sturl mv. i toppen af indl.pl (+ st.pl) tilpasses 
# evt. også hvis filerne ikke er i documentroot for valg  ( http://valg/ )
#
# tilret også :
#   $aarstal 
#   evt. $prioritetsniveauer
#
# $kanditater= kandidater.txt
#	     filen indholder liste med kandidater, se i valg.pl 
#
# $stemmefil = stemmer.txt 
#	     slettes/nulstilles før indtastning af stemmetal 
#
#

##............. rettelser i systemfiler:

##........ /etc/hosts
# tilføj f.eks. hvis valgserver's IP er 192.168.1.20
# tilfgøjes hosts til alle der skal tilgå valgserver (valg.invalid):
192.168.1.20	valg.invalid  valg

........Apache http.conf:

<Directory /home/valg/public_html/valg>
AllowOverride None
Options  +Includes +FollowSymLinks ExecCGI Indexes
Order allow,deny
Allow from all
</Directory>

<VirtualHost 192.168.1.20:80>
  ServerName  valg
  ServerAlias valg.invalid
  DocumentRoot /home/valg/public_html/valg/
</Virtualhost>