#! /usr/bin/perl

################################################################################
#                                                                              #
#                                 help.cgi                                     #
#                                 --------                                     #
#                     INDIW-2000 / Futurama-prosjektet                         #
#                                                                              #
################################################################################
#                                                                              #
# This file is © Arne Sommer - rev. 10. May   2000.                            #
#                                                                              #
################################################################################

use FindBin;
use lib "$FindBin::Bin/mylib";
  # Get the directory where the program resides, and add the 'mylib'           #
  # subdirectory to the library lookup table.                                  #

use CGI;

require "lib/misc.pl";
require "lib/cookies.pl";
require "lib/config.pl";
require "lib/language.pl";

## Language Specific ###########################################################

my($lang) = language();
  # Get the user's prefered language.                                          #

## Set up the document #########################################################

$q = new CGI;

my($header, $user_id) = cookie_header($q);
  # Set up (parse and maintain) the cookie.                                    #

print $header;

print start_doc($q, "indifu $h_title{$lang}");

print $q->h2($h_title{$lang});

## Help topics #################################################################

$h_topic{"en gen"}    = "General";
$h_topic{"no gen"}    = "Generelt";
$h_topic{"en main"}   = "The Main Page";
$h_topic{"no main"}   = "Hovedsiden";
$h_topic{"en lang"}   = "Language";
$h_topic{"no lang"}   = "Språk";
$h_topic{"en col"}    = "Colours";
$h_topic{"no col"}    = "Farvebruk";
$h_topic{"en reg"}    = "Registration";
$h_topic{"no reg"}    = "Registrering";
$h_topic{"en story"}  = "Reading";
$h_topic{"no story"}  = "Lesing";
$h_topic{"en write"}  = "Writing";
$h_topic{"no write"}  = "Skriving";
$h_topic{"en vote"}   = "Voting";
$h_topic{"no vote"}   = "Avstemninger";
$h_topic{"en adm"}    = "Administration";
$h_topic{"no adm"}    = "Administrasjon";
$h_topic{"en back"}   = "Background";
$h_topic{"no back"}   = "Bakgrunn";
$h_topic{"en logout"} = "Logout";
$h_topic{"no logout"} = "Logge ut";

## General #####################################################################

# Located in 'lib/language.pl', so that 'index.cgi' can get hold of it.        #

## Main ########################################################################

$h_help{"en main"} = <<END;
  The main page welcomes registered users, and gives unregisterd users the
  possibility to register (which is necessary to write a suggestion for the
  next part of a story, and vote in them).  The link 'Click here if this is
  not you' is not caused by an insecure system , but is there to cath a situation
  where several users use the same browser, e.g. in a cybercafé, if the previous
  user didn't do a 'Logout' (as the person should have done).
  <p>
  The user can choose to view all the stories (default), or just the stories
  in english, norwegian, french or german.  Future visits will remember this
  language selection (cookie).
  <p>
  The story table has the following elements:
  <ul>
    <li>The story identifier (ID), that uniquely identifies the story in the
        system.  All communication between the scrips use this ID.
    <li>The story name, that should describing the story.  The editor of the
        story can add general rules and comments for each part, if required.
    <li>Parts, which is the number of parts in the story so far.  The user
        works on the <em>next</em> part if the story is in writing or voting
        mode.
    <li>Language, which indicates the language to write the story in. It is
        the editor's task to enforce this.
    <li>State, which specifies the state of the story:
        <table>
          <tr><td align=center BGCOLOR=#FF0000>Ended</td>
              <td>The story has been terminated, permanently.</td></tr>
          <tr><td align=center BGCOLOR=#FFFF00>Suspended</td>
              <td>The story has been temporarily suspended.</td></tr>
          <tr><td align=center BGCOLOR=#00FF00>Write</td>
              <td>The story is open for writing of a proposal for the
                  next part.</td></tr>
          <tr><td align=center BGCOLOR=#00DDDD>Vote</td>
              <td>The story is open for voting over approved proposals
                  for the next part.</td></tr>
        </table>
        The colour usage should enhance the state codes, but have no other
        purpose.  The system will function for colour blind users, or on a
        monochrome monitor.<br>
        A number i parenthesis after 'Vote' is the number of alternatives to
        vote on.  (<em>The editors</em> are shown the number of submited
        alternatives after 'Write' for their stories.)<br>
        The state transitions for the story is managed by the editor of the
        story.
    <li>This colum without heading displays the text 'OK' for stories in
        writing mode if the user has submited a proposal for the next part,
        or voting mode if the user has voted on one of the alternatives for
        the next part.
    <li>This colum without heading will show the administration link for
        stories where this user is the editor (unless the story is ended).
        Users without editorial responsibilities will not see this coloumn
        at all.
  </ul>
  Then som explaining lines of text are shown, together with the comments
  links (mailto).
  <p>
  The page ends with general links; 'Add a new story' if the user is one
  of the super users, 'Logout' which one normally should leave alone, and
  'Help' which is the entry point to the help system.
