www.listanjezakonov.com

NAVODILO ZA UPORABO PROGRAMA

Zadnja sprememba: 07.04.2012

1.

UVOD

Program za indeksiranje zakonov, poljubnih HTML dokumentov in Gmail sporočil je namenjen izdelavi kazal (indeks) besed, posledično pa le-ta omogočajo hitro listanje dokumentov.
Program originalne datoteke modificira tako, da ostaneta vidna (berljiva) vsebina in oblika nespremenjeni, v strukturo dokumentov pa doda programsko logiko, ki omogoča bliskovit preskok iz vsebine dokumentov na kazalo in obratno.

Število Gmail sporočil ni omejeno, ostalih HTML dokumentov (vključno z zakoni) pa je lahko največ 10.
Vsak dokument je indeksiran po vseh besedah (kazalo indeksiranih besed), ki imajo tri (3) ali več črk in s tem tudi po zaporednih številkah členov v zakonih.
Med listanjem posameznega dokumenta dostopate do kazala indeksiranih besed tako, da se z miško pozicionirate na izbrano besedo in dvakrat (2x) kliknete levi gumb miške.

Program je bil v letu 2012 temeljito spremenjen, ga nadgrajujemo, vendar je trenutno na razpolago le v eni verziji.
Starih verzij programa ne vzdržujemo, zato priporočamo uporabo zadnje verzije.

1.1

OPOZORILO

Imenik (direktorij), v keterem nameravate pognati program (delovni imenik), sme vsebovati le programe s končnico *.exe, ker program med svojim delom briše skoraj vse ostale datoteke, ki jih najde v tem imeniku.
V podimenik htm_in kopirajte vse datoteke, ki jih želite indeksirati, v podimenik htm_out pa se izpišejo rezultati procesiranja.
Podimenik htm_out mora biti prazen.

2.

LICENČNI POGOJI (pogoji uporabe)

Uporabnice in uporabniki (v nadaljevanju bomo uporabljali termin uporabnik za ženski in moški spol) morajo upoštevati, da je zbirka indeksiranih dokumentov kreirana s pomočjo programske opreme in lahko vsebuje napake.

