C-SaCzech - pouziti

N�vod k pou�it�

C-SaCzech je jeden program, kter� pozn�, do kter�ho k�du m� p�ekl�dat podle jm�na pod kter�m byl spu�t�n. S v�hodou lze pou��t symbolick�ch odkaz� na jeden soubor, kter� bude obsahovat k�d programu. Tento zdrojov� soubor je implicitn� toASCII, ostatn�, tj. toCP1250, toKAM ..., jsou po standartn� instalaci symbolick� linky na tento soubor. Tento program p�edpokl�d�, �e bude spu�t�n jako CGI skript a vyu��v� p��slu�n� prom�nn� prost�ed�. Nelze jej tedy spou�t�t samostatn� (alespo� ne jednodu�e). Obsah

Z�klady - URL str�nky
Zachov�n� k�du p�i odkazech
Nek�dovat obr�zky!
Zm�na v�choz�ho k�du
Li�ta s nab�dkou k�dov�n�
V�cejazy�n� dokumenty

Z�klady - URL str�nky

Str�nku napi�te v osmibitov�m k�du, kter� odpov�d� zvolen�mu implicitn�mu k�du serveru. (Ve skute�nosti zdrojov� k�d nen� omezen.) Vystavte ji, jak je obvykl�. Jedin�, co se zm�n�, bude URL, kter�m je t�eba se odk�zat na str�nku. Jestli�e URL str�nky bez p�ek�dov�n� by bylo

http://www.kdesi.cz/cesta/stranka.html

bude URL t�e str�nky p�i po�adavku jej�ho p�ek�dov�n� do sedmibitov�ho ASCII

http://www.kdesi.cz/cgi-bin/toASCII/cesta/stranka.html

P�edpokl�d�m, �e cesta ke k�duj�c�m skript�m je /cgi-bin. M��ete pou��t libovoln� ze skript� toXXXX (kde XXXX jsou jm�na k�d� v distribuci).

Tento odkaz v�ak p�edpokl�d�, �e p�edem v�te, jak� k�d bude u�ivatel vy�adovat. To �asto nemus� b�t pravda. V takov�m p��pad� doporu�uji pou��t skript whichcode a URL

http://www.kdesi.cz/cgi-bin/whichcode/cesta/stranka.html

Skript whichcode u�ivateli ozn�m�, �e c�lov� dokument obsahuje diakritick� znam�nka a umo�n� mu zvolit k�d, kter� pova�uje za optim�ln�.

Zachov�n� k�du p�i odkazech

Je p�irozen�m po�adavkem, aby u�ivatel vyb�ral k�d jen jednou a p�i odkazech na dal�� dokumenty z t�ho� zdroje se uchov�vala informace o zvolen�m k�dov�n�. Nejjednodu�� cestou je relativn� odkaz. Kdy� do dokumentu vlo��te odkaz pomoc� zna�ky

<A HREF="kapitola1.html">Prvn� kapitola</A>

klient p�epracuje relativn� URL kapitola1.html na absolutn�. Vyjde p�itom z URL dokumentu, obsahuj�c�ho zna�ku. Pokud bylo p�vodn� URL dokumentu nap��klad http://www.kdesi.cz/cgi-bin/toCP1250/cesta/obsah.html, povede zm�n�n� odkaz k dokumentu http://www.kdesi.cz/cgi-bin/toCP1250/cesta/kapitola1.html. Informace o k�du byla zachov�na.

Pozor! Chcete-li vyu��vat pro uchov�n� k�du relativn� odkazy, nesm�te v dokumentu pou��t zna�ku <BASE>, kter� ur�uje z�kladn� URL dokumentu. Kdybyste ji pou�ili, budou v�echna relativn� URL vzta�ena k lok�toru, definovan�mu touto zna�kou, nikoli k URL, pod kter�m klient z�skal str�nku.

Absolutn� odkazy je t�eba �e�it jinak. Tady pou��v� C-SaCzech metodu podobnou programu WWWdia. Do textu m��ete na kter�koli m�sto (v�etn� cest) vlo�it �et�zec

__CHARSET__

K�duj�c� skript nahrad� ka�d� v�skyt tohoto �et�zce identifikac� k�du, do kter�ho pr�v� p�ev�d� str�nku. Proto m��ete v textu pou��t zna�ku