END

$h_help{"no main"} = <<END;
  Forsiden ønsker registrerte brukere velkommen tilbake, og tilbyr uregistrerte
  brukere å registrere seg (som er nødvendig for å kunne skrive inn forslag til
  fortsettelser til historiene, og å stemme på dem).  Linken 'Klikk her' hvis
  dette ikke er deg skyldes ikke usikkerhet i systemet, men er der for å fange
  opp bruk av felles browsere, f.eks. via en cybercafé, om forrige bruker ikke
  logget seg ut (som vedkommende da burdte ha gjort).
  <p>
  Man kan velge mellom å se alle historiene (default), eller bare å se historier
  på engelsk, norsk, fransk eller tysk.  Fremtidige besøk på siden vil huske
  språkvalget (cookie).
  <p>
  Tabellen over historiene inneholder følgende elementer:
  <ul>
    <li>Historieidentifikator (ID), som er den entydige identifikatoren for
        historiene som systemet benytter seg av.  All kommunikasjon mellom
        scriptene benytter denne ID'en.
    <li>Historienavnet, som bør være rimelig beskrivende for historien.
        Redaktøren av historiene kan i tillegg legge inn generelle regler
        og kommentarer til hver del, hvis ønskelig.
    <li>Deler, som er antallet deler i historien så langt.  Hvis historien er i
        skrive- eller stemmemodus holder man da på med <em>neste</em> del.
    <li>Språk, som indikerer hvilket språk historien skal skrives på.  Det er
        opp til redaktøren å håndheve dette.
    <li>Status, som forteller tilstanden til historien:
        <table>
          <tr><td align=center BGCOLOR=#FF0000>Avsluttet</td>
              <td>Historien er avsluttet for godt.</td></tr>
          <tr><td align=center BGCOLOR=#FFFF00>Pause</td>
              <td>Historien er midlertidig pauset.</td></tr>
          <tr><td align=center BGCOLOR=#00FF00>Skrive</td>
              <td>Historien er åpen for innskriving av forslag til
                  fortsettelse.</td></tr>
          <tr><td align=center BGCOLOR=#00DDDD>Stemme</td>
              <td>Historien er åpen for avstemning over godkjente forslag til
                  fortsettele.</td></tr>
        </table>
        Farvebruken er ment å utheve statuskodene, men er ikke meningsbærende
        i seg selv.  Systemet vil derfor fungere for farveblinde brukere,
        eller på sort/hvitt skjermer.<br>
        Et tall i parantes etter 'Stemme' er antallet alternativer man kan
        stemme over. (<em>Redaktøren</em> av historien får også opp informasjon
        på tilsvarende måte for egne historier etter 'Skrive'.)<br>
        Det er redaktøren som styrer tilstandsovergangene for historien.
    <li>I denne overskiftsløse kolonne viser teksten 'OK' for historier som er
        i skrivemodus hvis brukeren har lagt inn et forslag til fortsettelse,
        eller stemmemodus hvis brukeren har stemt på ett av forslagene til
        fortsettelse.
    <li>I denne overskriftsløse kolonnen vil administrasjonslinken vises for
        historier denne brukeren er redaktør for (med mindre historien er
        avsluttet).  Er man ikke redaktør for noen historier er følgelig
        kolonnen tom.
  </ul>
  Deretter kommer noen forklarende tekstlinjer og tilbakemeldingslinker
  (mailto).
  <p>

  Til slutt kommer generelle linker; 'Legg inn ny historie' hvis man er
  superbruker, 'Logge ut' som man normal ikke skal bruke, og 'Hjelp' som er
  inngangen til hjelpeteksten.
END

## Language ####################################################################

