home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / w3grab15.zip / wwwgrab2.cze < prev    next >
Text File  |  1997-12-16  |  44KB  |  1,112 lines
  1.  
  2.  
  3.                             WWWGrab/2 v1.5
  4.  
  5.  
  6. <English On>
  7. Please read the WWWGrab2.ENG file.
  8. <English Off>
  9.  
  10. <Spanish>
  11. La versión en castellano es WWWGrab.SPA
  12. </Spanish>
  13.  
  14. <French>
  15. La documentation en français est dans le fichier WWWGRAB.FRA.
  16. </French>
  17.  
  18.  
  19.  
  20. Obsah
  21. -----
  22. Θvod
  23. Poºadavky
  24. Autorská práva a záruky
  25. Spuτt╪ní WWWGrab/2
  26. Nahrazovací v∞razy
  27. Pouºívání `@' souborà
  28. Formát konfiguraƒních souborà
  29. Seznam p²íkazà - Detailní popis
  30. Seznam p²íkazà - Struƒn∞ popis
  31. Referenƒní tabulka p²íkazà a voleb
  32. P²íklady
  33. Pod╪kování
  34.  
  35. Θvod
  36. ----
  37. WWWGrab/2 je ²ádkov╪ orientovaná utilita slouºící ke kompletnímu nebo
  38. ƒásteƒnému zrcadlení WEBserverà. WWWGrab/2 vyrobí na váτ pevn∞ nebo sí£ov∞
  39. disk, kopii souborà vzdáleného WWW serveru vƒetn╪ HTML souborà, obrázkà,
  40. zvuku a podobn╪.
  41.  
  42. WWWGrab/2 pot²ebujete v p²ípad╪ ºe:
  43.   * Jste administrátorem webového serveru a pot²ebujete jej zrcadlit na
  44.     dalτí servery. S vyuºitím programu typu "cron" màºete nastavit WWWGrab/2
  45.     tak, aby pravideln╪ zrcadlil váτ web-server na ostatní servery.
  46.   * Máte problém se stahováním stránek kvàli rychlosti nebo kvalit╪ spojení
  47.     (coº u nás není nic divného) s webov∞m serverem. WWWGrab/2 vám màºe
  48.     uτet²it ƒas (a peníze pokud jej pomocí "cron" nastavíte na noƒní hodiny)
  49.     tím, ºe stáhne stránky sám a vy si je prohlédnete v klidu na svém disku.
  50.   * Pracujete na své vlastní webové stránce a chcete si prohlédnout HTML kód
  51.     stránek n╪koho jiného a zjistit, jak jsou vlastn╪ ud╪lány.
  52.   * Chcete mít vlastní kopii webového serveru pro rychlé a snadné
  53.     prohlíºení.
  54.   * Chcete mít kopii webové stránky nebo serveru, protoºe v blízké dob╪ jiº
  55.     nemusí existovat.
  56.   * Máte pomalé p²ipojení k Internetu nebo prost╪ nemáte p²íliτ rádi systém
  57.     "World Wide Wait".
  58.   * Platíte p²ístup na Internet za minutu.
  59.   * ¼asto navτt╪vujete jeden webov∞ server, ale nechcete se pokaºdé
  60.     p²ipojovat kdyº se pot²ebujete na n╪co podívat.
  61.  
  62. WWWGrab/2 má n╪kolik vlastností, které jej ƒiní mohutn∞m a flexibilním
  63. nástrojem na zrcadlení webov∞ch serverà:
  64.  
  65.   * P²ibliºn╪ 50 p²íkazà a voleb díky nimº máte maximální moºnou kontrolu a
  66.     pruºnost p²i práci s programem. (Samoz²ejm╪ ºe nepot²ebujete pouºívat a
  67.     znát vτechny p²íkazy.)
  68.   * Snadno pouºitelné konfiguraƒní soubory umoºσují detailní nastavení voleb
  69.     a p²íkazà. Konfiguraƒní soubory mohou b∞t vno²eny, umoºσují automatické
  70.     vkládání spoleƒn∞ch p²íkazà a voleb. Pro kaºd∞ webov∞ sever màºete mít
  71.     zvláτtní konfiguraƒní soubor.
  72.   * Nahrazovací v∞razy podobné jako v U*IXu umoºσují maximální pruºnost p²i
  73.     definici jmen souborà, masek URL.
  74.   * WWWGrab/2 màºe kontrolovat modifikované soubory na jiº d²íve zrcadleném
  75.     serveru.
  76.   * Po kaºdém úsp╪τn╪ staºeném souboru màºe b∞t spuτt╪n libovoln∞ program,
  77.     coº umoºσuje provád╪t se soubory poºadované akce.
  78.   * Logování úsp╪τn╪ staºen∞ch souborà.
  79.  
  80.  
  81. Poºadavky
  82. ---------
  83. WWWGrab/2 má pár skromn∞ch poºadavkà:
  84.  
  85.    * OS/2 verze 2.11 nebo vyττí. Doporuƒuji pouºít MERLIN nebo OS/2 Warp
  86.      Connect pro optimální v∞kon.
  87.    * Jeden z následujících balíkà TCP/IP pro OS/2 (Se²azeno podle
  88.      vhodnosti):
  89.         * IBM TCP/IP dodávané s OS/2 Warp Merlin.
  90.         * IBM TCP/IP 3.0 dodávan∞ s OS/2 Warp Connectem.
  91.         * IBM TCP/IP 2.0 Base Kit s aplikovan∞m CSD64092 nebo vyττím.
  92.         * The Internet Access Kit z OS/2 Warp Bonus packu.
  93.    * Disk s podporou dlouh∞ch jmen (HPFS, ext2fs, atp.) není vyºadován,
  94.      ale siln╪ doporuƒen!
  95.    * P²ibliºn╪ 100K diskového prostoru pro program a dokumentaci.
  96.    * Dostatek místa na disku pro vaτe zrcadlení. Toto závisí na tom, jak
  97.      pouºíváte WWWGrab/2 a màºe b∞t velké jen n╪kolik kilobajtà, ale také
  98.      pár desítek megabajtà.
  99.  
  100.  
  101.  
  102. Záruky, autorská práva apod.
  103. ----------------------------
  104.  
  105.      Drºitelem autorsk∞ch práv na tento program je J. Rubeτ.
  106.  
  107.         WWWGrab/2 je sharewarov∞ produkt, kter∞ je distribuován pomocí voln╪
  108. dostupn∞ch míst, aby si jej p²ípadní zájemci mohli p²ed zakoupením
  109. vyzkouτet.
  110.  
  111.      WWWGrab/2 màºe b∞t pouºit pouze k legálním  úƒelàm. PⁿEDEM se
  112. ujist╪te, zda není ZAK╡ZANÉ zrcadlení poºadovaného místa.
  113.  
  114.  
  115.                 POUª╓V╡N╓ PROGRAMU JE NA VLASTN╓ NEBEZPE¼╓
  116.  
  117.      Tento program je dodáván TAK JAK JE bez jak∞chkoliv záruk. Autor není
  118. zejména  odpov╪dn∞  za  ºádné τkody vzniklé provozovaním programu, náhodné
  119. nebo  následné,  ztrátu  zisku nebo dat, ani vhodnost pouºití programu pro
  120. dané úƒely.
  121.  
  122.      WWWGrab/2  NESM╓  b∞t  pouºíván  ke  komerƒním úƒelàm bez p²edchozího
  123. písemného povolení autora.
  124.  
  125.  
  126. Spuτt╪ní WWWGrab/2
  127. ------------------
  128.      Spuτt╪ní  WWWGrab/2  je  velice  jednoduché.  Staƒí  prost╪ napsat na
  129. p²íkazov∞ ²ádek OS/2:
  130.                     WWWGRAB <konfiguraƒní_soubor> [/i] [-c0|-c1]
  131.  
  132.      WWWGrab/2   màºe  b∞t  t麠 spouτt╪n  z  dávkov∞ch  a  REXX  souborà,
  133. samoz²ejm╪  také  jako  programov∞  objekt z OS/2 desktopu (nebo chcete-li
  134. pracovní plochy).
  135.  
  136.      <konfiguraƒní_soubor> je pouºit∞ konfiguraƒní soubor. Konfiguraƒní
  137. soubor je obyƒejn∞ textov∞ soubor obsahující p²íkazy a volby, které  urƒují
  138. chování WWWGrab/2.  Jeho  formát je popsán níºe.  Nejjednoduτí zpàsob, jak
  139. vytvo²it nov∞ konfiguraƒní soubor je zkopírování n╪kterého z p²iloºen∞ch
  140. p²íkladà a jeho následná úprava dle vlastní pot²eby.
  141.  
  142.      -i ²íká, aby WWWGrab/2 nezpracovával standardní konfiguraƒní soubor.
  143. Normáln╪ je standardní konfiguraƒní soubor (pojmenovan∞ "DEFAULT.W3D")
  144. automaticky zpracováván p²i kaºdém spuτt╪ní. Tento soubor màºe obsahovat
  145. p²íkazy a volby, které ƒasto nem╪níte. (Seznam p²íkazà pouºiteln∞ch v
  146. standardním konfiguraƒním souboru najdete v referenƒní tabulce p²íkazà a
  147. voleb.)
  148.  
  149.      -c0 nebo -c1 zapíτí seznam modifikovan∞ch odkazà od posledního
  150. zrcadlení do souboru W3GRAB.CHG:
  151.  
  152.    c0 - kontroluje servery bez p²íkazu HEAD. Tento zpàsob je pomalejτí, ale
  153.         jist╪jτí.
  154.    c1 - kontroluje servery s pouºitím p²íkau HEAD. Toto je rychlejτí, ale
  155.         mén╪ jisté, protoºe n╪které jednoduττí WWW servery neakceptují
  156.         p²íkaz HEAD od klienta a vrací chybov∞ kód. (Apache, CERN, ICS a
  157.         Netscape pracují správn╪.)
  158.  
  159.      Volbu -c0 nebo -c1 lze pouºít pouze na jiº zrcadlen∞ WWW server.
  160.  
  161.  
  162. Nahrazovací v∞razy
  163. ------------------
  164.      WWWGrab/2 pouºívá v n╪kter∞ch p²íkazech nahrazovací v∞razy ve stylu
  165. U*IXu. Tyto umoºσují vytvá²et komplexní specifikace jako nap²íklad
  166. http://www.foo.*/*/index.htm* nebo c??. Pomocí nich lze vytvá²et pruºné
  167. specifikace URL, p²ípon a jin∞ch tvarà masek u p²íkazà v nichº je moºné (a
  168. ºádoucí) zadávat porovnávací v∞razy.
  169.  
  170. Zadávaná maska màºe obsahovat:
  171.      `*' odpovídá nula nebo více znakàm.
  172.      `?' odpovídá jednomu znaku.
  173.      `\' potlaƒuje v∞znam speciálního znaku.
  174.      [SEZNAM] odpovídá libovolnému znaku uvedenému v seznamu.
  175.      [!SEZNAM] nebo [^SEZNAM] odpovídá libovolnému znaku NEuvedeném
  176.          v seznamu.
  177.  
  178.      SEZNAM je tvo²en ze samostatn∞ch znakà nebo rozsahu znakà. Rozsah znakà
  179. tvo²í dva znaky odd╪lené pomlƒkou (nap²íklad 0-9 nebo A-Z). ¼íslice, písmena
  180. (malá ƒi velká) a podtrºítko (`_') tvo²í minimální sadu znakà povolen∞ch v
  181. nahrazovacích v∞razech. V╪tτina operaƒních systémà podporuje rozτí²enou
  182. (8 bitovou) znakovou sadu.
  183.      Uvozovací znak (`\') je pouºit k potlaƒení speciálního v∞znamu
  184. znakà []*?!^-\ tak, aby mohli b∞t porovnávány jako obyƒejné znaky. Nap²íklad
  185. vzor `soubor\*' odpovídá ²et╪zci `soubor*' a ne ²et╪zci zaƒínajícímu na
  186. `soubor\' následovan∞m nula nebo více znaky; podobn╪ vzoru `soubor\[*'
  187. odpovídá ²et╪zec `soubor[' následovan∞ nula nebo více dalτími znaky.
  188.  
  189.      P²íkazy podporující nahrazovací v∞razy jsou uvedeny v referenƒní
  190. tabulce p²íkazà ve sloupci REX.
  191.  
  192.  
  193.      P²íklady:
  194.         soubor*
  195.           Odpovídá libovolnému ²et╪zci zaƒínajícímu na `soubor' jako jsou
  196.           `soubor', `souborovy', `soubor100'.
  197.         ??soubor
  198.           Odpovídá libovolnému osmiznakovému ²et╪zci konƒícímu na `soubor'
  199.           jako jsou `00soubor', `XXsoubor' atd.
  200.         soubor[yuo]*
  201.           Odpovídá libovolnému ²et╪zci zaƒínajícímu na `soubor',
  202.           následovan∞ `y', `u' a `o' následovan∞ nula nebo více znaky,
  203.           nap²íklad `souboru', `soubory', `souborovy'.
  204.         soubor[0-9]\-?
  205.           Odpovídá ²et╪zci zaƒínajícímu na `soubor', následovanému ƒíslicí a
  206.           pomlƒkou následovanou jedním libovoln∞m znakem `soubo3-a',
  207.           `soubor0-0'.
  208.  
  209. Pouºití '@' souborà
  210. -------------------
  211.      ¼asem  zjistíte, ºe pouºíváte n╪které parametry po²ád dokola. V tomto
  212. p²ípad╪  je  lepτí  neº  kopírování/vkládání textu z jednho konfiguraƒního
  213. soboru  do  druhého,  uloºit  parametry do '@' souboru a na ten se posléze
  214. odkazovat  z  konfiguraƒních  souborà.  Nap²íklad  ƒasto  pouºíváte p²íkaz
  215. MASK,  màºete  jej  uloºit  do  souboru DEFAULT.W3G a tento bude pouºit ve
  216. VµECH   konfiguraƒních  souborech.  Ovτem  pokud  pot²ebujete  pouºít  dv╪
  217. rozdílné  MASKy pro ràzné konfiguraƒní soubory, musíte pouºít '@' soubory.
  218. Jak?  Nejprve  vytvo²te  soubor  pojmenovan∞  (nap²íklad)  MASKY1  s tímto
  219. obsahem:
  220.  
  221. *.HTML
  222. *.HTM
  223. *.?.JPEG
  224. *.0?.GIF
  225.  
  226. Následn╪ vytvo²te druh∞ soubor pojmenovan∞ (nap²íklad) MASKY2 s tímto
  227. obsahem:
  228.  
  229. *.SHTML
  230. *.SHTM
  231. *.JPEG
  232. *.GIF
  233. *.WAV
  234.  
  235. Vτim╪te si, ºe vkládan∞ soubor musí obsahovat jeden parametr na jeden ²ádek.
  236.  
  237. Nakonec nastavte odkaz na p²ísluτn∞ vkládan∞ soubor do vaτeho konfiguraƒního
  238. souboru. Nap²íklad pokud chcete pouºít MASK1 p²idejte následující ²ádek do
  239. vaτeho konfiguraƒního souboru:
  240.  
  241. MASK @MASK1 ; pouºije obsah souboru MASKS1
  242.  
  243. P²i zpracování konfiguraƒního souboru bude WWWGrab/2 naƒítat parametry pro
  244. p²íkaz MASK ze souboru MASK1. Pozor, nezapomeσte uvád╪t znak `@' na zaƒátku
  245. jména souboru!
  246.  
  247. Màºete pouºít více vkládan∞ch souborà s jedním a tím sam∞m p²íkazem, pokud
  248. tento màºe b∞t pouºit více neº jednou. Nap²íklad uvedením obou souborà MASK1
  249. a MASK2 p²idejte následující dva ²ádky do konfiguraƒního souboru:
  250.  
  251. MASK @MASK1  ; pouºije obsah souboru MASK1
  252. MASK @MASK2  ; a p²idá k n╪mu obsah souboru MASK2
  253.  
  254. Pokud by byl pouºit pouze MASK @MASK2, potom by se stáhly pouze soubory
  255. vyhovující t╪mto maskám: *.SHTML, *.SHTM, *JPEG, *.GIF, a *.WAV
  256.  
  257. Podívejte se do refernƒní tabulky p²íkazà na p²íkazy, které podporují
  258. vkládání souborà.
  259.  
  260. Makra
  261. -----
  262. WWWGrab/2 umoºσuje definovat a následn╪ pouºívat jednoduchá makra pro
  263. nahrazování textu podobn╪ jako v souborech programu make. Syntaxe je
  264. následující:
  265.  
  266.  #define <prom> [hod]
  267. <Prom> je název makra, které chcete definovat a [hod] je nepovinná
  268. hodnota makra.
  269.  
  270. P²íklady:
  271.  #define NOBIN
  272.  Vytvo²í makro s názvem NOBIN, které nebude mít ºádnou hodnotu.
  273.  
  274.  #define USERPATH c:\jirir
  275.  Vytvo²í makro s názvem USERPATH a p²i²adí mu hodnotu c:\jirir
  276.  
  277. Existují dva moºné zpàsoby pouºití maker. První zpàsob je pouhé
  278. nahrazení textu. Nap²íklad, p²i pouºití d²íve definovaného makra
  279. USERPATH budou oba dva následující ²ádky funkƒn╪ shodné:
  280.  
  281.  LOCALPATH $(USERPATH)\mirrors
  282.  LOCALPATH c:\jirir\mirrors
  283.  
  284. Tento zpàsob pouºívání maker vyuºijete v takov∞ch konfiguraƒních
  285. skriptech, kde m╪níte ƒasto tent∞º text na více místech. Nyní prost╪
  286. vytvo²íte makro n╪kde na zaƒátku .INI souboru a budete se na n╪j odkazovat
  287. namísto vypisování textu; pokud se následn╪ zm╪ní text, zm╪níte jej pouze
  288. na jednom míst╪.
  289.  
  290. Druh∞m zpàsobem pouºití maker jsou podmín╪né v∞razy. Pomocí podmín╪n∞ch
  291. v∞razà màºete snadno zm╪nit p²íkazy, které se budou provád╪t p²i
  292. zpracovávání .INI souboru. Syntaxe je následující:
  293.  
  294. #ifdef <prom>     - NEBO -
  295. #ifndef <prom>
  296. ...
  297. #else
  298. ...
  299. #endif
  300.  
  301. Pokud je zadané makro definováno (nemusí obsahovat ºádnou hodnotu),
  302. jsou zpracovány ²ádky uvedené pod #ifdef (IF DEFined -- je definováno).
  303. V opaƒném p²ípad╪ jsou zpracovány ²ádky pod #else (pokud je #else uvedeno).
  304. Podmíneƒn╪ zpracovávan∞ blok se zakonƒuje p²íkazem #endif. #ifndef funguje
  305. s opaƒnou logikou - ²ádky za #ifndef se zpracují pokud makro není definováno
  306. a #else pokud je definováno. Blok #else nemusí b∞t uvád╪n.
  307.  
  308. P²íklady:
  309.  
  310. #ifdef __OS2__
  311. LOCALPATH c:\wwwgrab2\mirrors
  312. #else
  313. #ifdef __UNIX__
  314. LOCALPATH /home/w3g/mirrors
  315. #else
  316. LOCALPATH c:\wwwgrab95\mirrors
  317. #endif
  318. #endif
  319.  
  320. Tato posloupnost nastaví LOCALPATH v závislosti na operaƒním systému,
  321. kter∞ pouºíváte. (OS2 a UNIX jsou p²eddefinovaná makra.)
  322.  
  323. Podmínky mohou b∞t vno²eny aº do osmi úrovní.
  324.  
  325. Seznam p²eddefinovan∞ch maker je uveden v ƒásti "P²eddefinovaná makra".
  326.  
  327.  
  328. Formát konfiguraƒního souboru
  329. -----------------------------
  330. Vτechny p²íkazy a volby v konfiguraƒním souboru mají stejn∞ formát:
  331.  
  332. <p²íkaz> [parametry]
  333.  
  334. P²ed p²íkazem se mohou vyskytovat mezery a mezi p²íkazem a parametrem,
  335. pokud p²íkaz n╪jak∞ parametr vyºaduje, se musí vyskytovat minimáln╪ jedna
  336. mezera.
  337.  
  338. Komentá²e se uvozují znakem ';'. Text následovan∞ za st²edníkem je aº do
  339. konce ²ádky ignorován. Nap²íklad:
  340.  
  341. URL http://www.foo.com/bar      ; Toto je komentá²
  342. ; Toto je také komentá²
  343.  
  344.  
  345. Vτechny URL musí b∞t uvedeny v plném formátu, t.j. `http://www.foo.com/'
  346. a ne `foo', `foo.com' nebo `www.foo.com'. Také màºete pouºít IP adresu
  347. a/nebo ƒíslo portu: `http://www.foo.com:8080/' nebo
  348. `http://127.0.0.1:8080/cokoli.html'
  349.  
  350.  
  351.  
  352. Seznam p²íkazà - Detailní popis
  353. -------------------------------
  354.  
  355. ADD <cesta>
  356.      P²idá  uvedenou  cestu  do seznamu poºadovan∞ch URL. Màºe b∞t pouºito
  357.      vícekrát. Aplikuje se na první zadané URL.
  358.  
  359.      P²íklad:
  360.        URL http://www.xxx.yyy/cesta1/index.html
  361.        ADD /cesta2/pic/index.htm
  362.  
  363.      Stáhne http://www.xxx.yyy/cesta1/index.html    a
  364.             http://www.xxx.yyy/cesta2/pic/index.htm
  365.      + p²ísluτné soubory
  366.  
  367.  
  368. ALL
  369.      Normáln╪, pokud WWWGrab/2 zjistí, ºe soubor je uº na lokální stanici,
  370.      poτle na server podmín╪n∞ poºadavek. Soubor je vrácen jen v tom p²ípad╪,
  371.      pokud je nov╪jτí neº lokální soubor. Jestliºe chcete stáhnout vτechny
  372.      soubory, bez ohledu na datum, pouºijte p²íkaz ALL.
  373.  
  374.  
  375. ALLOW <URL-v-http-formátu>
  376.      Explicitn╪  definuje,  ºe  daná  "v╪tev"  je stahovatelná. Màºete jej
  377.      pouºít  v  tom p²ípd╪, kdy nechcete definovat MAXTRIES nebo SITELIST.
  378.      Tento p²íkaz màºe b∞t pouºit více neº jednou.
  379.  
  380.      P²íklad:
  381.        ALLOW http://www.xxx.yyy/povoli/tuto/cestu
  382.  
  383. CHAM <ƒíslo>
  384.      N╪které servery (v╪tτinou Netscape) zkouτejí rozpoznat jméno klienta.
  385.      Pokud  klienta  nepoznají, nepoτlou mu ºádná data. Màºete pouºít tuto
  386.      volbu  k  zamaskování  jména  klienta  (n╪co jako CHAMeleon:). V∞znam
  387.      jednotliv∞ch ƒísel:
  388.  
  389.           0 - WWWGrab     (standardn╪)
  390.           1 - Mozilla     Netscape Browser
  391.           2 - WebExplorer IBM WebExplorer/2
  392.           3 - WebCrawler  WebCrawler robot
  393.           4 - InfoSeek    InfoSeek robot
  394.           5 - Harvest     webov∞ robot
  395.           6 - Mosaic      NCSA Mosaic
  396.           7 - Lynx        Lynx, text browser
  397.           8 - PRODIGY-WB  Prodigy browser
  398.           9 - Microsoft Internet Explorer
  399.  
  400.       P²íklad:
  401.         CHAM 2    Poτle User-Agent: WebExplorer
  402.  
  403. CHANGESITE <poƒet míst>
  404.      Normáln╪  pokud  najde WWWGrab/2 v HTM* souboru odkaz na jin∞ server,
  405.      ignoruje  jej.  Pokud  chcete  povolit  zm╪nu  serverà  màºete pouºít
  406.      CHANGESITE.   Poƒet  míst  definuje  maximální  poƒet  zm╪n  serverà.
  407.      Standardní  hodnota  je  0  - nem╪nit server. Také p²i pouºívání této
  408.      volby je t²eba jisté opatrnosti, aby nedoτlo k ozrcadlení celého WWW.
  409.  
  410.      P²íklad:
  411.        CHANGESITE 2
  412.  
  413. CLIENT
  414.      P²i pouºití volby CLIENT jsou vτechny absolutní linky p²evedeny na
  415.      linky relativní, vhodné pro prohlíºení na lokálním poƒítaƒi. To
  416.      znamená, ºe pokud v souboru bude odkaz
  417.      <A HREF="/www/soubor/blbost.html"> nahrazen odkazem
  418.      <A HREF="blbost.html">. Pouºijte tuto volbu pokud si chcete prohlíºet
  419.      staºené soubory lokáln╪. (Poznámka:  Server-side-include,  CGI  nebude
  420.      a JAVA nemusí pracovat správn╪ p²i lokálním prohlíºení, pokud poºadují
  421.      HTTP server).
  422.  
  423. DEFAULTNAME <jméno>
  424.      Obƒas  odkazy  ukazují  na adresá² a ne na soubor. V tomto p²ípad╪ se
  425.      pouºije   jméno  uvedené  v  DEFAULTNAME.  P²ednastavená  hodnota  je
  426.      "index.html".
  427.  
  428.      P²íklad:
  429.        DEFAULTNAME Welcome.html
  430.  
  431. DENY <URL-v-http-formátu>
  432.      Pokud nechcete stahovat vτehny soubory zadaného URL nebo daná "v╪tev"
  433.      není  dostupná, , màºete neºádoucí cesty specifikovat tímto p²íkazem.
  434.      Màºe b∞t pouºit vícekrát.
  435.  
  436.      P²íklad:
  437.        DENY http://www.xxx.yyy/zakaz/tuto/cestu/
  438.  
  439.      Pokud neuvedete na konci URL '/' (tj. zadáte pouze
  440.      http://www.xxx.yyy/zakaz/tuto/cestu) potom vτechny cesty|soubory
  441.      zaƒínající  na  "cestu"  budou  ignorovány.  Nap²íklad: "cestuj/tam",
  442.      "cestující.html" apod.
  443.  
  444. DO <DEF | HTML | IMG | SND> <NOTHING | p²íkaz>
  445.      Tento p²íkaz vám umoºní provád╪t p²íkaz pro kaºd∞ úsp╪τn╪ staºen∞
  446.      soubor. Pro kaºd∞ typ souboru màºete zadat jin∞ p²íkaz. Pokud danému
  447.      typu souboru není p²i²azen ºádn∞ p²íkaz, provede se p²íkaz definovan∞
  448.      jako DEF (tj. p²edvolen∞). Na p²íkazové ²ádce màºete pouºít následující
  449.      volby:
  450.  
  451.          %d úroveσ vno²ení
  452.          %h hostitel (www server)
  453.          %l celé jméno souboru na lokálním disku
  454.          %p rodiƒovské URL (udkud byl odkaz vyvolán)
  455.          %r jméno souboru (URL bez hostitele)
  456.          %t ƒas vytvo²ení/modifikace ve formátu RFC 822
  457.          %u URL
  458.          %% % (prost╪ procento)
  459.  
  460.      POZN╡MKA: Pouºívání '%' voleb se nedoporuƒuje, vhodn╪jτí je pouºít
  461.      p²eddefinovaná makra. Bliºτí informace najdete v ƒástech "Makra"
  462.      a "P²eddefinovaná makra".
  463.  
  464.  
  465.      Pokud nechcete pro zvolen∞ typ souboru provád╪t ºádnou akci, ale
  466.      pot²ebujete mít definovan∞ DEF p²íkaz, zadejte jako p²íkaz NOTHING.
  467.      Povolené typy jsou:
  468.          HTML - soubor definovan∞ v hlaviƒce jako text/*
  469.          IMG  - soubor definovan∞ v hlaviƒce jako image/*
  470.          SND  - soubor definovan∞ v hlaviƒce jako audio/*
  471.          DEF  - libovoln∞ soubor
  472.  
  473.      P²íkazy které jsou spouτt╪ny souƒasn╪ s WWWGrab/2 mohou PⁿET╓ªIT váτ
  474.      systém. Za souƒasn╪ spouτt╪né aplikace jsou povaºovány ty p²íkazy,
  475.      které zaƒínají p²íkazem "start".
  476.  
  477.      P²íklad:
  478.        DO HTML start /b html2txt %l
  479.        ; spustí html2txt na pozadí pro kaºd∞ HTML soubor
  480.        DO SND play file=%l
  481.        ; p²ehraje kaºd∞ staºen∞ zvukov∞ soubor
  482.        DO IMG NOTHING
  483.        ; ned╪lá nic s obrázky
  484.        DO DEF echo %u >> ostatni.soubory
  485.        ; ostatní soubory zapíτe do log souboru
  486.  
  487. EXCL <www-server>
  488.      Definuje  www-server(y),  které  se nebudou stahovat. Tento p²íkaz je
  489.      pouºiteln∞ spolu s p²íkazem CHANGESITE. Màºe b∞t pouºito vícekrát.
  490.  
  491.      P²íklad:
  492.        EXCL www.xxx.yyy
  493.        EXCL microsoft.is.lame.org      ; BTW: zkuste toto URL:-)
  494.  
  495.  
  496. EXTENSIONS <seznam p²ípon>
  497.      Extensions definuje seznam p²ípon, které budou zahrnuty do zpracování.
  498.      Ostatní p²ípony budou ignorovány. P²ípony se odd╪lují mezerou nebo
  499.      tabulátorem. Pokud ºádné p²ípony nezadáte, budou automaticky
  500.      nadefinovány p²ípony HTM, HTML, SHTM, SHTML, JPG, GIF, WAV, AU, CLASS a
  501.      JAVA.  Màºete pouºít znaku ':' jako negaƒního operátoru u p²ípon které
  502.      nechcete stahovat.  U tohoto p²íkazu je pot²eba b∞t opatrn∞!  Uvedením
  503.      p²ípony EXE  nebo ZIP màºete ozrcadlit kompletn╪ cel∞ HOBBES! U tohoto
  504.      p²íkazu màºete pouºít nahrazovací v∞razy.
  505.  
  506.      P²íklad:
  507.        EXTENSIONS ZIP C
  508.          Stáhne soubory s p²íponami C a ZIP.
  509.  
  510.        EXTENSIONS ZIP JAVA :C??
  511.          Stáhne soubory s p²íponou ZIP a JAVA, ale ne C++, C--, C00.
  512.  
  513. FAT
  514.      Tato  volba  zapíná  FAT  kompatibilní  mód. V tomto reºimu WWWGrab/2
  515.      ukládá vτechny soubory do jednoho adresá²e s vyuºitím formátu FAT 8.3
  516.      jmen  souborà.  Vτechny linky jsou automaticky upravovány. Tato volba
  517.      je  automaticky  zapnuta  pokud je LOCALPATH nastavena na FATov∞ disk
  518.      nebo na disk bez podpory dlouh∞ch jmen souborà.
  519.  
  520. FIXSL
  521.      N╪kte²í  auto²i webov∞ch stránek obƒas nep²idávají koncová lomítka na
  522.      konec odkazà. Proti jejich zapomn╪tlivosti lze pouºít volbu FIXSL.
  523.  
  524. HUP <min>
  525.      Pomocí p²íkazu HUP màºete urƒit ƒas v minutách, jako dlouho bude
  526.      WWWGrab/2 pracovat. Po dosaºení ƒasového limitu se WWWGrab/2 ukonƒí.
  527.      Pokud se zrovna p²enáτí n╪jak∞ soubor, ukonƒí se WWWGrab/2 aº po
  528.      dokonƒení p²enosu souboru.
  529.  
  530.      P²íklad:
  531.        HUP 90
  532.        WWWGrab/2 bude pracovat 90 minut a pak se ukonƒí.
  533.  
  534. HUPF <soubor>
  535.      Tímto p²íkazem ²íkáte WWWGrab/2 o vytvo²ení zadaného souboru p²i jeho
  536.      návratu do operaƒního systému.
  537.  
  538.      P²íklad:
  539.       HUPF c:\work\wwwhup.
  540.       P²i návratu do operaƒního systému vytvo²í WWWGrab/2 soubor
  541.       c:\work\wwwhup.
  542.  
  543. I401
  544.      Pokud WWWGrab/2 poτle podmín╪n∞ poºadavek na staºení chrán╪né stránky
  545.      a tato stránka nebyla modifikována, vrací n╪které servery stavov∞ kód
  546.      401  (neautorizovan∞  p²ístup).  Pokud  chcete  tento stav ignorovat,
  547.      pouºijte  tuto volbu. (Má v∞znam pouze u registrované verze. V ºádném
  548.      p²ípad╪ neobchází autorizaci!)
  549.  
  550. INCLUDE <soubor>
  551.      Tento  p²íkaz  umoºσuje vloºit jin∞ konfiguraƒní soubor do aktuálního
  552.      konfiguraƒního  souboru.  Vno²ování  je  povoleno maximáln╪ do ƒtvrté
  553.      úrovn╪.  Tento p²íkaz je pouºiteln∞ pro ƒasto se opakující p²íkazy ve
  554.      íce konfiguraƒních souborech. Viz. také '@' soubory.
  555.  
  556.      P²íklad:
  557.        INCLUDE realms.inc
  558.        INCL    urls.inc
  559.  
  560. IRO
  561.      N╪které WWW servery pouºívají soubory, které prohledávaƒàm a ostatním
  562.      automaticky pracujícím programàm jako nap². WWWGrab/2 které soubory
  563.      mohou (nebo také nemohou) stahovat. Normáln╪ si WWWGrab/2 p²i prvním
  564.      p²ístupu na server vyºádá tento soubor a pouºívá jej p²i ztahování
  565.      souborà. Pokud si p²ejete ignorovat tento soubor, pouºijte volbu
  566.      IRO. WWWGrab/2 potom stáhne vτechny soubory (samoz²ejm╪ podle
  567.      nastavení v konfiguraƒním souboru).
  568.  
  569. ISO9660
  570.      Touto volbou ²íkáte WWWGrab/2, aby ukládal soubory ve formátu jmen
  571.      souborà dle normy ISO9660, která se pouºívá na CDƒkách. Volba ISO9660
  572.      povolí ve jmén╪ souboru pouze velká písmena, ƒíslice a podtrºítko.
  573.      Délka jména je osm znakà + t²i znaky p²ípona.
  574.  
  575.  
  576.  
  577. LOCALPATH <cesta>
  578.      Cesta  na  lokálním  poƒítaƒi,  pod kterou se bude vytvá²et zrcadlená
  579.      struktura   adresá²à.   Pokud   není   parametr  uveden,  pouºije  se
  580.      \WWWGrab\Grab\.
  581.  
  582.      P²íklad:
  583.        LOCALPATH F:\GRAB\IBM\
  584.  
  585. LOG <log-soubor> <log-²et╪zec>
  586.      Tento p²íkaz umoºσuje zapsat do souboru <log-soubor> vτechny úsp╪τn╪
  587.      staºené soubory ve formátu <log-²et╪zec>, kter∞ vám vyhovuje. Ve
  588.      formátovacím ²et╪zci màºete pouºít následující speciální znaky:
  589.  
  590.          %d úroveσ vno²ení
  591.          %h hostitel (www server)
  592.          %l celé jméno souboru na lokálním disku
  593.          %p rodiƒovské URL (udkud byl odkaz vyvolán)
  594.          %r jméno souboru (URL bez hostitele)
  595.          %t ƒas vytvo²ení/modifikace ve formátu RFC 822
  596.          %u URL
  597.          %% % (prost╪ procento)
  598.          \n nov∞ ²ádek
  599.          \t tabulátor
  600.          \\ \ (zp╪tné lomítko)
  601.  
  602.      POZN╡MKA: P²íkaz LOG nep²idává automaticky CRLF na konec kaºdého
  603.                ²et╪zce.
  604.  
  605.      P²íklad:
  606.        LOG test.log URL je ulozen v %l\n
  607.        V∞sledek bude:
  608.          URL http://www/index.html je ulozen v \grab\www\index.html
  609.          URL http://www/foo/foo.gif je ulozen v \grab\www\foo\foo.gif
  610.          ...
  611.  
  612. MAP
  613.      Tato volba zapne vytvá²ení souborové mapy. Tento soubor je pojmenován
  614.      jako w3gmap.htm. Mapa obsahuje mapu ozrcadleného serveru. Tento soubor
  615.      màºete pozd╪ji k ruƒnímu stahování souborà.
  616.  
  617. MASK <maska souborà>
  618.      S  pomocí  tohoto  p²íkazu  màºete  specifikovat  jaké soubory chcete
  619.      vlastn╪  ze  serveru  stahovat.  Tento  p²íkaz  p²episuje veτkerá
  620.      nastavení  p²íkazu  EXTENSIONS.  Z  toho plyne, ºe je nutné definovat
  621.      masku  i  pro  HTML  soubory!  Tento p²íkaz màºete pouºít vícekrát. V
  622.      masce  lze  pouºít  nahrazovací  v∞razy. Viz. p²edchozí ƒást
  623.      "Nahrazovací v∞razy".
  624.  
  625.      P²íklad:
  626.        MASK *.jpg
  627.          Stáhne vτechny soubory s koncovkou jpg.
  628.  
  629.        MASK ?a*.html
  630.          Stáhne vτechny soubory zaƒínající libovoln∞m znakem,
  631.          následovan∞m 'a', za kter∞m màºe b∞t libovoln∞ poƒet
  632.          jak∞chkoliv znakà a konƒících na '.html', nap²íklad:
  633.            zaphod.html, 0a.html, atd.
  634.  
  635.        MASK *.jpg s?n.htm* do*s.large.i*x
  636.          Stáhnou se soubory:
  637.             one.jpg, two.jpg, sin.htm, son.htm, sun.html, dogs.large.idx,
  638.             doorways.large.index, atd...
  639.  
  640.        MASK *.jp*g chapter[0-4].htm*
  641.          Stáhne libovoln∞ jpg a jpeg soubor a chapter0.htm, chapter1.htm,
  642.      chapter0.html, chapter1.html, chapter2.htm, chapter3.html, ale ne
  643.      chapter5.html.
  644.  
  645.      [Vhodné na stahování ƒesky kódovan∞ch stránek rozliτovan∞ch
  646.       p²í|p²edponou, jako win*.htm*]
  647.  
  648. MAXDEEP <úroveσ>
  649.      Definuje maximální úroveσ vno²ení pro zrcadlení. Stránky vno²ené níºe
  650.      budou ignorovány.
  651.  
  652.      P²íklad:
  653.        MAXDEEP 5
  654.        Stáhne http://www.foo.com/1/2/3/4/5/file.html , ale ne
  655.        http://www.foo.com/1/2/3/4/5/6/file.html
  656.  
  657.      POZN╡MKA: Sharewarová verze je limitována na 5 úrovní.
  658.  
  659. MAXDL <limit>
  660.      Definuje  maximální  celkovou  velikost  staºen∞ch souborà v kB. Kdyº
  661.      WWWGrab/2  nahrává  soubor  na  disk, kontroluje jeho délku. Pokud by
  662.      délka  souboru  p²esáhla  limit  zadan∞  v  MAXDL, bude jej WWWGrab/2
  663.      ignorovat.
  664.  
  665.      P²íklad:
  666.        MAXDL 3  stáhne maximáln╪ 3kb
  667.  
  668. MAXFSIZE <Velikost-souboru-v-kb>
  669.      Tímto p²íkazem màºete definovat nejdelτí staºiteln∞ soubor v
  670.      kilobajtech. Soubor v╪tτí neº MAXFSIZE bude ignorován. tento p²íkaz
  671.      nepracuje správn╪ se servery, které nevracejí délku obsahu souboru.
  672.  
  673.      P²íklad:
  674.        MAXFSIZE 100
  675.        Nebude stahovat soubory v╪tτí neº 100 kilobajtà.
  676.  
  677.  
  678. MAXTRIES <poƒet>
  679.      MaxTries  definuje  poƒet  pokusà k získání souboru. WWWGrab/2 zkouτí
  680.      stáhnout  vτechny soubory. Pokud není moºné soubor stáhnout, je tento
  681.      ignorován,  dokud  není  zpracován  cel∞  strom.  Následn╪  WWWGrab/2
  682.      kontroluje, zda doτlo ke staºení celého stromu. Pokud k tomu nedoτlo,
  683.      opakuje tuto operaci <poƒet> krát.
  684.  
  685.      P²íklad:
  686.        MAXTRIES 3
  687.  
  688.  
  689. METAFILE <jméno souboru>
  690.      Tento   p²íkaz  definuje  soubor,  do  kterého  si  WWWGrab/2  ukládá
  691.      informace  o  staºen∞ch  souborech.  Standardní  jméno  je META.DAT a
  692.      soubor je uloºen v adresá²i LOCALPATH\%host%.
  693.  
  694.      P²íklad:
  695.        METAFILE data.met
  696.  
  697. NICE [ƒas v sekundách]
  698.      Tento  p²íkaz  definuje  pauzu mezi jednotliv∞mi poºadavky na staºení
  699.      souboru,  aby  nedoτlo  k  zahlcení  systému,  kter∞ zrcadlíte. Pokud
  700.      neuvedete ºádnou hodnotu, pouºije WWWGrab/2 prodlevu 10 sekund. Pokud
  701.      tento  p²íkaz  nepouºijete  vàbec,  nastaví  se  prodleva  5  sekund.
  702.      Upozorn╪ní:  Jelikoº  WWWGrab/2  màºe  generovat  hodn╪  poºadavkà za
  703.      minutu, nemusí to n╪které WWW servery p²eºít. Jde zejména o tyto typy
  704.      serverà:
  705.  
  706.          Vτechny WWW servery které b╪ºí pod Microsoft Windows(TM)
  707.          Stará generace (HTML/1.0) CERN serverà na vτech platformách
  708.  
  709.      Nízká  hodnota màºe t麠zv∞τit zatíºení sít╪ a sí£ov∞ch prost²edkà. Z
  710.      t╪chto  dàvodà  by m╪lo b∞t nastaveno minimáln╪ p╪t sekund (ƒím více,
  711.      tím lépe). Nezapomeσte, ºe tento program màºe b╪ºet n╪kolik hodin...
  712.  
  713.      P²íklad:
  714.        NICE 5
  715.  
  716. NOAPPLET, NOIMG, NOOTH, NOSND, NOVID
  717.      Kaºd∞ stahovan∞ soubor obsahuje v hlaviƒce poloºku "Content-type",
  718.      která urƒuje typ stahovaného souboru (aplikace, zvuk, video, text,
  719.      obrázky nebo cokoli jiného). Následující volby vám umoºní vypnout
  720.      stahování urƒitého typu souborà:
  721.  
  722.      NOAPPLET
  723.         Tuto volbu pouºijte, pokud nechcete stahovat java aplety.
  724.  
  725.      NOIMG
  726.         P²i pouºití této volby se nebudou stahovat obrázky.
  727.  
  728.      NOOTH
  729.         Nebudou se stahovat "ostatní" soubory (tj. ty které nejsou
  730.         typu aplikace, text, obrázek, video nebo zvuk).
  731.  
  732.      NOSND
  733.         P²i pouºití této volby se nebudou stahovat zvuky.
  734.  
  735.      NOVID
  736.         P²i pouºití této volby se nebudou stahovat video soubory.
  737.  
  738.  
  739. OHTML
  740.      Kombinuje v∞τe uvedené p²íkazy NOIMG, NOSND, NOOTH, NOVID a NOAPPLET.
  741.  
  742. PPORT <proxy port>
  743.      Tato  volba  definuje  port  proxy serveru. Standardní hodnota je 80.
  744.      Volba je úƒinná pouze pokud je specifikovaná volba PROXY.
  745.  
  746.      P²íklad:
  747.        PPORT 8080
  748.  
  749. PROXY <server>
  750.      Tuto  volbu  vyuºijete,  jestliºe máte p²ístup na internet p²es proxy
  751.      server/cache.  <server>  màºe  b∞t  uveden bu╘ pln∞m doménov∞m jménem
  752.      (t.j. proxy.foo.com), nebo IP adresou. Pokud si nejste jist, zda jste
  753.      p²ipojen p²es proxy, informujte se u svého systémového administrátora
  754.      nebo poskytovatele p²ipojení k internetu.
  755.  
  756.      P²íklad:
  757.        PROXY www.proxy.server
  758.        PROXY 123.456.789.10
  759.  
  760.  
  761. PROXYAUTH <base64>
  762.      Tuto volbu pouºijte pokud máte p²ístup k Internetu chrán╪n∞
  763.      zaheslovan∞m proxy serverem.
  764.  
  765.      P²íklad:
  766.        PROXY     chranena.proxy.cz
  767.        PROXYAUTH LTot
  768.  
  769. REALM <host> <"Realm Name"> <zakódované jméno a heslo>
  770.      Definuje  zaheslovan∞  server,  "realmname"  (pojmenování zaheslované
  771.      ƒásti,  'realmname'  je  kratτí...)  a zakódované jméno+heslo (pomocí
  772.      base64).  Realmname  musí  b∞t  uvedeno  v  uvozovkách a rozliτují se
  773.      velká/malá  písmena!  Pokud  realmname neznáte vloºte prázdn∞ ²et╪zec
  774.      (t.j.  ""),  p²ípadn╪  si  zkuste  prohlédnout WWWGRAB.LOG. <host> je
  775.      server   chrán╪n∞   pomocí  basic-auth,  a  to  bu╘  jako  IP  adresa
  776.      (11.22.33.44),  nebo  v  doménovém  formátu (www.foo.com). Zakódované
  777.      jméno  a  heslo  je  generováno pomocí programu makeauth. Pro vloºení
  778.      vygenerovaného  jména  a  hesla  màºete  pouºí  p²íkaz INCLUDE. Tento
  779.      p²íkaz màºe b∞t uveden vícekrát.
  780.  
  781.      P²íklad:
  782.        REALM www.secured.host "Toto je ReaLmName" LTot
  783.  
  784. REMOVE
  785.      Tato  volba zapíná odstraσování nepouºit∞ch odkazà ze stránek. Odkazy
  786.      nejsou ze souboru vymazány, ale pouze zakomentovány.
  787.  
  788.  
  789. REPL <cesta>
  790.      Udává cestu, kterou bude p²epsána LOCALPATH v novém odkazu. Nap²íklad
  791.      vloºte "REPL /mirrors" a LOCALPATh bude definována jako
  792.      F:\OS2Httpd\HTML\Grab\, odkaz v HTML dokumentu bude
  793.      "<A HREF="/some/pages/index.html"> link </a>", jméno ukládaného
  794.      souboru bude "F:\OS2Httpd\HTML\GRAB\www.foo.com\some\pages\index.html".
  795.      Potom opraven∞ odkaz ve v∞sledném souboru bude:
  796.      "/mirrors/www.foo.com/some/pages/index.html"
  797.  
  798.      P²íklad:
  799.        REPL /mirrors
  800.  
  801. SITELIST <WWW Server(y)>
  802.      Normáln╪  pokud  najde WWWGrab/2 v HTM* souboru odkaz na jin∞ server,
  803.      ignoruje  jej.  Pokud  chcete  povolit  zm╪nu  serverà  màºete pouºít
  804.      SITELIST se seznamem povolen∞ch WWW serverà. Op╪t lze pouºít znak ':'
  805.      jako  operátor  'NE'. Tento p²íkaz màºe b∞t pouºít vícekrát. SITELIST
  806.      má vyττí prioritu neº CHANGESITE.
  807.  
  808.      P²íklad:
  809.        SITELIST www.xxx.yyy
  810.        SITELIST :www.xxx.yyy -> Vτechna www místa s v∞jimkou www.xxx.yyy
  811.  
  812. SWSLASH
  813.      Tato  volba  prohazuje  "levá"  lomítka za "pravá", tj. z '/' na '\'.
  814.      Toto je pouºitelné se starτími|hloup╪jτími prohlíºeƒi.
  815.  
  816. TIMC <sec>
  817.      P²íkaz TIMC urƒuje hodnotu do které musí obdrºet zprávu od WWW serveru,
  818.      ºe doτlo k p²ipojení. Pokud ji do této doby neobdrºí dojde k ukonƒení
  819.      komunikace mezi serverem a WWWGrab/2. Tayo hodnota musí b∞t menτí nebo
  820.      rovna TIMP a v╪tτí neº 10 sekund. Nepouºívejte tuto volbu, pokud nevíte
  821.      co vlastn╪ d╪láte. standardní hodnota 60 sekund je dostaƒující.
  822.  
  823.      P²íklad:
  824.        TIMC 100
  825.  
  826.  
  827. TIMP <sec>
  828.      Definuje dobu, do které musí p²ijít ze serveru paket. Spojení je
  829.      p²eruτeno p²i p²ekroƒení této doby. Hodnota musí b∞t v╪tτí neº 10.
  830.      Nepouºívejte tento p²íkaz, pokud to není nezbytn╪ nutné!
  831.  
  832.      P²íklad:
  833.        TIMP 120
  834.  
  835. TOP <url-v-http-formátu>
  836.      Definuje  vrchol  cesty.  WWWGrab/2  bude ignorovat soubory nad touto
  837.      cestou, jinak ²eƒeno, cesta musí obsahovat tento ²et╪zec. S tímto
  838.      p²íkazem màºete pouºít nahrazovací v∞razy a p²íkaz màºe b∞t pouºit více
  839.      neº jedenkrát.
  840.  
  841.      P²íklad:
  842.        TOP  http://www.foo.com/cesta/xxxx/
  843.        Ignoruje soubory nad /cesta/xxxx/, t.j.  /cesta/nejaky.soubor na
  844.        serveru www.foo.com
  845.  
  846.      POZN╡MKA: Zm╪na syntaxe oproti p²edchozí verzi!!!
  847.  
  848.  
  849. URL <url-v-http-formátu>
  850.      Kompletní  URL  místa,  které  chcete
  851.      zrcadlit.  Je  nutné  uvád╪t i "http:". Màºe b∞t pouºito vícekrát k
  852.      ozrcadlení více serverà. Toto je základní p²íkaz.
  853.  
  854.     P²íklad:
  855.       URL http://www.geocities.com/SiliconValley/Heights/7262/index.html
  856.  
  857.  
  858. Seznam p²íkazà - Struƒn∞ popis
  859. ------------------------------
  860. Následuje struƒn∞ popis vτech p²ibliºn╪ 50 p²íkazà a voleb slouºících k
  861. ovládání WWWGrab/2.
  862.  
  863. ADD <cesta>           P²idá zadanou cestu k seznamu poºadovan∞ch URL.
  864. ALL                   Stáhne soubory bez závislosti na jejich datu.
  865. ALLOW <URL>           Explictn╪ povolí v╪tev ke staºení.
  866. CHAM <ƒíslo>          Maskuje jméno klienta (chameleon).
  867. CHANGESITE <ƒíslo>    Následuje <ƒíslo> odkazà na jiné servery.
  868. CLIENT                M╪ní odkazy na relativní kvàli lokálnímu prohlíºení.
  869. DEFAULTNAME <jméno>   Nastaví standardní jméno HTML souborà pro adresá²e.
  870. DENY <URL>            Zakáºe stahování stromu pod <URL>.
  871. DO <option> <p²íkaz>  Provede <p²íkaz> s DEF|HTML|IMG|SND souborem.
  872. EXCL <server>         Vynechá WWW server ze stahování.
  873. EXTENSIONS <seznam>   Povolené p²ípony ke stahování.
  874. FAT                   Kompatibilita se souborov∞m systémem FAT.
  875. FIXSL                 P²idává lomítka na konec odkazu, pokud tam chybí.
  876. HUP <min>             Omezení doby ƒinnosti WWWGrab/2.
  877. HUPF <soubor>         Vytvo²í zadan∞ soubor p²i návratu do OS.
  878. I401                  Ignoruje chybu 401 a umoºní staºení souboru.
  879. IRO                   Ignoruj soubor s restrikcemi pro "roboty".
  880. ISO9660               Zapne pojmenovávání souborà dle ISO 9660.
  881. INCLUDE <soubor>      Vloºí konfiguraƒní soubor <soubor> do aktuálního.
  882. LOCALPATH <cesta>     Adresá² na disku do kterého se bude zrcadlit.
  883. LOG <soubor> <formát> Zapisuje do <soubor> ve formátu <formát>.
  884. MAP                   Vytvo²í HTML mapu zrcadleného serveru.
  885. MASK <maska>          Explicitn╪ definuje masku souborà ke staºení.
  886. MAXDEEP <vno²ení>     Definuje maximální úroveσ vno²ení.
  887. MAXDL <limit>         Maximum kilobajtà ke staºení.
  888. MAXFL <velikost>      Maximální velikost souboru ke staºení.
  889. MAXTRIES <poƒet>      Maximální poƒet pokusà o staºení.
  890. METAFILE <soubor>     Specifikuje jméno metasouboru.
  891. NICE <sekund>         Pauza <sekund> mezi jednotliv∞mi stahováními.
  892. NOAPPLET              Nebrat applety.
  893. NOIMG                 Nebrat obrázky.
  894. NOOTH                 Nestahovat "ostatní" soubory.
  895. NOSND                 Nestahovat zvukové soubory.
  896. NOVID                 Nestahovat video soubory.
  897. OHTML                 Kombinuje NOIMG, NOSND, NOOTH, NOVID a NOAPPLET.
  898. PPORT <port>          Udává proxy port.
  899. PROXY <hostname>      Definuje proxy server.
  900. PROXYAUTH <base64>    Definuje proxy autorizaci.
  901. REALM <h> <rlm> <pw>  Definuje chrán╪n∞ server, realm a uºivatele/heslo.
  902. REMOVE                Odstraní nepouºité odkazy z HTML souborà.
  903. REPL <cesta>          Zam╪ní lokální odkazy na <cesta>.
  904. SITELIST <server>     Povolí stahování také ze <server>.
  905. SWSLASH               Zam╪σuje levá lomítka za pravá.
  906. TIMC <sec>            Doba na p²ipojení k serveru.
  907. TIMP <sec>            Doba na p²ijetí paketu.
  908. TOP <URL>             Definuje vrchol cesty (netahuje se nic nad..).
  909. URL <URL>             URL serveru kter∞ chcete zrcadlit.
  910.  
  911.  
  912. Referenƒní tabulka p²íkazà a voleb
  913. ----------------------------------
  914.  
  915. Pⁿ╓KAZ        ZKRATKA   '@'    STDKFG  PⁿEPISUJE  STDHOD   REX  REG  V╓CE
  916. --------------------------------------------------------------------------
  917. ADD                     ANO    NE                          NE   NE   ANO
  918. ALL                     NE     NE                          NE   NE   NE
  919. ALLOW                   ANO    NE                          ANO  ANO  ANO
  920. CHAM                    NE     ANO                0        NE   NE   NE
  921. CHANGESITE    CHSIT     NE     NE                 0        NE   ANO  NE
  922. CLIENT                  NE     ANO                         NE   NE   NE
  923. DEFAULTNAME   DEF       NE     ANO                [3]      NE   ANO  NE
  924. DENY                    ANO    NE                          ANO  ANO  ANO
  925. DO                      NE     ANO                         NE   ANO  NE
  926. EXCL                    ANO    NE                          ANO  NE   ANO
  927. EXTENSIONS    EXT       ANO    ANO                [1]      ANO  ANO  ANO
  928. FAT                     NE     ANO                         NE   NE   NE
  929. FIXSL                   NE     ANO                         NE   NE   NE
  930. HUP                     NE     ANO                         NE   NE   NE
  931. HUPF                    NE     ANO                         NE   NE   NE
  932. I401                    NE     ANO                         NE   NE   NE
  933. INCLUDE       INCL      NE     NE                          NE   NE   ANO
  934. IRO                     NE     ANO                         NE   ANO  NE
  935. ISO9660                 NE     ANO                         NE   NE   NE
  936. LOCALPATH     LOP       NE     ANO                [0]      NE   NE   NE
  937. LOG                     NE     ANO                         NE   ANO  NE
  938. MAP                     NE     ANO                         NE   NE   NE
  939. MASK                    ANO    ANO     EXTENSIONS          ANO  ANO  ANO
  940. MAXDEEP       MDP       NE     ANO                1        NE   [2]  NE
  941. MAXDL                   NE     ANO                         NE   NE   NE
  942. MAXFL                   NE     ANO                         NE   NE   NE
  943. MAXTRIES      MTR       NE     ANO                         NE   NE   NE
  944. METAFILE      META      NE     NE                          NE   NE   NE
  945. NICE                    NE     ANO                10       NE   NE   NE
  946. NOAPPLET      NOAP      NE     ANO                         NE   NE   NE
  947. NOIMG                   NE     ANO                         NE   NE   NE
  948. NOOTH                   NE     ANO                         NE   NE   NE
  949. NOSND                   NE     ANO                         NE   NE   NE
  950. NOVID                   NE     ANO                         NE   NE   NE
  951. OHTML                   NE     ANO     [4]                 NE   NE   NE
  952. PPORT                   NE     ANO                80       NE   NE   NE
  953. PROXY                   NE     ANO                         NE   NE   NE
  954. PROXYAUTH               NE     ANO                         NE   NE   NE
  955. REALM                   NE     NE                          NE   ANO  ANO
  956. REMOVE                  NE     ANO                         NE   ANO  NE
  957. REPL                    NE     ANO                         NE   ANO  NE
  958. SITELIST      SLIST     ANO    NE      CHANGESITE          NE   ANO  ANO
  959. SWSLASH                 NE     ANO                         NE   NE   NE
  960. TIMC                    NE     ANO                60       NE   NE   NE
  961. TIMP                    NE     ANO                60       NE   NE   NE
  962. TOP                     NE     NE                          ANO  NE   ANO
  963. URL                     ANO    NE                          NE   NE   ANO
  964.  
  965. [0] - \WWWGrab\Grab
  966. [1] - HTM, HTML, SHTM, SHTML, JPG, GIF, WAV, AU, CLASS, a JAVA
  967. [2] - Sharewarová verze WWWGrab/2 je limitována na 5 úrovní.
  968. [3] - "index.html". Pro sharewarovou verzi je to nem╪nné.
  969. [4] - Kombinuje NOIMG, NOSND, NOVID, NOOTH a NOAPPLET.
  970.  
  971.  
  972. STDKFG - Standardní konfiguraƒní soubor
  973. STDHOD - Standardní hodnota
  974. REG    - Pouze registrovaná verze
  975. REX    - Nahrazovací v∞razy
  976.  
  977.  
  978. P²eddefinovaná makra
  979. --------------------
  980. WWWGrab/2 definuje n╪kolik standardních maker. Následující makra zavisí
  981. na pouºitém operaƒním systému:
  982. __OS2__
  983. __NT__
  984. __UNIX__
  985.  
  986. Makro OS obsahuje jednu z následujících hodnot, v závislosti na ppuºitém
  987. operaƒním systému v dob╪ b╪hu programu:
  988.  
  989. OS/2
  990. Windows NT|95
  991. Linux
  992.  
  993. SEM     St²edník (;)
  994. VER     verze WWWGrab/2
  995. UHTP    "URL http://"
  996. LHOST   Jméno lokálního poƒítaƒe
  997.  
  998. URL     Stahované URL            (%u)
  999. LFILE   Lokální soubor           (%l)
  1000. TIME    ¼as souboru              (%t)
  1001. HOST    Vzdálen∞ hostitel        (%h)
  1002. DEPTH   Aktuální úroveσ vno²ení  (%d)
  1003. PARENT  Rodiƒ aktuálního URL     (%p)
  1004. RFILE   Jméno souboru na serveru (%r)
  1005.  
  1006. Pokud moºno, pouºívejte nov╪ definované prom╪nné namísto '%' p²íkazà.
  1007.  
  1008. P²íklady
  1009. --------
  1010. P²íklad autorizace:
  1011.      URL http://www.sec1.host/secured/pages/index.html
  1012.      LOCALPATH \MyGrab\Secured
  1013.      MAXDEEP 5
  1014.      MAXTRIES 3
  1015.      REALM www.sec1.host "Realm 1" WAEFfgSDRGwer==
  1016.      REALM www.sec1.host "Realm 2" WQREGFbsdgiwheg
  1017.  
  1018.  
  1019. P²íklad konfiguraƒního souboru DEFAULT.W3G:
  1020.  
  1021. ;; Definice spoleƒn∞ch p²ípon
  1022. ;
  1023. EXTENSIONS HTML HTM SHTML SHTM
  1024. EXTENSIONS JPG JPEG GIF XBM
  1025. EXTENSIONS WAV VOC AU
  1026. EXTENSIONS JAVA CLASS
  1027.  
  1028. ;
  1029. ;; Standardní hodnota pro p²íkaz MAXDEEP
  1030. ;
  1031. MAXDEEP 5
  1032.  
  1033. ;
  1034. ;; standardní hodnota pro p²íkaz NICE
  1035. ;
  1036. NICE 3
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042. Pod╪kování
  1043. ----------
  1044.      Cht╪l bych pod╪kovat vτem lidem, kte²í testovali WWWGrab/2 a posílali
  1045. mi  detailní  popisy  chyb, vτem t╪m, kte²í mi posílali nápady na zlepτení
  1046. programu.  Bez  jejich  pomoci  by  nebyl WWWGrab/2 na takové úrovni a tak
  1047. úsp╪τn∞.
  1048.  
  1049. Speciální pod╪kování pat²í t╪mto lidem:
  1050.  
  1051.    * Tom Wheeler
  1052.    * Andreas Krattenmacher
  1053.    * Mike Nice
  1054.    * Stanislav Koƒí (St/\n)
  1055.    * Jochen Riemer
  1056.    * Fernando Cassia
  1057.    * Vincent Bernat
  1058.  
  1059.      Tom  Wheeler  si  zaslouºí  speciální  pod╪kování  za  jeho pomoc p²i
  1060. kontrole dokumentace v angliƒtin╪.
  1061.  
  1062. Pod╪kování za p²eklady:
  1063. Fernando Cassia za p²eklad µpan╪lτtiny fcassia@theoffice.net).
  1064. http://ourworld.compuserve.com/homepages/fcassia/sos2.htm
  1065.  
  1066. Vincent Bernat za p²eklad do Francouτtiny (bernat@mail.dotcom.fr).
  1067. http://w.home.ml.org ou http://www.mygale.org/07/www/
  1068.  
  1069.      HELLOWEEN, GAMMA RAY, Michael Kiske, MANOWAR, Alice Cooper, GREEN DAY
  1070. a ostaním hudebníkàm, za jejich hudební podporu p²i mém programování.
  1071.  
  1072. --------------------------------------------------------------------------
  1073. Pokud se Vám program líbí:
  1074.      Poτlete  mi  prosím  250,-  Kƒ, normální registraƒní poplatek. (Pokud
  1075. poτlete víc, nebudu se bránit:)
  1076.  
  1077.  
  1078.      Tento  registraƒní  poplatek je pouze pro JEDNOTLIVCE. Pro pouºití ve
  1079. firmách, ú²adech a jin∞ch institucích na více neº jednom poƒítaƒi je t²eba
  1080. sjednat multilicenci. Kontaktujte mne ohledn╪ slev na tyto licence.
  1081.  
  1082.      Za  tento  poplatek  obdrºíte  (pomocí  emailu)  registrovanou  verzi
  1083. nejnov╪jτí   verzi   WWWGrab/2.   Tato  registrace  platí  i  pro  vτechny
  1084. následující verze.
  1085.  
  1086.      Bliºτí informace viz. REGISTER.CZE
  1087.  
  1088. Pokud se Vám program nelíbí:
  1089.      Napiτte mi proƒ a pak jej smaºte.
  1090.  
  1091. ---------------------------------------------------------------------------
  1092.      Uv╪domte  si  prosím, ºe tento druh softwaru stojí a padá na ohlasech
  1093. uºivatelà.
  1094.  
  1095. Nejnov╪jτí verzi WWWGrab/2 màºete získat na:
  1096. http://www.geocities.com/SiliconValley/Heights/7262/
  1097.  
  1098. Své p²ipomínky, hláτení o chybách nebo nápady màºete zasílat:
  1099. email:
  1100.   jirkar@writeme.com
  1101.   jirkar@hotmail.com
  1102.   Jiri_Rubes@slad.fido.cz
  1103.  
  1104. FidoNet:
  1105.   2:421/37
  1106.  
  1107.  
  1108.      Nikdo  není  dokonal∞,  ani tato dokumentace. Pokud zde najdete chybu
  1109. nebo p²eklep poτlete mi prosím zprávu a já ji opravím.
  1110.  
  1111.  
  1112.