--------> > Stručná dokumentace k programu < <-------- Název: Zpáva_WEBu.rexx Autor: Tomáš Procházka ((c)1999-2000) Verze: 1.4 (17.6.2000) Úvod: ˘˘˘˘˘˘ Tento program slouží k usnadnění přenosu WWW stránek na server a vznikl především pro zjednodušení mé práce. Nejedná se tedy o program nijak zvlášť připravený pro širokou veřejnost. Především program nebyl testován na schopnost zvládat neobvyklé situace, jako jsou špatné nebo nízké verze knihoven, špatná konfigurace uživatelem, atd. Přesto se umožňuje do jisté míry přizpůsobit individuálním podmínkám. Je však třeba dodržet určité podmínky principu práce. Tento manuál popisuje vše, co program provádí, některé věci jsou však pro běžné použití zcela zbytečné, proto jsem je nepopisoval příliš detailně. Požadavky programu: ˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘ · libovolnou Amigu s operačním systémem, který disponuje ARexxem (>2.0) (spuštěný Rexxmast a knihovny "rexxsupport.library" a "rexxsyslib.library" · programy Copy,Delete,List (jsou standardně v C:) · mít aktivní zařízení PIPE, tzn., musí být v "devs:dosdrivers" · knihovny: testovaná verze "rexxreqtools.library" (37.95) "rexxtricks.library" (38.6 ) "datatypes.library" (40.6+) · program LHA (pro tvorbu archívu stránek) · program MakeDir.rexx (pro tvorbu struktury adresářů - můj výtvor) - je součástí archívu Konfigurace - důležité upozornění ˘˘˘˘˘˘˘˘˘˘˘˘˘ Veškerá konfigurace se provádí přímo v programu změnou příslušných proměnných. Konfigurační část se nachází téměř na začátku programu a je zřetelně označena. Před každou proměnnou je text, který vysvětluje její význam. Vy budete měnit pouze text nebo číslo za "=". Pokud je text uzavřený v uvozovkách, musíte je tam ponechat ! Základní princip programu: ˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘ Program pracuje se dvěma adresáři: "source" a "new". Jejichž umístění, stejně jako všechno dále popsané, lze změnit v konfiguraci uvnitř programu. Tyto adresáře lze rovněž zadávat relativně, přičemž výchozí adresář bude ten, ze kterého byl spuštěn program. V adresáři "source" se nachází všechny soubory, které tvoří vaši WWW stránku (včetně archívů,...). Program tento adresář při prvním spuštění přeskenuje a považuje všechny soubory v něm za nové. Při dalším spuštění již existuje soubor "Logfile.ffc", který obsahuje názvy všech souborů a identifikační řetězec, který je tvořen buď velikostí nebo u ASCII souborů řetězcem získaným funkcí CRC32(). Za nové jsou tedy považovány pouze ty, které byly změněny. (viz. dále) Všechny nové nebo pozměněné ASCII soubory jsou převedeny z původního kódování (implicitně ATO-E2) do vámi zvoleného kódování (WindowsEE,ISO Latin 2) a dále zpracovány (viz. "Interní příkazy"). Nové nebo pozměněné soubory jsou však navíc zkopírovány do adresáře "new", odkud jej pak můžete zkopírovat na server. Můžete aktualizaci provádět častěji nové soubory tak budou do adresáře postupně doplňovány. Pokud však program při spuštění zjistí, že tento adresář není prázdný, zeptá se vás zda má pokračovat, pouze porovnat soubory nebo adresář vymazat. Pokud zvolíte pokračuj, bude adresář "new" zachován a pouze doplněn novými soubory. Druhá volba provede pouze srovnání aktuálních souborů s rejstříkem (původní rejstřík však zůstane zachován). Další volba provede totéž co první, pouze nejdříve vyprázdní adresář "new", což se hodí například tehdy, jestliže zapomenete po zkopírování na server tento adresář vymazat. Pokud nechcete, aby se program pokaždé, takto dotazoval, můžete tomu zabránit nastavením proměnné "Q_Dotaz" na 0. Program pak bude standardně provádět volbu "Pokračuj" Upozornění: Program není schopen zpracovat textové soubory, které jsou delší než 65 535 znaků (bytů). Já osobně zatím nepociťuji potřebu vytvářet tak dlouhé textové soubory, proto jsem si program takto zjednodušil. Další vymoženosti programu: ˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘ Na mých WWW stránkách je návštěvníkům k dispozici LHA archív, který obsahuje mé WWW stránky. Návštěvník si jej může stáhnout a v klidu prohlédnout. Právě o vytvoření tohoto archívu se stará tento program. Každý textový soubor je již během kontroly nových nebo pozměněných souborů zkopírován do adresáře jehož název lze specifikovat proměnnou "MainDir". Tento adresář se standardně nachází v RAMce. Po skončení kontroly všech ASCII souborů (tedy i HTML), jsou do tohoto adresáře překopírovány zbývající soubory s adresáře "source". Toto kopírovány můžete ovlivnit proměnnými vynech.x. (x je číslo 1,2,3,...) Proměnné musí obsahovat . (opět lze zadat relativně vzhledem k adresáři ze kterého byl program spuštěn). Operace se ovšem vztahuje jen na zadaný adresář a již ne na jeho podadresáře! Ve vynechaném adresáři tedy budou chybět všechny soubory (ne podadresáře) a místo nich bude do adresáře nakopírován celý obsah adresáře "náhrada" a to včetně podadresářů. Proměnná vynech.x lze však daleko účelněji využít, pokud jako neuvedete jiný adresář, ale soubor, pak bude adresář vyplněn těmito soubory, které budou mít původní názvy. Tohle je vhodné například pokud nechcete mít v archívu LHA soubory (jak je to u mých stránek). Umístění výsledného lha archívu lze řídit proměnnou "archive_name". Při náhradě novým souborem však nedochází k jakékoliv jeho úpravě (např. změna kódování). Soubor je zkopírován tak jak je. Upozornění: Pokud proměnnou vynech.x zadáte, že má být některý adresář nahrazen jiným, budou soubory, které se již v adresáři "MainDir" nacházejí přepsány !!! Další vymožeností programu je schopnost vytvářet pro zkopírování na server také stránky v kódování ATO-E2 k tomu slouží proměnná M_orig, kterou musíte nastavit na 1. Následně musíte nastavit proměnné "nah_zdroj" a "nah_cil", které řídí změnu názvu vašeho adresáře s HTML soubory na název adresáře s původními soubory. Tuto možnost již sám nepoužívám, ale je funkční. Je však omezena pouze na jeden adresář ve kterém musíte mít textové soubory. Změna kódování ˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘ Od této verze lze individuálně zvolit kódování jak pro nové soubory, které přijdou zkopírovat na server, tak také soubory v archívu stránek Jedná se o proměnné "k_aktual" a "k_archiv", které se nastavují na číslo 0,1,2,... podle vybraného kódování. Hned nad těmito proměnnými jsou kódovací tabulky, které jsou těmito čísly očíslovány. Kódovací tabulka má tento formát: . Pokud zvolíte jakékoliv jiné kódování než nula (původní kódování - standardně KOI8), budou automaticky upraveny konce řádku na CR LF (pro PC) a text převeden do příslušného kódování. Program také automatický upravuje META tag v hlavičce HTML dokumentu, který informuje o typu použitého kódování. Pokud ho tam již máte, bude nahrazen novým a pokud ne, bude vytvořen na řádku hned za . Pokud chcete programu ušetřit práci a tím jej urychlit, vložte do HTML souboru sami tento řádek: . {KOD} tak bude nahrazen zvoleným kódováním bez dalšího zdržování. Pokud změníte kódování stránek a spustíte program, budou všechny textové soubory považovány za nové, jelikož se změnilo jejich kódování. Interní příkazy: ˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘ Jedná se o příkazy, které lze vkládat do jakéhokoliv souboru s textem, které program vyhodnotí a nahradí je výsledkem. V této verzi lze použít následujících příkazů: - < soubor nenalezen > a < soubor nenalezen > - program tyto příkazy nahradí velikostí nebo komentářem daného souboru. Jako soubor musíte uvést relativní cestu vztaženou k adresáři "source". Pokud nebude daný soubor nalezen, program na to upozorní a ve výsledném souboru nebude nic ! Velikost bude upravena tak, aby byly odděleny tisíce, pokud nechcete, aby se tak stalo, můžete použít příkaz SIZE nahradit SIZEH. Program automaticky při prověrce nových souborů ověřuje, zda nebyl změněn soubor na nějž se vztahuje interní příkaz (stačí jen jiný komentář) a pokud ano, považuje za nový i soubor s interním příkazem, i když vy jste v něm nemuseli změnit nic. Standardní nastavení: ˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘ Názvy základních adresářů: Source = 'A_Vyvýjené/' new = 'B_Upload/' kódování pro stránky je WindowsEE a pro soubory v archívu ISO Latin2. Na tvorbu archívu se program dotazuje. Archív je vytvářen v RAMce v adresáři AtomWWW a je následně přemístěte do "B_Upload/archiv/AtomWWW.lha". V archívu jsou vynechány soubory v adresáři "archiv" a jsou nahrazeny souborem neni.htm. Soubory původním kódování nejsou vytvářeny. Pokud však vytváření zapnete budou soubory, které se nacházejí v adresáři "html" umístěny do adresáře "hkoi". Informace o souborech, které již ze serveru přijdou smazat budou uloženy do souboru "Smazat.txt" Než se pustíte do konfigurace programu, zkuste si program zpustit v původním nastavení. Měli by jste dobře rozumět jeho funkci. Navíc tak poznáte, zda nefungoval již před vašim zásahem... Copyright: ˘˘˘˘˘˘˘˘˘˘˘˘ Program je FreeWare a může být tudíž volně šířen, avšak pouze v nepozměněném stavu spolu s touto dokumentací!! Pokud máte pocit, že musíte na programu něco upravit a chcete, aby to mohly využít také ostatní, obraťte se na mě. Jakýkoliv návrh je vítán. Upozornění: Autor nenese žádnou odpovědnost zá následky způsobené používáním (především nesprávným) tohoto programu !!! Ještě jednou opakuji, že program byl napsán pro mé potřeby a jelikož si myslím, že by se mohl hodit i více lidem, máte nyní možnost tyto řádky číst. Byl bych rád, kdyby někdo projevil zájem o zdokonalení tohoto programu a nebo dokonce o spolupráci. ------------------------------------------------------------------------- Kontakt na autora: ˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘˘ Email: tom.p@sf.cz WWW: atom.hyperlink.cz