$h_help{"en lang"} = <<END;
  The pages are shown in english, but you can choose another language in
  the browser.  (Netscape: Edit -> Preferences -> Navigator -> Languages.)
  <p>
  Tha available languages are:
  <ul>
    <li>english
    <li>norwegian
  </ul>
  English is used if the language selction is unused, or if the chosen
  language(s) are unsupported by indifu.
END

$h_help{"no lang"}= <<END;
  Sidene vises på norsk, men du kan velge et annet språk i webleseren.
  (Netscape: Edit -> Preferences -> Navigator -> Languages.)
  <p>
  Tilgjengelige språk:
  <ul>
    <li>engelsk
    <li>norsk
  </ul>
  Engelsk blir brukt om språkvalget ikke er brukt, eller om valgene ikke
  støttes av indifu.
END

## Colour Usage ################################################################

$h_help{"en col"} = <<END;
  The colour coding of the status field in the story table on the main page is
  described in the section about the main page.
  <p>
  Otherwise is the colour coding used to highlight important informastion;
  <table>
    <tr><td align=center BGCOLOR=#FF0000>Red</td>
        <td>is used in error messages.</td></tr>
    <tr><td align=center BGCOLOR=#FFFF00>Yellow</td>
        <td>is used in warnings, e.g. when the system has done something the
            user did not anticipate.  This is not really an error.</td></tr>
    <tr><td align=center BGCOLOR=#00FF00>Green</td>
        <td>is used to confirm that the required action went well.</td></tr>
    <tr><td align=center BGCOLOR=#DDDDDD>Grey</td>
        <td>is used to highlight some state reports and warnings.</td></tr>
  </table>
  (The exception to this rule is the administration program, used by the story
  owners, that shows the status messages for the alternatives to the next part
  in green if they are authorized for voting, and in red if they are disabled.)
  <p>
  All the links are shown in the colours chosen by the browser, and all links
  to contents (reading of a story, administration of a story, voting on an
  alternative to the next part of a story) are url-encoded so that they also
  are shown in the colouring scheme used on traditional links to static
  documents.
  <p>
  The pages have white background, and we have used three images in the system,
  all of them using a blue line; it has been given the "INDIFU Story Site" text
  on the top of the pages, and acts as a logo.  The line on the bottom of the
  page is ended with a copyright notice.  We have also used an unaltered
  version of the line in some cases to separate different types of contents.
END

$h_help{"no col"} = <<END;
  Bruk av farvekoding av statusfeltet i historietabellen på forsiden er beskrevet
  i teksten for hovedsiden.
  <p>
  Ellers er farvekoding benyttet for å utheve viktig informasjon;
  <table>
    <tr><td align=center BGCOLOR=#FF0000>Rødt</td>
        <td>brukes for å gi feilmeldinger.</td></tr>
    <tr><td align=center BGCOLOR=#FFFF00>Gult</td>
        <td>brukes i advarsler, f.eks. når systemet har gjort noe brukeren ikke
            hadde forventet, uten at det egentlig er noe feil.</td></tr>
    <tr><td align=center BGCOLOR=#00FF00>Grønt</td>
        <td>brukes som bekreftelse på at handlingen gikk bra.</td></tr>
    <tr><td align=center BGCOLOR=#DDDDDD>Grått</td>
        <td>brukes til å utheve en del tilstandsmeldinger og advarsler.</td></tr>
  </table>
  (Unntaket fra denne regelen er administrasjonsprogrammet, som brukes av
  redaktørene, som viser forslag til fortsettelse med grønn statuskode om de er
  godkjent for avstemning, og i rødt om de er sperret.)
  <p>
  Alle linker vises i de farver browseren er satt opp til å vise dem i, og alle
  linker til innhold (lesing av historie, administrasjon av historie, stemme på
  forslag til fortsettelse av historie) er url-kodet slik at de også vil få
  den samme farvekodingen som tradisjonelle linker til statiske dokumenter.
  <p>
  Vi har benyttet hvit bakgrunn, og tre bilder i systemet, alle bestående av
  en linje i blått; øverst på siden er den gitt teksten "INDIFU Story Site",
  og fungerer som logo.  Nederst på siden er linjen avsluttet av en liten
  copyright notis.  I tillegg benyttes en ubesudlet variant av linjen i en
  del sammenhenger for å skille mellom ulike typer innhold.
END


## Registration ################################################################

