 |
Dokumentacija
Kazalo vsebine
1. Splošna vprašanja 1.1. Kaj je to SubDownloader? SubDownloader je program, namenjen dodajanju podnapisov, iskanju podnapisov, ki ustrezajo določenemu releasu filma, povezovanju filmskih datotek z ustreznimi filmskimi vnosi v bazi OMDb ter ustreznimi podnapisi s strani Podnapisi.NET. 1.2. Kako program deluje? S pomočjo programa SubDownloader lahko uporabniki povezujejo podnapise, ki ustrezajo filmom, ki jih imajo na nosilcih podatkov, kot so naprimer CD in DVD ploščki, trdi diski, USB ključi in podobno. Ko je določena filmska datoteka že povezana z ustreznim filmom, lahko uporabnik za ta film išče podnapise, ki filmu ustrezajo. V kolikor za ta release podnapisov, ki bi se natančno ujemali ni, je mogoče preveriti podnapise, ki niso nujno pravi, lahko pa vseeno ustrezajo. Če na seznamu nenatančnih ujemanj najdete podnapis, ki ustreza filmu, ki ga imate pri sebi, ga lahko s filmsko datoteko povežete. Po povezovanju se bo podnapis v primeru iskanja pojavil med natančno ujemajočimi podnapisi. 1.3. Kaj potrebujem za poganjanje programa? Trenutno program deluje na Windows XP, Windows Vista in Linux operacijskih sistemih. Za uporabo potrebujete dostop do interneta in nekaj malega prostora na trdem disku. Na Linux operacijskem sistemu potrebujete nameščen Python 2.5 ter PyQt4. 2. Prijava 2.1 Kako se prijavim na strežnik? Prijavite se lahko enostavno, z uporabo uporabniškega imena in gesla spletne strani Podnapisi.NET. Če želite s programom izvajati še kaj drugega kot le iskanje primernih podnapisov, potem je prijava z uporabniškimi podatki registriranega uporabnika strani Podnapisi.NET nujna, samo za iskanje obstaja tudi možnost anonimne prijave.  2.2 Kaj je to anonimna prijava? Anonimna prijava je namenjena uporabnikom, ki na strani Podnapisi.NET niso registrirani, oziroma uporabnikom, ki bi radi opravili le iskanje podnapisa za film, ki ga posedujejo na nosilcu podatkov. Anonimna prijava ne dovoljuje nobenih naprednih funkcij programa, kot so naprimer različna povezovanja filmskih datotek s filmi ali ustreznimi podnapisi. Za popolno funkcionalnost je potrebna pridobitev uporabniškega imena in gesla z registracijo preko spletne strani. 3. Uporaba aplikacije 3.1. Kako poiskati ustrezen podnapis ? SubDownloader podnapise filmski datoteki poišče glede na ustrezno povezan filmski vnos v bazi OMDb. Če povezava še ni določena, jo je pred tem nujno potrebno dodati. Če je kdo za to različico filma že določil ustrezne podnapise, se podnapisi pojavijo na seznamu podnapisov, ki se natančno ujemajo z releasom, v nasprotnem primeru pa je tudi seznam nenatančno ujemajočih podnapisov, kjer se nahajajo vsi podnapisi za iskani film, ne glede na različico. Če med temi podnapisi najdete takega, ki različici popolnoma ustreza, ga lahko enostavno povežete s svojim filmom. Pred povezovanjem VEDNO preverite, če film / podnapis resnično ustreza filmski datoteki, ki jo imate!  3.2. Ne najde nobenega ustreznega podnapisa, kaj sedaj? Če program ne najde nobenega podnapisa, ki ustreza vaši različici filma, potem je potrebno pogledati na seznam podnapisov, ki se ne ujemajo natančno. Na tem seznamu se nahajajo vsi filmi, ne glede na release, kateremu so prirejeni. Če med temi podnapisi najdete takega, ki različici popolnoma ustreza, ga lahko enostavno povežete s svojim filmom. Pred povezovanjem VEDNO preverite, če film / podnapis resnično ustreza filmski datoteki, ki jo imate! 3.3. Dodajanje novega podnapisa S pritiskom na ikono z zelenim znakom plus, odprete obrazec za dodajanje novega podnapisa. Najprej je potrebno vnesti lokacije do datotek filma, katerega podnapise dodajate. Če gre za film, ki se nahaja na dveh CD ploščkih, vnesite oba dela filma. V delu s podatki o podnapisu je potrebno vnesti lokacijo, kjer se nahaja arhiviran podnapis (v *.zip formatu), točno določiti film v bazi OMDb, podnapisu definirati jezik in število sličic na sekundo (FPS) filma, kateremu podnapis ustreza. Po možnosti se lahko označi tudi, da gre za podnapise podaljšane različice filma, podnapise za gluhe in naglušne, DVD oziroma, da gre za avtorski prevod.  3.4. Kaj je to povezovanje? Filmu, ki se v obliki datoteke (ponavadi s končnico .avi) nahaja na nosilcu podatkov s pomočjo povezovanja, določimo pravi vnos v filmski bazi OMDb in podnapise, ki so prirejeni točno za to različico filmske datoteke. Določitev filma v OMDb je nujna, saj omogoči iskanje tudi v primeru, če točno podnapisa, ki se natančno ujema z releasom še ni nihče povezal. 3.5. Kako povezati film z nosilca podatkov s filmom? Če za datoteke filma, ki se nahaja na trdem disku še ni ustrezne povezave, jo je potrebno dodati. Povezave se enostavno lahko dodaja s funkciju "poveži film" v roletnem meniju ali s pritiskom na za to namenjeno ikono v orodni vrstici. V obrazcu, ki se odpre je nujno potrebno vnesti pot do datoteke filma, ki se nahaja ponavadi nekje na trdem disku. Ko izberete željeno datoteko, jo morate povezati najprej z ustreznim filmom v filmski bazi OMDb. Po pritisku na gumb "Išči..." se odpre okno, kamor je potrebno vpisati originalen naslov filma, potem pa s seznama najdenih zadetkov izbrati pravega. Spodaj se nahaja tudi dodatna možnost, povezovanja datoteke na disku z ustreznim podnapisom. Če veste, da nek podnapis ustreza filmu katerega povezujete, ga lahko z vpisom ID številke enostavno povežete. Če je ustreznih več podnapisov, se jih hkrati lahko doda tudi več, vsak vnos ID številke podnapisa pa je potrebno potrditi s pritiskom na gumb "Dodaj". 3.6. Kako povezati film z nosilca podatkov s primernim podnapisom? Če želite filmu, ki se nahaja na računalniku dodati povezavo za ustrezne podnapise, obstajata za to dva načina. Prvi način je, da med najdenimi rezultati iskanja z desnim miškinim klikom kliknete tistega, ki filmu ustreza in kliknete na možnost, "Poveži z releasom...", ki se pojavi na zaslonu. To dejanje bo film povezalo s podnapisom, zato se prej prepričajte, da podnapis dejansko ustreza filmu!  Drugi način je, da se podnapis doda skupaj s povezavo svoje datoteke s filmom v bazi OMDb. Povezave se enostavno lahko dodaja s funkciju "poveži film" v roletnem meniju ali s pritiskom na za to namenjeno ikono v orodni vrstici. V obrazcu, ki se odpre je nujno potrebno vnesti pot do datoteke filma, ki se nahaja ponavadi nekje na trdem disku. Ko izberete željeno datoteko, jo morate povezati najprej z ustreznim filmom v filmski bazi OMDb. Po pritisku na gumb "Išči..." se odpre okno, kamor je potrebno vpisati originalen naslov filma, potem pa s seznama najdenih zadetkov izbrati pravega. Spodaj se nahaja tudi dodatna možnost, povezovanja datoteke na disku z ustreznim podnapisom. Če veste, da nek podnapis ustreza filmu katerega povezujete, ga lahko z vpisom ID številke enostavno povežete. Če je ustreznih več podnapisov, se jih hkrati lahko doda tudi več, vsak vnos ID številke podnapisa pa je potrebno potrditi s pritiskom na gumb "Dodaj".  3.7. Program najde podnapise, ki se ne ujemajo z mojim filmom! Če se zgodi, da program SubDownloader na seznam podnapisov, ki naj bi se natančno ujemali s filmom, postavi podnapis, ki se s filmom ne ujema, potem je bila povezava podnapisa s filmom dodana napačno. V tem primeru lahko vsak uporabnik, ki napako ugotovi, označi povezavo kot napačno in s tem pomaga pri odstranitvi neprimernega podnapisa s seznama. Pomembno: tukaj je potrebno ločiti med podnapisi, ki so točno povezani z dano datoteko, ter podnapisi katere SubDownloader samo predlaga (torej so za isti film, ni pa nujno da tudi ustrezajo točno tej datoteki). Privzeto program prikaže oboje (netočni rezultati so jasno ločeni), v kolikor pa želite da program prikaže samo podnapise, ki so bili eksplicitno povezani z določeno datoteko, pa nastavite minimalni rank na vsaj vrednost 1 (netočni vnosi so namreč vedno rangirani z 0). 4. Za razvijalce 4.1 Odkril sem napako v aplikaciji, kam lahko pošljem popravek? Dokler še ni postavljen poštni seznam, lahko vse popravke pošljete na kostko@unimatrix-one.org. 4.2 Protokol za komunikacijo s strežnikom Podrobne informacije o uporabljenem protokolu najdete tukaj. 4.3 Moviehash algoritem Algoritem za izračun unikatnega hasha filmskih datotek je enak kot ta na strani OpenSubtitles.org. Izbran je bil predvsem zato, ker je izračun njegove vrednosti zelo hiter (za izračun uporabi zadnjih nekaj bajtov filmske datoteke ter njeno dolžino). Več informacij o samem algoritmu lahko najdete na strani http://subdownloader.sourceforge.net/wiki/index.php/Moviehash. |