Copyright Franc Kemperle, 2010-2012 (http://www.listanjezakonov.com).
Avtor in ponudniki programa ne sprejemamo nobene odgovornosti za posledice, ki bi nastale zaradi napak v programu.

Program je brezplačen vendar le za osebno ali nekomercialno uporabo
Program v indeksirane dokumente vriva povzavo na naš spletni naslov z oglasi, ki pa se proži le občasno.
Vse ostale pravice so pridržane, zato programa zlasti ni dovoljeno:
- spreminjati;
- ali vključevati v druge programske produkte.

Za uporabo v komercialne, poslovne, upravne, izobraževalne in ostale namene, ki niso navedeni v tem dokumentu, je potrebna pogodba.
Program je dovoljeno distribuirati, vendar pod enakimi (neokrnjenimi) pogoji, kot so zapisani tukaj.

3.

RAČUNALNIŠKO OKOLJE

Program deluje v okolju Microsoft Windows kot 32 bitni konzolni program (brez grafičnega vmesnika).
Program praviloma deluje na vseh 32 bitnih Microsoft Windows platformah, od vključno MS Windows XP in novejših.
Program za svoje delo potrebuje nekatere pomožne programe iz okolja Microsoft Windows:
- cmd.exe;
- sort.exe;
- find.exe.
Ti pomožni programi so praviloma nameščeni v sistemskem imeniku operacijskega sitema, dostop do njih pa zagotavlja sistemska spremenljivka PATH.
Pred zagonom programa se morate prepričati, da spremenljivka PATH omogoča dostop do zgoraj omenjenih programov.
Dostopnost do teh pomožnih programov preverja tudi program takoj po zagonu, vendar je priporočljivo, da to preverjanje opravite sami.

Program za svoje delo potrebuje lasten delovni imenik (direktorij) in dva podimenika.
Delovni imenik poimenujete poljubno, v njem pa morata biti kreirana še dva podimenika :
- htm_in
- htm_out

Imenik (direktorij), v keterem nameravate pognati program (delovni imenik), sme vsebovati le programe s končnico *.exe, ker program med svojim delom briše skoraj vse ostale datoteke.

4.

VHODNE DATOTEKE

Program indeksira poljubno kombinacijo zakonov (sprejeti zakoni in čistopisi zakonov, ki so objavljeni v HTML formatu na spletnem portalu Državnega zbora), HTML dokumentov in neomejeno število Gmail sporočil.
Spletni portal Državnega zbora : http://www.dz-rs.si/

Vhode datoteke morajo biti zapisani v HTML formatu in kodirani v UTF-8.
Oba omenjena pogoja najlažje preverite, če dokument odprete s spletnim brskalnikom in to preverite v nastavitvah ali neposredno v izvorni vsebini datoteke.
Če recimo uporabljate Mozilla Firefox, v orodni vrstici kliknete na <View>, nato <Character Encoding> in izberete (preverite) če je kodiranje <Unicode (UTF-8)>.
Kopiranje datoteke je možno na dva načina :
- preprosta kopija
- celovita kopija
Program potrebuje le preproste kopije datotek, ki jih kopirate v podimenik htm_in.
Če recimo uporabljate Mozilla Firefox, v orodni vrstici kliknete na <File>, nato <File Save As ...>, v pogovornem oknu pa v polju <Save as type :> izberete <Web Page, HTML only>.

Če želite kopirati Gmail sporočila pa je zaporedje akcij naslednje:
- odprete Gmail sporočilo
- izberete akcijo print
- izberete Save Page As , web Page HTML only

5.

ZAGON PROGRAMA

Program deluje v okolju Microsoft Windows kot 32 bitni konzolni program (brez grafičnega vmesnika).
Pred zagonom programa morajo biti izpolnjeni naslednji pogoji :
- kreiran je delovni imenik (direktorij), ki vsebuje le program lz.exe in druge programe (*.exe);
- kreiran je podimenik htm_in, ki vsebuje samo datoteke, ki jih želite indeksirati;
- kreiran je podimenik htm_out, ki je prazen.

Program lahko poženete na dva načina :
- z dvojnim klikom;
- z aktiviranjem ukaznega okna (CMD.EXE) v delovnem imeniku, nato pa v ukaznem oknu odtipkate ime programa.

Aktiviranje z dvojnim klikom je sicer enostavno, vendar ima to pomanjkljivost, da se program izvaja v preddefiniranem ukaznem oknu (cmd.exe), ki praviloma uporablja majhno velikost črk in črno ozadje.
Priporočljivo je, da CMD.EXE kopirate v delovni direktorij, ga z dvojnim klikom poženete, povečate velikost okna in črk ter izberete ustrezno barvo ozadja.
Nastavitve CMD.EXE ukaznega okna (konzola) spremenite na nsalednji način :
V delovni imenik kopirate CMD.EXE.
Nato z dvojnim klikom poženite CMD.EXE, da se odpre ukazno okno (konzola).
Kurzor pozicionirajte v zgornji odebeljeni rob okna (v katerem je izpisano ime programa cmd.exe) in opravite desni klik miške.
V padajočem meniju izberite <Properties>.
Odpre se novo pogovorno okno z zavihki <Options>, <Font>, <Layout>, <Colors>.
V zavihku <Options> praviloma niso potrebne spremembe, v ostalih zavihkih pa jih priporočamo.

Po zagonu programa, le-ta preverja večino okoliščin in pogojev, ki smo jih opisali do sedaj in le ob izpolnjevanju le-teh nadaljuje z delom.
V nadaljevanju program izpisuje le še procent (%) opravljenega dela, ki pa ni povsem sorazmeren s časom izvajanja.

6.

IZHODNE DATOTEKE

Rezultati se izpisujejo v podimenik htm_out.
Pred vpisovanjem novih rezultatov, program briše celotno vsebino tega podimenika.
Vhodne datoteke so preimenovane v f000001.htm, f000002.htm, f000003.htm …., vendar v enakem zaporedju, kot ste ga določili ob zagonu programa.
Indeksne datoteke so pimenovane od in000001.htm, in000002.htm, in000003.htm …, kar pa nima nobene zveze z vhodnimi datotekami, ker so indeksne datoteke praviloma kreirane z enakim številom indeksiranih besed (zaradi hitrosti delovanja).
Imena datotek ni možno spreminjati, oziroma, ob spremembi le-teh indeksne povezave (linki) prenehajo delovati.
Datoteke v podimeniku so organizirane kot skupina urejenih (indeksiranih) HTML dokumentov in praviloma delujejo z vsemi spletnimi brskalniki, ki podpirajo Javascript.
Vsebino podimenika htm_out je možno ob nespremenjeni funkcionalnosti kopirati v katerikoli imenik ali podimenik.
Pri listanju indeksiranih dokumentov se občasno in naključno proži povezava na spletno stran z oglasi.

Verzije programa in dokumentacija (download)

Vaša vprašanja in pripombe so dobrodošle : info@listanjezakonov.com