$h_help{"en reg"}= <<END;
  All users of the system get a unique identifier the first time they
  visit the pages.  This identifier is stored internally in the user's
  browser (as a 'cookie'), and it expires if the user does not visit 
  the pages again within three months after the previous visit.
  <p>
  The system registers the last access time for every user for each
  story, primarily to give personalisation; the users are only presented
  with unread parts of the stories.  The alternatives for the parts of the
  stories are registered with the user who submited the text, as is the
  votes.
  <p>
  Voting and writing requires registration.  This is done by giving the
  system your email address, and entering the password received by email.
  This registration is done only once, unless the three month time limit
  is exceeded.  This situation can be fixed by entering the email address
  and the received password in the registration form <em>at the
  same time</em>.  It is also possible just to enter the email address,
  and the system will send you a new password.
  <h4>Why Registration?</h4>
  There are two reasons for this design choice:
  <ul>
    <li>The user's know that their writings are joined with their names
        (email address) will reduce the urge to 'tagging' and write
        irresponsible texts.
    <li>This ensures that the users only can enter one vote for each part
        of the story.  (This is almost true!)
  </ul>
END

$h_help{"no reg"} = <<END;
  Alle brukere av systemet blir tildelt en entydig identifikator første
  gang man besøker sidene.  Identifikatoren lagres lokalt i brukernes
  browser (som en 'cookie'), og den forsvinner om man ikke har vært innom
  sidene på tre månedene.  Alternativene for delene av historiene
  registreres sammen med brukeren som skrev inn teksten, og tilsvarende
  gjøres for stemmene.
  <p>
  Systemet registrerer siste tidspunkt for aksess av hver historie for
  alle brukerne.  Dette gjøres primært for å gi personalisering; man blir
  kun presentert for de delene av historiene man ikke har lest før.
  <p>
  For å få tilgang til avstemning og innskriving av fortsettelse må man
  registreres.  Dette skjer ved at man oppgir emailadressen sin til
  systemet, som så sender et passord tilbake som epost.  Dette passordet
  tastes så inn, og man er registrert.  Denne registreringen gjøres kun
  en gang, med mindre man lar det gå mer enn tre måneder mellom besøkene
  til sidene.  I så fall må man logge seg på på nytt ved å skrive inn
  emailadressen og det tilsendte passordet <em>samtidig</em> i
  registreringsskjemaet.  Eventuelt kan man oppgi emailadressen, og få
  tilsendt et nytt passord.
  <h4>Hvorfor registrering?</h4>
  Det er to grunner til dette designvalget:
  <ul>
    <li>Det at brukerne vet at det de skriver sammenholdes mot navnet deres
        (emailadressen) vil redusere lysten til 'tagging' og useriøse tekster.
    <li>Det sikrer at brukerne bare kan legge in en stemme for hver del av
        historien.  (Dette er nesten sant!)
  </ul>
END

## Reading #####################################################################

$h_help{"en story"} = <<END;
  This will only show the parts of the story that were added to it after
  the user accessed it the last time (but there is a bug in the program).
  A click on 'Reload' will show no text at all, as the system has
  registered that the user has read it all.  ('Read' should be understood as
  'seen'.)  Use 'The whole story' link to see the whole story.
  <p>
  The form to enter an alternative for the next part of the story is shown
  if the story is in writng mode, and the alternatives to vote on are shown
  if it is in voting mode.  Nothing is shown if the story is suspended
  or finished.
END

$h_help{"no story"} = <<END;
  Her vises de delene av historien som er kommet til etter at brukeren
  sist var innom denne historien (men det er en feil i programmet).
  Ved klikk på 'Reload' vil man da ikke få vist noe tekst, siden man
  allerede har lest alt.  (Her vil 'lese' måtte forstås som 'sett'.)
  Hvis man vil se hele historien kan man bruke linken 'Hele historien'.
  <p>
  Feltet for å skrive inn et forslag til fortsettelse vises hvis historien
  er i skrivemodus, og alternativene som man kan stemme over vises om
  Hvis historien er åpen for å skrive fortsettelse vil linken 'Skriv
  fortsettelsen' vises, mens linken 'Stem på en fortsettelse' vises om
  den er i stemmemodus.  Ingenting vises om historien er pauset eller
  avsluttet.
END

## Writing #####################################################################

