Commit | Line | Data |
---|---|---|
ca88871f | 1 | <title>Harvie's JuKe!Box Help</title> |
1c6591f3 H |
2 | <script type="text/javascript">function showhide(eid) {obj = document.getElementById(eid); obj.style.display = (obj.style.display == 'none' ? '' : 'none');}</script> |
3 | ||
4 | <h2>[EN] Warning</h2> | |
5 | This document should be outdated or invalid. You can find the latest and valid version <a href="http://code.google.com/p/h-jukebox/wiki/AboutHelp">here</a>. | |
6 | If you still want to read this document, then <a href="javascript:showhide('help')">click here to agree</a>. | |
7 | <h2>[CZ] Varování</h2> | |
8 | Tato stránka může být zastaralá, nebo neplatná. Poslední platnou verzi naleznete <a href="http://code.google.com/p/h-jukebox/wiki/AboutHelp">zde</a>. | |
9 | Pokud i přes to chcete tuto stránku číst, pak <a href="javascript:showhide('help')">pro souhlas klikněte zde</a>. | |
10 | ||
11 | <div id="help"> | |
12 | <pre> | |
13 | ||
14 | <hr /><h2>Autorská práva</h2> | |
ca88871f H |
15 | Autorem této aplikace je <~~Harvie (2oo8), který se zříká autorských práv (CopyLefted) a zároveň také zodpovědnosti. |
16 | Licence pro software z třetí strany (musicplayer,...) najdete v souboru COPYING. | |
17 | Pokud je pomocí tohoto webu zpřístupněn materiál, jehož stažením se vy nebo poskytovatel dopouštíte porušení autorských práv, tento obsah nestahujete! | |
18 | Instalací nebo používáním aplikace potvrzujete, že jste s právy srozuměni a že je akceptujete. V opačném případě aplikaci nepoužívejte ani neinstalujte. | |
19 | ||
20 | <h2>Základy Ovládání</h2> | |
21 | Na úvodní stránce vidíte výpis souborů a adresářů (označeny [DIR]). | |
22 | Kliknutím na jméno souboru zahájíte stahování. | |
23 | Kliknutím na jméno adresáře vstoupíte do adresáře. | |
24 | Pokud zobrazený adresář obsahuje soubor index.html nebo index.txt, bude tento zobrazen nad výpisem. | |
25 | Vedle každého adresáře nebo hudebního souboru najdete písmenka, pomocí kterých můžete spustit příslušnou akci. | |
26 | ||
27 | Tady je krátký přehled významu jednotlivých písmenek: | |
28 | P - Přehrát (je nutné stáhnout playlist.m3u a otevřít v přehrávači hudby - např. Winamp, to se dá po nastavení prohlížeče dělat automaticky...) | |
29 | - U složek tato volba přehraje všechny zvukové soubory, které složka obsahuje | |
30 | R - To samé jako P, ale přehraje se i hudba v podsložkách (POZOR! raději nepoštět na velké adresáře!!!) | |
31 | D - Otevře nadřazenou složku pro daný soubor (pouze u vyhledávání) | |
32 | F - Spustí přehrávání v prohlížeči (vyžaduje flash), otevřete odkaz v novém okně, pokud si chcete dál prohlížet knihovnu... | |
33 | S - Zastaví přehrávání v prohlížeči | |
34 | ||
35 | <h2>Vyhledávání</h2> | |
36 | Před prvním vyhledáváním je potřeba vytvořit cache a nastavit ji práva pr zápis. | |
37 | Potom je soubor s cache třeba obnovovat (na stránce vyhledávání se zadá heslo pro obnovení/vytvoření db a stiskne se "refresh cache"). | |
38 | Na Linuxu se může dát obnovování cache do cronu jako skript používající příkaz find, databáze tak bude udržována stále aktuální. | |
39 | Při vyhledávání je možné použít regulární výrazy (mezery budou nahrazeny řetězcem '(.*)' !!!). | |
40 | Kromě vyhledávání hudby v lokálním archivu skript také umožňuje vyhledávání hudby a textů písní na www. | |
41 | Je limitován počet souborů, u kterých se při vyhledávání zobrazuje velikost. (To by vylučovalo funkci cache - cachovat velikost se mi ale nechce). | |
42 | Kromě vyhledávání lze z databáze také vygenerovat (pseudo)náhodný playlist. | |
43 | ||
44 | <h2>Přihlašování</h2> | |
45 | Pokud je povolen přihašovací modul, budete při prvním otevření stránky vyzváni k zadání příslušných údajů. | |
46 | Odhlášení provedete kliknutím na odkaz "LOGOUT" v horním menu. | |
47 | ||
48 | <h2>Instalace</h2> | |
49 | Instalace se provádí nakopírováním souborů do adresáře přístupného webovému servru, | |
50 | upravením nastavení ve zdrojovém souboru a přihlašovacím modulu (http_auth.php). | |
51 | Pro zakázání přihlašovacího modulu smažte první řádek kódu (obsahuje http_auth.php). | |
52 | a správným nastavením přístupových práv daným souborům. | |
53 | Také doporučuji nastavit php open base dir pro pojisteni pred directory traversingem do nadrazenych adresaru... | |
54 | ||
55 | Přehled vlastností v hlavním souboru: | |
56 | $title = Nadpis stránky | |
57 | $music_dir = Relativní cesta k adresáři s hudbout | |
58 | $music_dir_url = URL pro přístup k hudbě z venku | |
59 | $cache_passwd = Heslo pro obnovení vyhledávací cache | |
60 | $access_limit = Maximální počet souborů zpracovaných bez použití cache (při vyhledávání) | |
61 | $default_random_count = Výchozí počet v náhodném playlistu | |
62 | $sort = Povolit abecedni razeni? 0=ne, 1=jen playlisty, 2=playlisty i listingy, 3=vse i vyhledavani | |
63 | - Razeni je potreba pouzivat s rozvahou s ohledem na zatez CPU a RAM (coz muze byt omezeno nastavenim serveru/php) | |
64 | - Razeni vyhledavaci databaze muze byt narocnejsi zvlaste u rozsahlejsich hudebnich knihoven | |
65 | - V takovem pripade je vhodne ho zakazat, nebo pouzit k razeni shellove skripty | |
66 | ||
67 | $playlist_name = Jméno generovaného playlistu | |
68 | $m3u_exts = Přípony souborů, které se zobrazí v playlistu a ve vyhledávání | |
69 | ||
70 | $indexlist = Pole se jmény souborů, které se mají případně zobrazit před výpisem složky | |
71 | $bonus_dir = Adresář s pomocnými soubory | |
72 | $search_cache = Cesta k vyhledávací cache | |
73 | $flash_player = Cesta k swf souboru webového přehrávače | |
74 | $css_file = Cesta k CSS stylu | |
75 | ||
76 | ||
77 | <h2>Nefunguje</h2> | |
78 | Skript - potřebujete webserver s podporou PHP | |
79 | Vyhledávání - skript nemá práva pro zápis/čtení databáze, nebo databáze ještě nebyla vytvořená... | |
80 | Přehrávání v prohlížeči - není přítomný swf soubor přehrávače, prohlížeč nepodporuje flash, nebo inline framy... | |
81 | Něco jiného - UTFS && UTFG... | |
82 | </pre> | |
1c6591f3 H |
83 | </div> |
84 | <script type="text/javascript">showhide("help");</script> |