<A HREF="http://www.jinde.cz/cgi-bin/to__CHARSET__/jinacesta/str.html">odkaz</A>

Pokud str�nka projde skriptem toKEYBCS2, kter� ji p�evede do k�du KEYBCS2, bude v odeslan�m dokumentu v t�to zna�ce uvedeno URL

<A HREF="http://www.saczechserver.cz/cgi-bin/toKEYBCS2/jinacesta/str.html">odkaz</A>

P�edpokl�d�m, �e server, ur�en� t�mto absolutn�m URL, m� instalov�n C-SaCzech nebo SaCzech. M��e, ale nemus� se jednat o tent�� server, kter� poskytl p�vodn� dokument.

Jeliko� jsou n�zvy k�d� shodn� s programem WWWdia, mohou se na sebe navz�jem korektn� odkazovat str�nky, jejich� servery pou��vaj� r�zn� implementace �e�tiny. Absolutn� URL, uveden� v��e, lze pou��t i na str�nce, kter� je p�ek�dov�v�na programem WWWdia. Pot�ebujete-li naopak sko�it ze str�nky k�dovan� pomoc� C-SaCzechu nebo SaCzechu na str�nku v pomoc� WWWdia, pou�ijte pro tento odkaz URL

<A HREF="http://www.diaserver.cz/cgi-bin/charset/jestecesta/str.html?charset=__CHARSET__">odkaz</A>

Nek�dovat obr�zky!

C-SaCzech je selektivn�. K�duje jen soubory s ur�it�mi p��ponami (implicitn� .html, .htm, .txt a .cz ; jak je zm�nit se do�tete v kapitole Pod kapotou). Dostane-li k p�ek�dov�n� soubor s jinou p��ponou, odm�tne se akce ��astnit a p�esm�ruje klienta p��mo na doty�n� soubor. D�sledkem je, �e klient z�sk� soubor v p�vodn�m tvaru beze zm�ny k�dov�n�.

D�ky tomuto mechanismu m��ete na sv� str�nky vkl�dat relativn� odkazy na obr�zky, zvuky a dal�� druhy dat, kter�m by p�ek�dov�n� rozhodn� neprosp�lo.

Jestli�e se na str�nce vyskytne zna�ka

<IMG SRC="obraz.gif">

a URL str�nky je http://www.kdesi.cz/cgi-bin/toASCII/cesta/stranka.html, bude klient po serveru po�adovat http://www.kdesi.cz/cgi-bin/toASCII/cesta/obraz.gif. Server spust� program toASCII. Ten v�ak zjist�, �e je po n�m po�adov�no k�dov�n� souboru s p��ponou .gif. M�sto aby se pustil do d�la, odpov� klientovi "hele s t�mhle j� nechci nic m�t, vezmi si rovnou ten soubor". Klient si ho vezme a v�e funguje k pln� spokojenosti v�ech z��astn�n�ch.

Zm�na v�choz�ho k�du

Implicitn� v�choz� k�d, ve kter�m budou ps�ny dokumenty, ur�uje spr�vce serveru p�i instalaci program� C-SaCzech. M�lo by se jednat o k�d, ve kter�m bude vytv��ena v�t�ina str�nek (nejl�pe v�echny). Pokud autor pou��v� k�d jin�, m� dv� mo�nosti:

P�ev�st str�nku do implicitn�ho k�du.: To je m�n� pohodln� a nav�c to komplikuje pozd�j�� pravy na str�nce (ka�d� �prava bude vy�adovat nov� p�ek�dov�n�).
Ponechat str�nku v k�du p�vodn�m a vyzna�it jej.: K vyzna�en� p�vodn�ho k�du dokumentu se pou��v� HTML koment�� v p�esn� definovan�m tvaru

Nap��klad . Po��naje ��dkem, obsahuj�c�m tento koment�� (doporu�uji jej uv�st na samostatn�m ��dku na za��tku dokumentu), bude za v�choz� k�d dokumentu pova�ov�n k�d CP1250.

Dokonce m��ete pou��vat n�kolik r�zn�ch k�d� v jednom dokumentu. Jestli�e je prvn� polovina textu ps�na v k�du Kamenick�ch a druh� v MS-Windows, sta�� p�ed ka�dou ��st vlo�it p��slu�n� koment�� a v�sledek bude u�ivateli odesl�n ve spr�vn� podob� - ob� poloviny se korektn� p�ek�duj� nap��klad do ISO Latin 2. Takov� dokumenty sice pova�uji za zv�rstvo, ale ta mo�nost tu je...