$h_help{"en write"} = <<END;
  Only registered users are allowed to write!
  <p>
  The last part of the story is shown unless shown initially, so that the twist
  of the story can be followed easily.  Use the 'Compute the number of characters'
  button (which only works if javascript is supported by your browser) to get the
  lenght of the text before submitting it.  An error message is given if the text
  is longer than the upper limit (both javascript and cgi), but the text remains.
  Edit it down to a suitable size.
  <p>
  It is possible to download plain text files, but binary files (such as MS
  Word are not supported).
  <ul>
    <li>Click on 'Browse'.
    <li>Select a file name in the file selctor, and click on 'OK'.
    <li>The file is now shown in the text field.
    <li>Edit the text, if required.
  </ul>
  Uploading is done with a click on the 'Send' button.
  <p>
  It is possible to submit a new proposal for the same part of the story.  The
  old text is shown initially in the text field.  Note that it will invalidate
  the old text.
  <p>
  All submited text is &copy; the individual authors.  They have granted us
  permission to show the stories, in whole or partially, in this system by
  sending it to us.  All other use of the texts requires permission from the
  individual authors.
END

$h_help{"no write"} = <<END;
  Man må være registrert for å kunne utføre denne operasjonen.
  <p>
  Siste del av historien blir vist hvis den ikke allerede er vist, slik at man
  kan følge nerven i historien.  Bruk 'Beregn antall tegn' knappen (som kun
  virker om javascript støttes av browseren din) til å få lengden på teksten
  før den sendes inn.  Hvis inntastet forslag til tekst er lengre enn tillatt
  maksimallengde får man en feilmelding (javascript og cgi), men teksten
  forsvinner ikke.  Rediger den så ned til passende størrelse.
  <p>
  Det er også mulig å laste ned rene tekstfiler, men binærfiler (som
  f.eks. MS Word) er ikke støttet.
  <ul>
    <li>Klikk på 'Browse'.
    <li>Velg et filnavn i filvelgeren som dukker opp, og klikk 'OK'.
    <li>Filen er nå vist i inntastingsskjemaet.
    <li>Foreta eventuelle redigeringer.
  </ul>
  Opplasting skjer ved å klikke på 'Send' knapppen.
  <p>
  Det er mulig å sende inn et nytt forslag til den samme delen av historien.
  Den gamle teksten vises da i inntastinsskjemaet.  Merk at den nye teksten
  vil overskrive det gamle forslaget.
  <p>
  All innskrevet tekst er &copy; de respektive forfatterne.  Ved å sende oss
  teksten gis vi tillatelse retten til visning av historier i dette systemet,
  helt eller delvis.  All annen utnyttelse av tekstene krever godkjennelse av
  enkeltforfatterne.
END

## Voting ######################################################################

$h_help{"en vote"}  = <<END;
  Only registered users are allowed to vote!
  <p>
  The alternatives for the part that the editor has chosen for voting are shown.
  Click on the voting link for the alternative you wish to vote on.
  <p>
  Any former vote is shown.  It is possible to vote again on the same part of a
  story, but the new vote will cancel the previous one.
END

$h_help{"no vote"}  = <<END;
  Man må være registrert for å kunne utføre denne operasjonen.
  <p>
  Her vises de forslagene til fortsettelse av historien som redaktøren har valgt
  ut.  Klikk på avstemningslinken for den teksten du vil stemme
  på.
  <p>
  En eventuelt tidligere stemme vises.  Det er mulig å stemme på nytt på en del
  til en historie.  Den nye stemmen erstatter da den gamle.
END

## Administration ##############################################################

$h_help{"en adm"}   = <<END;
  There are two types of administration of the system, but these tasks are only
  for users with special privileges.
  <h4>Super users</h4  
  Only the super user(s) are allowed to add new stories to the system.  They
  have no other special rights, unless especially chosen as editor for a story.
  <h4>Editors</h4>
  The editor for a story can be freely chosen among the registered users of
  the system on creation of a story (by a super user).  The editor decides
  when a story goes from writing mode to voting mode, and selects the
  alternatives to vote over.  The editor can terminate the voting at will,
  and can also stop (terminate) a story.
  <p>
  Note that stopping the voting for a story with registered votes will result in
  a winner, and the winning entry is added as a new part of the story.
END

