jbx/help.html

   1 <title>Harvie's JuKe!Box Help</title>
   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>
  15 Autorem této aplikace je &lt;~~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>
  83 </div>
  84 <script type="text/javascript">showhide("help");</script>