Pro milovn�ky patologick�ch p��pad�:

V jednom koment��i nesm� b�t nic jin�ho ne� specifikace MYCHARSET=k�d.
Pou�ijete-li n�kolik koment��, obsahuj�c�ch MYCHARSET, pou�ije se prvn� z nich
��innost MYCHARSET za��n� ��dkem, na kter�m se vyskytuje.

Li�ta s nab�dkou k�dov�n�

Pokud se tak spr�vce rozhodne p�i instalaci, m��ete na str�nk�ch k�dovan�ch C-SaCzech vyu��vat automatick�ho generov�n� li�ty s nab�dkou k�dov�n�. Jak se to d�l� a co v�e lze nastavit se do�tete v ��sti Instalace, pop�. Pod kapotou. Ve str�nk�ch pak sta�� v m�st�, kde chcete m�t nab�dkovou li�tu, napsat p��kaz

<--BAR-->

kter� zp�sob�, �e C-SaCzech v dan�m m�st� vytvo�� a vyp��e li�tu s nab�dkou. Pokud je tak C-SaCzech nakonfigurov�n, vypisuje li�tu automaticky na konci dokumentu, pokud u� li�ta nebyla alespo� jednou vyps�na p�edt�m.

Pokud chcete doc�lit speci�ln�ho tvaru li�ty, m�te dv� mo�nosti. Jedna je zadat parametry p��mo v p��kazu BAR a druh� pou��t p��kazu BARDEF, kter� je identick� s BAR a� na to, �e nezp�sob� vyps�n� li�ty. V obou p��kazech jsou zadan� parametry platn� i pro v�echny n�sleduj�c� p��kazy BAR. S v�hodou lze takto nap�. p�edefinovat tvar li�ty a nechat C-SaCzech vypsat li�tu na konci dokumentu (p��klad).

Kter� parametry C-SaCzech podporuje se m��ete do��st v seznamu p��kaz�.

V�cejazy�n� dokumenty

Pokud po�izujete dokumenty, kter� maj� v�c variant, a� u� jsou nap��klad ve dvou r�zn�ch jazyc�ch nebo jsou nap��klad odli�n� zpracov�ny pro zobrazen� r�zn�mi WWW browsery, vyno�� se probl�m s aktualizac�. Jestli�e je takov�ch dokument� v�ce, je t�eba pamatovat na to, aby se p��padn� zm�ny provedly v ka�d�m souboru, a m��e se st�t (proto�e sme lidi omyln�), �e se neud�laj� v�ude. Bylo by vhodn� m�t v n�jak�m konzistentn�m form�tu v�echna spolusouvisej�c� data v jedin�m souboru. Tento probl�m se d� samoz�ejm� vy�e�it i naps�n�m vhodn�ch skript� na aktualizaci, ale �e�en�, kter� nab�z� C-SaCzech se mi zd� elegantn�j��.

Jak se to pou��v� ? ��sti ozna��me tak, �e na za��tek d�me speci�ln� p��kaz, podle kter�ho C-SaCzech pozn�, �e zde za��n� nov� ��st. Nap�.

<--PART ENG-->

vyzna�� novou ��st se jm�nem ENG. Pokud je pak je dan� dokument p�ekl�d�n skriptem se jm�nem toXXXXX.eng (pop�. toXXXXX.ENG), vyp��ou se ��sti mezi <--PART ENG--> a jin�mi ��stmi (p��klad).
Je rezervov�no jedno jm�no, a to ALL. ��st pojmenovan� jako ALL bude vyps�na v�dy, stejn� jako ��st dokumentu do prvn�ho v�skytu p��kazu PART.

Probl�mem v�ak z�st�v�, �e takto napsan� str�nky ve v�t�in� p��pad� nejsou dob�e �iteln� bez p�ek�dov�n� C-SaCzech, co� v�ak nepova�uji za a� tak velk� m�nus.

Dal�� informace viz seznam p��kaz�.

Zp�t

Tato str�nka je sou��st� dokumentace programu C-SaCzech.