$h_help{"no adm"}   = <<END;
  Det er to typer av administrasjon av systemet, men disse oppgavene er
  forbehold brukere med særskilte rettigheter.
  <h4>Superbrukere</h4>
  Superbrukere er spesielle brukere som har adgang til å opprette (legge inn)
  nye historier i systemet.  De har ingen andre spesielle rettigheter, med
  mindre de eksplisitt er valgt som redaktør for en historie.
  <h4>Redaktører</h4>
  Når en historie opprettes (av en superbruker) kan man fritt velge hvem som
  skal være redaktør i mengden av registrerte brukere av systemet.  Redaktøren
  bestemmer når historien går fra skrivemodus til avstemning, og velger ut
  hvilke alternativer som det kan stemmes over.  Vedkommende bestemmer også
  når avstemningen skal avsluttes, og om en historie skal avsluttes (dvs. at
  det ikke blir lagt til mere tekst i den).
  <p>
  Merk at avslutning av stemmegivning for en historie med registrerte stemmer
  vil føre til at det vinnende forslaget bli lagt til som en ny del av historien.
END

## Background ##################################################################

$h_help{"en back"}  = <<END;
  This story writing system is developed by Henrik Brautaset Aronsen, Trond
  Fredrik Scjander Opsahl, Arne Sommer, Aksel Strømsheim, and Huu Nghia Truong.
  <p>
  It is a part of the spring 2000 indiw course at IFI.  Our case is
  <a href="http://www.futurama.nrk.no">Futurama</a>, but we chose to implement
  our system locally at IFI as they did not have a system in place.
  <p>
  The system is written as cgi-scripts in perl running on an Apache Web server,
  communicating with a MySQL database with perl's database independent DBI
  interface.  The system uses a couple of javascript procedures, but it will
  function without problems from a browser without javascript support.
END

$h_help{"no back"}  = <<END;
  Dette historieskrivingssystemet er utviklet av Henrik Brautaset Aronsen, Trond
  Fredrik Scjander Opsahl, Arne Sommer, Aksel Strømsheim og Huu Nghia Truong.
  <p>
  Det er en del av kurset indiw våren 2000 ved IFI.  Vårt <em>case</em> er
  <a href="http://www.futurama.nrk.no">Futurama</a>, men siden de ikke hadde et
  oppegående system da vi skulle sette i gang med vårt bidrag valgte vi å
  implementere historiesystemet lokalt på IFI.
  <p>
  Systemet er programmert som cgi-skripts i perl på en Apache Web-server, og
  kommuniserer mot en MySQL database via perls databaseuavhengige DBI
  grensesnitt.  Systemet benyttet et par javascript-prosedyrer, men fungerer
  uten problemer fra en browser uten støtte for javascript.
END

$h_help{"en logout"}  = <<END;
  Logout is <em>not required</em> if you have logged in to the computer you
  are using, and have your own user configuration files!
  <p>
  The User ID is stored locally in your browser, and you should only need to
  remove it if you use a joint account, e.g. a cybercafé.  This will prevent
  the next user from entering text with you as the writer.
  <p>
  Do you wish to <a href="logout.cgi">remove the user ID</a>, so that the next
  user of the account (computer) does not inherit your permissions?
END

$h_help{"no logout"}  = <<END;
  Logge ut er <em>ikke nødvendig</em> om du har logget deg inn på datamaskinen
  du bruker, og har dine egne konfigurasjonsfiler!
  <p>
  Bruker ID'en lagres lokalt i browseren din, og den eneste grunnen til at du
  skulle ha behov for å slette den er om du bruker en maskin (konto) som brukes
  av flere brukere, f.eks. en cybercafé.  Dette forhindrer at neste bruker kan
  legge inn tekst med deg som avsender!
  <p>
  Ønsker du å <a href="logout.cgi">slette bruker ID'en</a>, slik at neste bruker
  av maskinen (kontoen) ikke arver rettighetene dine?
END

################################################################################

my($topic) = $q->url_param("help") || "gen";

my(@topics) = ('gen', 'main', 'lang', 'col', 'reg', 'story', 'write', 'vote',
               'adm', 'back', 'logout');

my(@links);

foreach (@topics)
{
  ($_ ne $topic)
    ? push(@links, $q->a({-href=>"help.cgi?help=$_"}, $h_topic{"$lang $_"}))
    : push(@links, $q->b($h_topic{"$lang $_"}));
}

print $q->p, join(" | ", @links), $q->p;

@links = ();

print $h_help{"$lang $topic"};
  # Print the help text itself.                                                #

################################################################################

push(@links, $q->a({-href=>"index.cgi"}, $i_main{$lang}));
print $q->p, join(" | ", @links), $q->p;

print bottom_line(), $q->end_html();

################################################################################