Primoz Trubar

 Trubar
 Spremenljivke

[ Kazalo || Naprej || Nazaj ]

Pri uporabi spremenljivk v vzorčnih datotekah je vseeno, ali ime spremenljivke zapišemo z velikimi ali malimi črkami (lahko tudi mešano). Spremenljivke, ki jih lahko uporabljamo v vzorčnih datotekah, delimo v več skupin. Opozoriti je treba, da ne moremo vedno uporabljati vseh skupin spremenljivk, ampak le nekatere izmed njih. Skupine, na katere delimo spremenljivke, so naslednje:

Spremenljivke, ki jih lahko vedno uporabimo

V to skupino spremenljivk spadajo sistemske spremenljivke operacijskega sistema, sistemske spremenljivke WWW strežnika in spremenljivke, ki so skupne vsem Trubarjevim programom. Sistemske spremenljivke operacijskega sistema so odvisne od operacijskega sistema in od uporabnika, ki si lahko sam nastavi svoje spremenljivke. Imena vseh teh spremenljivk moramo vedno pričeti z znakom & (npr: &PATH). Pri sistemskih spremenljivkah WWW strežnika je treba opozoriti, da nekateri WWW strežniki ne definirajo vseh potrebnih sistemskih spremenljivk, zato se je treba uporabi teh spremenljivk čimbolj izogibati.

    &SERVER_SOFTWARE ime WWW strežnika, ki teče na računalniku
    &SERVER_NAME ime računalnika, na katerem teče WWW streznik (IP številka, če ime ni znano)
    &GATEWAY_INTERFACE verzija CGI vmesnika
    &SERVER_PROTOCOL ime in verzija HTTP protokola
    &SERVER_PORT številka vrat (port), na katere kliče klient
    &REQUEST_METHOD zahtevana metoda za prenos parametrov
    &PATH_INFO dodaten podatek (neimenovan parameter)
    &PATH_TRANSLATED pretvorjen dodaten podatek
    &HTTP_REFERER URL dokumenta, ki vsebuje kazalec na klicani CGI program
    &SCRIPT_NAME URL, preko katerega smo poklicali CGI program
    &QUERY_STRING seznam imenovanih parametrov
    &REMOTE_HOST ime klienta (prazno, če ime ni znano)
    &REMOTE_ADDR IP številka klienta
    &REMOTE_USER ime uporabnika, če zahtevamo predstavitem (ponavadi je prazno)
    &REMOTE_IDENT uporabniško ime uporabnika
    &AUTH_TYPE metoda za predstavitev uporabnika (ponavadi prazno)
    &CONTENT_TYPE MIME tip podatkov, ki jih klient pošiljamo strežniku
    &CONTENT_LENGTH dolžina podatkov (število znakov)
    &HTTP_ACCEPT seznam vseh MIME tipov, ki jih klient zna prepoznati
    &HTTP_USER_AGENT ime in verzija programa za prikazovanje HTML dokumentov, ki ga uporablja klient

Vsak Trubarjev program si ob zagonu definira še naslednje spremenljivke:

    &home polno ime področja, kjer se nahaja CGI program
    &wwwhome ime področja, kjer se nahaja CGI program (relativno glede na server root)
    &cgihome ime področja, kjer se nahaja CGI program (relativno glede na CGI root)
    &program ime CGI programa, ki se trenutno izvaja
    &language kratek opis jezika (eng ali slo)
    &coding način kodiranja šumnikov (če je language=slo)
    &charset način izpisa dokumentov (če je language=slo)
    &languageparam     vrednost parametra language, kot smo ga določili pri klicu programa
    &metacharset vrstica, ki vsebuje značko <meta> za določitev nabora znakov

Spremenljivke iz inicializacijske datoteke

Vsi Trubarjevi programi, ki si preberejo inicializacijsko datoteko trubar.ini (to so vsi, z izjemo programa document), si definirajo še naslednje spremenljivke:

    &trubarhome domače področje za Trubarjeve programe (isto kot cgihome)
    &version verzija instaliranega paketa Trubar
    &administrator     E-mail naslov vzdrževalca paketa Trubar in pripadajočih katalogov
    &header posebni podatki, ki se zapišejo v glavo vsakega programsko generiranega dokumenta

Spremenljivke skupine katalogov

Vsak program, ki si prebere podatke o kakšni skupini katalogov (to so tisti programi, ki hočejo imeti za svoj neimenovani parameter ime skupine katalogov), si definira še vse dodatne spremenljivke, definirane v opisni datoteki, ter še naslednje spremenljivke:

    &group kratko simbolno ime skupine katalogov
    &groupdesc         opis skupine katalogov

Spremenljivke o katalogu

Kadar Trubarjev program dela s kakšnim katalogom, si definira naslednje spremenljivke:

    &catalog kratko simbolno ime kataloga
    &catalogdesc       opis kataloga

Ostale spremenljivke

Poleg vseh naštetih spremenljivk lahko pri uporabi določenih Trubarjevih programov programov uporabljamo še nekatere druge spremenljivke. Ponavadi so to posebni klicni parametri programa ali spremenljivke iz kataloga. Več o teh spremenljivkah je povedano pri opisu posameznega Trubarjevega programa.

[ Kazalo || Naprej || Nazaj || Na začetek ]