1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML>
<HEAD>
<META HTTP-Equiv="Content-Type" Content="text/html; charset=iso-8859-2">
<TITLE> C-SaCzech 2.1 </TITLE>
</HEAD>
<BODY BGCOLOR=WHITE>
<table width="100%">
<tr>
<td valign=top width=100>
<table width=100 cellspacing=0 cellpadding=0>
<tr>
<td align=center><A HREF="http://www.csacek.cz/"><IMG SRC="img/csacek_logo.gif" alt="[CSacek]" BORDER=0 WIDTH=92 HEIGHT=42></a></td>
</tr>
<tr><td> </td></tr>
<tr><td> </td></tr>
<tr><td><A HREF="index.html">Home</A></td></tr>
<tr><td><A HREF="index.html#priste">Dal vvoj</A></td></tr>
<tr><td><A HREF="index.html#co_je_to">Co je CSek</A></td></tr>
<tr><td><A HREF="index.html#lokace">Download</A></td></tr>
<tr><td><A HREF="faq.html">FAQ</A></td></tr>
<tr><td><A HREF="instalace.html">Instalace</A></td></tr>
<tr><td><A HREf="csacek.html">Dokumentace</A></td></tr>
<tr><td><A HREF="index.html#credits">Kredit</A></td></tr>
<tr><td><A HREF="index.html#kontakt_autor">Kontakty</A></td></tr>
<tr><td><a href="obj.html">Podpora</a></td></tr>
<tr><td><a href="historie.html">Historie</a></td></tr>
<tr><td><a href="licence.html">Licence</a></td></tr>
<tr><td><hr></td></tr>
<tr><td><A HREF="index.html#jine_zajimavosti">Dal info o etin</A></td></tr>
<tr><td> </td></tr>
<tr><td> </td></tr>
<tr><td align=center><A HREF="http://www.4web.cz/"><IMG SRC="img/hosted_by_4web.gif" ALT="[Hosted by 4Web]" BORDER=0 width=88 height=31></A></td>
</tr>
<tr><td> </td></tr>
<tr><td> </td></tr>
<tr><td align=center><a href="http://validator.w3.org/check/referer"><img border="0"
src="http://www.w3.org/Icons/valid-html401"
alt="Valid HTML 4.01!" height="31" width="88"></a></td></tr>
</table>
</td>
<td>
<H2> Dokumentace </H2>
<UL>
<LI> <A HREF="#proc">Pro zvolit prv CSek ?</A>
<LI> Nvod k pouit
<UL>
<LI> <A HREF="#zaklady">Zklady - URL strnky</A>
<LI> <A HREF="#zachovani">Zachovn kdu pi odkazech</A>
<LI> <A HREF="#obrazky">Kduje se pouze text a HTML</a>
<LI> <A HREF="#zmenkod">Zmna vchozho kdu</A>
<LI> <A HREF="#auth">Pekdovvn "chrnnch" strnek</A>
<LI> <A HREF="#online_services">Vypisovn konfigurace CSka</A>
</UL>
<LI> <A HREF="#mutace_APACHE">Apache CSek</A>
<UL>
<LI><A HREF="#mutace_APACHE_conf">Jak se konfiguruje Apache verze</A>
<LI><A HREF="#mutace_APACHE_ssl">Podpora SSL</a>
</UL>
<LI> <A HREF="#mutace_ISAPI">ISAPI CSek</A>
<UL>
<LI><A HREF="#mutace_ISAPI_conf">Jak se konfiguruje ISAPI verze</A>
<LI><A HREF="obj.html">Objednvka ISAPI CSku</A>
</UL>
<LI> <A HREF="#konfigurace">Konfiguran direktivy</A>
<LI> <A HREF="#prikazy">Pkazy CSku</A>
<UL>
<LI> <A HREF="priklady.html">Pklady pouit</A>
</UL>
<LI> <A HREF="index.html"><STRONG>vodn strnka</STRONG></A>
</UL>
<BR>
<A HREF="index.html"><IMG SRC="img/zpet.gif" width=16 height=16 alt="[Zpet]"> Zpt k hlavn strnce</A>
<hr>
<!-- NEXT PART -->
<A NAME="proc"> </A>
<H3>CSek nabz</H3>
<UL>
<LI> monost funkce jako CGI, FastCGI nebo Apache modul, na
UN*Xu (NetBSD, Linux, Solaris, IRIX, Digital Unix), CGI a ISAPI
na MS Windows NT
<LI> pod Apache 1.3.X monost pouvat CSek jako DSO modul
<LI> on-fly kompresi dokument, poslanch klientovi (kompresi
podporuje nap. Netscape 4.5+, lynx, MSIE 4.0+)
<LI> podpora <TT>META</TT> tagu pro oznaen kdovn etiny v dokumentu
<LI> podporu Unicode (UTF-8)
<LI> podporu relativnch odkaz i absolutnch odkaz, automatick
pepisovn absolutnch odkaz pro zachovn vbru kdovn
<LI> monost pouvat rzn typy kdovn etiny ve zdrojovch textech
strnek; je dokonce mono pout vc kd v rmci jedn strnky
<LI> monost kdovat i dynamicky vytven strnky (nap. vsledky
rznch skript)
<LI> pekdovn vstupu od klienta (data z formul) do kdovn serveru
<LI> podporu azbuky
</UL>
<A HREF="#_top"><IMG SRC="img/zpet.gif" width=16 height=16 ALT=ZPET> Zpt</A> <P>
<HR>
<!-- NEXT PART -->
<H3><A NAME="zaklady">Zklad - URL strnky</A></H3>
Strnku napite v kdu, kter odpovd zvolenmu implicitnmu
kdu serveru (ve skutenosti kdovn strnky
<A HREF="#zmenkod">nen omezeno</A>).
Vystavte ji, jak je obvykl. Jedin, co se zmn, bude URL, kterm
je teba se odkzat na strnku. Jestlie URL strnky bez pekdovn by
bylo
<BLOCKQUOTE>
<TT>http://www.kdesi.cz/cesta/stranka.html</TT>
</BLOCKQUOTE>
bude URL te strnky pi poadavku jejho pekdovn do sedmibitovho
ASCII
<BLOCKQUOTE>
<TT>http://www.kdesi.cz/toASCII/cesta/stranka.html</TT>
</BLOCKQUOTE>
za pedpokladu, e pouvte Apache CSek.
<P>
Tento odkaz vak pedpokld, e pedem vte, jak kd bude uivatel
vyadovat. To asto nemus bt pravda. V takovm ppad doporuuji
spustit CSek v <A NAME="mod_whichcode">mdu <TT>whichcode</TT></A> -
URL bude vypadat njak takto:
<BLOCKQUOTE>
<TT>http://www.kdesi.cz/whichcode/cesta/stranka.html</TT>
</BLOCKQUOTE>
Na zklad extern ablony bude vygenerovna strnka, kde bude
uivateli bude oznmeno, e clov dokument obsahuje
diakritick znamnka a umon mu zvolit kd, kter povauje za optimln.
<P>
Druh monost je pout <TT>toGUESS</TT>. V tomto mdu se CSek
pokus zjistit, jak kdovn a jazyk klient podporuje a pesmruje
klienta na URL, kter odpovd jeho jazykovm/kdovacm schopnostem.
Momentln kadmu klientovi z eska vnut <TT>ISO-8859-2</TT>
(klient, kter by nerozuml tomuto kdovn se d povaovat za
nefunkn), ostatnm pak <TT>ASCII</TT>. Pokud by ml uivatel
tu smlu, e pouv nefunknho klienta, me si typ kdovn
pozdji zmnit explicitn pes <TT>whichcode</TT>.
<BR>
V ppad Apache modulu a ISAPI filteru se md <TT>toGUESS</TT>
pouv implicitn v ppad, e URL neobsahuje CSek, tj.
jedn se o jednoduch URL typu <TT>http://www.nekde.cz/cosi.html</TT>.
Zjednoduuje se tak URL v obvyklm ppad, kdy uivateli uhdnut default
vyhovuje.
<H3><A NAME="zachovani">Zachovn kdovn pi odkazech</A></H3>
CSek od verze 2.0 automaticky pepisuje odkazy v dokumentu tak, aby
se v danm URL opt objevil a zachovala se tak informace
o vybranm kdovn. Nemuste se tedy o odkazy jakmkoli
zpsobem starat, CSek ve uprav za Vs. Je nutno pouze zachovat
opatrnost pi skldn odkaz v JavaScriptu - tyto odkazy samozejm
CSek neme zmnit. Pokud je to jen trochu mon, pouijte
tady relativn odkazy.
<P>
Pokud se odkazujete na jin servery s CSkem a chcete, aby se pi
odkazech zachovala informace o uivatelem vybranm kdovn,
muste CSkovi seznam takovch server sdlit. CSek
pak upravuje URL v dokumentech podobnm zpsobem, jako
pi odkazech v rmci "svho" serveru. Podrobnji
viz popis konfiguranho pkazu Apache
<A HREF="#mutace_APACHE"><TT>csacekServers</TT></A>. CSek jako
Apache modul automaticky pid do seznamy vechny virtuln
servery WWW serveru, na kterm b.
<P>
Samozejm lze na strnku napsat obvykl seznam odkaz pro zobrazen
dokumentu v ASCII, ISO-8859-2 i CP1250:
<BLOCKQUOTE>
<TT><A HREF="/toASCII/">ASCII/</A></TT><BR>
<TT><A HREF="/toISO-8859-2/">ISO-8859-2/</A></TT><BR>
<TT><A HREF="/toCP1250/">CP1250/</A></TT><BR>
</BLOCKQUOTE>
<P>
<H3><A NAME="obrazky">Kduje se pouze text a HTML</A></H3>
CSek kduje pouze dokumenty typu <tt>text/html</tt> (HTML
dokumenty) a obecn <TT>text/*</TT> (jako textov data).
Dokumenty, kter maj neznm textov typ (nap. <tt>text/javascript</tt>)
jsou zpracovny jako <tt>text/plain</tt>, tedy nerozeznvaj
se tam dn HTML znaky a nepepisuje se URL.
<P>
Dokumenty netextovch typ (tj. cokoliv co m MIME typ jin ne
<tt>text/*</tt>) ped CSek beze zmny.
<P>
Kvli rychlosti zpracovn CGI CSek implicitn pokld
za "pekdovateln" soubory s pponou
<TT>.html</TT>, <TT>.htm</TT>, <TT>.txt</TT>. O vechny
ostatn dokumenty pod zpt WWW server a rozhodne se, zda dan
dokument kdovat nebo ne, podle informac, kter server vrt
(zpracovn pes dal poadavek je samozejm pomalej).
<P>
Apache/ISAPI CSek m informaci o typu souboru vdy jednodue k
dispozici, proto tam neexistuje dn pevn seznam ppon a ve
zle jen na konfiguraci serveru.
<A NAME="zmenkod"> </a>
<H3>Zmna vchozho kdu</H3>
Implicitn vchoz kd, ve kterm budou psny dokumenty, uruje sprvce
serveru pi instalaci CSku. Mlo by se jednat o kd, ve kterm
bude vytvena vtina strnek (nejlpe vechny). Pokud autor pouv
jin kdovn, m v zklad dv monosti:
<DL>
<DT><STRONG>Pevst strnku do implicitnho kdu.</STRONG>
<DD>To je mn pohodln a navc to komplikuje pozdj pravy na strnce
(kad prava bude vyadovat nov pekdovn).
<DT><STRONG>Ponechat strnku v kdu pvodnm a vyznait jej.</STRONG>
<DD>
CSek podporuje <TT>META</TT> tag a zad se podle informace,
kter je tam uvedena, tj. je-li tam
<TT><META HTTP-Equiv="Content-Type"Content="text/html; charset=windows-1250"></TT>
CSek sprvn pochop, e obsah dokumentu je v kdovn
pouvanm na MS Windows a zad se podle toho.
<P>
<DD>CSek podporuje tak jin mechanismus vyznaen kdovn textu -
pomoc <A HREF="#prikaz_MYCHARSET">pkazu <TT>MYCHARSET</TT></A>.
Vhodn je zejmna tehdy, pokud rzn sti dokumentu
obsahuj text v rznm kdovn. Pokud mte cel dokument v jednom
kdovn, pouijte radji pslun <tt>META</tt> tag. Prohle
tak m informaci o kdovn dokumentu i v ppad, e dokument
nedostane pes CSek.
<P>
</DL>
<P>
innost pkazu <TT>MYCHARSET</TT>, pop. <TT>META</TT> tagu
zan mstem, kde byl uveden. Pestoe CSek povoluje pout
<tt>META</tt> tag s vyznaenm kdovn nkolikrt, toto <em>nen</em>
platn uit podle HTML standardu.
<H3><A NAME="auth">Podpora chrnnch strnek</A></H3>
Nsledujc text plat pouze pro (Fast)CGI CSek; pokud je CSek
soust WWW serveru (Apache modul nebo ISAPI filter), pouij
se bezpenostn mechanismy danho serveru bez toho, e by je
CSek njak ovlivoval.
<P>
Pi pmm pedvn obsahu souboru CGI CSek dv pozor, jestli
se na "cest" k nmu nevyskytuje njak konfiguran soubor
(standardn <TT>.htaccess</TT>). Pokud ano, o dokument pod
server.<BR>
Bohuel pak nastane problm v tom, e WWW server vtnou
z bezpenostnch dvod nepedv CGI skriptm
login a heslo poslan klientem.
Pi zptnm poadavku o chrnn dokument tedy CGI CSek neme
tuto informaci poslat a pstup k dokumentu je tedy
zamtnut.
<P>
Lze samozejm upravit zdrojov kd serveru tak, aby tuto informaci
CGI skriptm pedval. Jedn se ale o mon bezpenostn
riziko a tedy toto nedoporuuji. Pokud potebujete pekdovn
veejn nepstupnch strnek, pouijte CSek jako Apache modul.
<A NAME="online_services"> </A>
<H3>Vypisovn konfigurace CSka</H3>
Pokud do browseru zadte URL na strnku na serveru s CSkem a pipojte
k URL <TT>?csacek_info</TT>,
CSek vytvo a vype krtkou informan HTML strnku s popisem
konfigurace pro toto URL a seznamem zakompilovanch nastaven.
Tato vlastnost je uiten zejmna pi aktualizaci i ladn konfigurace
CSku pro dan server. Tuto vlastnost lze pi kompilaci vypnout.
<P>
<A NAME="mutace_APACHE"> </A>
<A HREF="#_top"><IMG SRC="img/zpet.gif" width=16 height=16 ALT=ZPET> Zpt</A>
<HR>
<H2>Apache CSek</H2>
CSek na Apache byl pvodn na 1.2.4. Nyn je primrn vyvjen
na Apache 1.3.19 s tm, e je mon ho pouvat i na Apache 1.1.1
i Apache 1.2.X. Nen nutn patchovat server,
CSek modul se do serveru pidv jako kterkoli jin modul.
Pod Apache 1.3.X je ho mon dokonce (s pomoc <TT>axps</TT>)
zkompilovat jako DSO modul a nahrvat do serveru dynamicky.
<P>
<A NAME="mutace_APACHE_conf"> </a>
<H3>Jak se konfiguruje Apache verze</H3>
Seznam konfiguranch direktiv viz
<A HREF="#konfigurace">konfiguran direktivy CSku</A>.
<P>
Apache CSek se nastavuje pomoc sady direktiv, uvedench
v konfiguranch souborech serveru (globlnm <tt>httpd.conf</tt>
nebo ppadnch <TT>.htaccess</TT>).
CSek lze nastavovat rzn pro kad virtualn server i
adres, je teba jen direktiv uvst v pslun sekci
<TT><Location></TT> i <TT><VirtualHost></TT>.<BR>
Pokud je jako parametr direktivy etezec obsahujc mezery, je
nutn jej cel uzavt mezi uvozovky (me bt ppad <TT>csacekTemplateDir</TT>).
<P>
Pklad z konfigurace:<BR>
<BLOCKQUOTE>
<TT>
csacekEngine On<BR>
csacekDefaultCharset windows-1250<BR>
</TT>
</BLOCKQUOTE>
<A NAME="mutace_APACHE_ssl"> </a>
<H3>Podpora SSL</H3>
<H4>Apache-SSL</H4>
U modulu Apache-SSL sta od verze 1.17 v souboru
<TT>apache_ssl.c</TT> zmnit <TT>SSL_IS_OPTIONAL</TT> na <TT>TRUE</TT>.
Apache-SSL pak bude fungovat
i bez CSku, pouze se pid nkolik test na obsah nkterch struktur.
Tyto testy jsou nutn proto, aby CSek byl schopen bhem sv prce
doasn "vypnout" SSL. Komunikace s klientem (ten vstupu od nj
i vstup ze serveru) jsou stle v SSL, toto jen vypne SSL pi
vnitnm zpracovn tak, aby CSek data dostal nezakdovny.
<H4>mod_ssl</H4>
Od verze 2.1.2 funguje CSek i spolen
s <A HREF="http://www.modssl.org/">mod_ssl</A>. Nejsou teba
dn pravy kdu. Od verze 2.1.9 funguje CSek i v ppad,
e se nepouv autentifikace uivatel.
<P>
<a name="mod_ssl_conf"><strong>Pozor:</strong></a>
<blockquote>
Pi pouit <tt>LoadModule</tt> v konfiguraci serveru je teba
zadit, aby se CSek modul nahrl <strong>dve</strong> ne
mod_ssl. Toto je nutn kvli tomu, e CSek potebuje
v urit fzi zpracovn zmnit vnitn struktury spojen,
ale pslun kd mus bt sputn <strong>po</strong> mod_ssl.
Moduly jsou v kad fzi zpracovn provolvny v opanm
poad ne byly nahrny, tedy CSek mus bt do serveru
nahrn <strong>ped</strong> mod_ssl.<br>
</blockquote>
<H4>Stronghold</H4>
Od verze 2.1.3 CSek funguje i pod Strongholdem. Testovno
na verzi Stronghold 2.4.2 pro NetBSD/i386.
<P>
<!-- NEXT PART -->
<A NAME="mutace_ISAPI"> </A>
<A HREF="#_top"><IMG SRC="img/zpet.gif" width=16 height=16 ALT=ZPET> Zpt</A>
<HR>
<H2>ISAPI CSek</H2>
V rmci vvoje webovch strnek Masarykovy univerzity byl financovn
i vvoj CSku pro IIS, tj. ISAPI filtru. ISAPI CSek je nyn
dopracovn a od verze 2.1 je k dispozici jako komern software.
<P>
ISAPI CSek pekdovv korektn
vstup z ASP, CGI, server extensions (vetn FP extensions) a samozejm
statick strnky, funguje i pri provozu s SSL a je velmi rychl -
podle namtkovch test asi dvakrt rychlej ne <TT>CZFILTER</TT>.
<P>
Pokud mte zjem ISAPI CSek vyzkouet, je k dispozici
<A HREF="http://www.csacek.cz/distrib/bin/isapi/">asov omezen verze</A>,
kter pestane fungovat piblin po msci. Objednat CSek
lze na <A HREF="obj.html">samostatn strnce</A>.
<A NAME="mutace_ISAPI_conf"> </a>
<H3>Jak se konfiguruje ISAPI verze</H3>
Seznam konfiguranch direktiv viz
<A HREF="#konfigurace">konfiguran direktivy CSku</A>.
<P>
ISAPI CSek je konfiguruje pomoc zznamu v MS Windows Registry.
Jeho vtev je <TT>HKEY_LOCAL_MACHINE\Software\CSacek</TT>.
<P>
Zznam v CSkovskm kli Registry plat jako "globln". Je ale
tak mono nastavit vlastnosti CSka pro jednotliv virtuln servery.
Konfigurace pro kad virtuln server je uvedena v podkli
CSek kle - jako jmno kle se pouije nzev virtulnho
serveru. Je mono uvst i port, od jmna serveru je oddlen dvojtekou.
Pokud je port uveden, konfigurace plat jen pi pstupu na tento
konkrtn port, pokud ne, plat pro jakkoli pstup na dan
virtuln server.
Pklad nzvu podkle:
<BLOCKQUOTE>
<TT>www.muj.cz</TT><BR>
<TT>www.jiny.cz:8000</TT>
</BLOCKQUOTE>
V konfiguraci virtulnho serveru mohou bt uvedeny vechny direktivy
stejn jako v globln. Hodnoty nastaven <tt>csacekServers</tt>
jsou ale globln a sdlen vemi virtulnmi servery - nem vznam
mt nastaven rzn pro rzn servery.
<P>
Po kad zmn konfigurace je nutno pestartovat Web server - jen tak
se zajist, aby CSek zmnn zznam z registry znovu naetl.
<P>
<!-- NEXT PART -->
<A NAME="konfigurace"> </A>
<A HREF="#_top"><IMG SRC="img/zpet.gif" width=16 height=16 ALT=ZPET> Zpt</A>
<HR>
<H2>Konfigurace CSka</H2>
Nkter vlastnosti CSka lze ovlivnit vhodnm nastavenm.
Pro CGI CSka to lze pouze v ase kompilace (monost
run-time konfigurace nen pro CGI rozumn). Chovn
Apache CSku a ISAPI CSku lze ale pomrn jednoduchm zpsobem
ovlivnit i pozdji - nastavenm
v <A HREF="#mutace_APACHE_conf">kofiguraci serveru (Apache)</A>
nebo <A HREF="#mutace_ISAPI_conf">nastavenm v registry (ISAPI)</A>.
Zde je popis jednotlivch direktiv:<P>
<DL>
<DT> <TT>csacekChangeURL</TT> <EM>On</EM> nebo <EM>Off</EM>
<DD> Nastavuje, jestli se v dokumentu odkazy upravovat tak, aby
ly "pes CSek".<BR>
Default: <EM>On</EM>
<DT> <TT>csacekCompress</TT> <EM>On</EM> nebo <EM>Off</EM>
<DD> Nastavuje, jestli se m pout komprese nebo ne.<BR>
Default: <EM>On</EM>
<DT> <TT>csacekDefaultCharset</TT>
<DD> Nastavuje defaultn kdovn serveru. CSek bude
pedpokldat, e strnka je v tomto kdovn, pokud si
sama neekne jinak. Textov data od klienta budou pevedeny
do tohoto kdovn ped pednm dat ostatnm modulm.<BR>
Default: <TT>iso-8859-2</TT> na Unixu a <TT>windows-1250</TT>
na MS Windows
<DT> <TT>csacekEngine</TT> <EM>On</EM> nebo <EM>Off</EM>
<DD> Zapn CSek (a'la Apachovske <TT>RewriteEngine</TT>).<BR>
Default: <EM>On</EM>
<DT> <TT>csacekImplicitWork</TT> <EM>On</EM> nebo <EM>Off</EM>
<DD> Pokud clov kdovn nen v URL uvedeno (URL je typu
<TT>http://kdesi/cosi/neco.html</TT>, tj. <TT>bez toXXX</TT>), CSek
se pokus uhdnou klientem podporovan kdovn a automaticky
do nj poadovan dokument pevede. Pokud se vm
toto chovn nehod, lze implicitn pekdovn pomoc
tto direktivy vypnout.<BR>
Default: <EM>On</EM>
<DT> <TT>csacekServers</TT>
<DD> Seznam "CSek kompatibilnch" server -
v pedvanch HTML dokumentech se odkazy
na tyto servery automaticky uprav tak, aby se zachovalo uivatelem
pouvan kdovn a jazykov verze<BR>
Jednotliv nzvy server se pou navzjem oddlen rkou.
Je mon zadat i port (od jmna serveru oddlen dvojtekou) - pak
se budou odkazy mnit jen pokud URL vede na dan port danho serveru.
<BR>
Default: Apache - vechny virtuln servery, ISAPI - servery,
kter maj vlastn konfiguraci v CSek vtvi v registry<BR>
Pklad: <TT>www.nekde.cz:900,www.cosi.cz</TT>
<DT> <TT>csacekTemplateDir</TT>
<DD> Adres se ablonami - momentln pouze ablonou k <TT>whichcode</TT>
(soubor <TT>whichcode_template.html</TT>).<BR>
Default: <TT>/www/csacek</TT> na UN*Xu a <TT>C:/CSacek</TT>
na MS Windows.
<DT> <TT>csacekTestJS</TT> <EM>On</EM> nebo <EM>Off</EM>
<DD> <strong>Experimentln vlastnost, v pt verzi me zmizet nebo se
zmnit.</strong><BR>
Zapn heuristiku pro rozpoznvn "istho" JavaScript dokumentu
(default vypnuto). Pokud je dokument typu <tt>text/html</tt>, pi
zapnut tto direktivy CSek prohldne prvnch 200 znak
dokumentu nebo prvn ti neprzdn dky. Pokud se zde nalezne
etzec <tt>//</tt> nebo <tt>/*</tt> (JavaScript koment) nebo
znak <tt>;</tt> na konci dku (ppadn mezery nebo tabeltory
mezi znakem <tt>;</tt> a koncem dku jsou ignorovny), dokument
zpracovv jako <tt>text/plain</tt>, tedy HTML tagu (nap. odkazy)
<strong>nejsou</strong> pepisovny.<p>
<blockquote>
Pozor - pi neopatrnm pouit me tato heuristika dvat
patn vsledky. Mohou existovat platn HTML strnky, kter
spluj ve uveden kritria a nejedn se pitom o JavaScript
zdrojov kd. Pokud mono tuto direktivu vdy aplikujte jen
na omezen podstrom dokument a zkontrolujte, e absolutn odkazy
a tag <tt><A></tt>, <tt><FORM></tt> atd. jsou
sprvn pepisovny pi pouit explicitnho pekdovn
(jako nap. <tt>/toASCII/</tt>).
</blockquote>
</DL>
CSek je standardn "zapnut", pokud ho chcete vypnout, je teba
ho explicitn vypnout pomoc <TT>csacekEngine</TT>.
Stle se bude intern z URL odstraovat CSkov st (tj. pokud
server bude podn o <TT>http://server/toASCII/dir/doc.html</TT>,
pevede se poadavek intern na <TT>http://server/dir/doc.html</TT>),
CSek ale s dokumentem poslanm nazptek klientovi nebude nic dlat.
<P>
Direktivy, kter jsou nadle podporovny v ad 2.1.*, ale budou
zrueny ve verzi 3.0:
<ul>
<li>csacekBarDef</li>
<li>csacekDefaultPartname</li>
<li>csacekIgnorePrefix</li>
<li>csacekServer (csacekServers bude nadle podporovno)</li>
</ul>
<!-- NEXT PART -->
<A NAME="prikazy"> </A>
<A HREF="#_top"><IMG SRC="img/zpet.gif" width=16 height=16 ALT=ZPET> Zpt</A>
<HR>
<H2>Seznam pkaz</H2>
Pkazy v CSku se uzavraj mezi
<TT><?</TT> a <TT>?></TT>. <TT>?</TT> je pouito proto, e
se jedna o speciln SGML "tag", uren pro vkldn pkaz
jazyk vloench (embedded) do SGML dokumentu. Kvli kompatibilit
s SaCzechem je podporovno tak <TT><!--</TT> a <TT>--></TT>.
<P>
<STRONG>Pklad pouit:</STRONG><BR>
<BLOCKQUOTE>
<TT><? SET EXECCMDS=YES ?></TT>
</BLOCKQUOTE>
<P>
Od verze 3.0 bude podporovna pouze (nov) notace
<tt><?csacek pkaz ?></tt>.
<P>
<STRONG>Obecn platn pravidla:</STRONG>
<UL>
<LI> me bt uveden pouze jedin pkaz
<LI> pkaz vetn parametr me bt na nkolik dk
<LI> ve jmn pkazu nezle na velkch/malch psmenech
(tj. nap. <TT>SET</TT> se povauje za ekvivalentn s <TT>SeT</TT>)
<li> u nzv parametr nezle na velkch/malch psmenech</li>
<LI> parametry pkazu se vyhodnocuj obvyklm zpsobem zleva doprava,
jsou podporovn znaky " a ' s obvyklm HTML vznamem;
zpis <TT>\x</TT> zpsob, e znak <TT>x</TT> nebude chpn
jako speciln
<LI> pi zadn vzjemn protikladnch parametr plat <EM>posledn</EM> uveden
<LI> nastaven z pkazu m vdy pednost ped defaultnm nastavenm
<LI> pokud se pkaz nepozn, v dokumentu se ponech
</UL>
<H3>Pkazy:</H3>
<UL>
<LI> <a HREF="#prikaz_MYCHARSET">MYCHARSET</A>
<LI> <A HREF="#prikaz_SET">SET</A>
</UL>
<H3> ... a popis: </H3>
V nsledujcm popisu hranat zvorky oznauj sti, kter nemus
(ale mohou) bt zadny. U kadho pkazu je uvedena
jeho syntax, jeden jednoduch pklad pouit, dle
pak krtk popis, co dan pkaz dl a pot ppadn pehled
voleb i parametr, kter mete pkazu zadat. U nkterch je
uveden jet odkaz na dal, podrobnj pklady uit.
<P>
<DL>
<DT> <TT><A NAME="prikaz_MYCHARSET">MYCHARSET</A></TT>
<DD> <STRONG>Syntax: </STRONG>
<TT>MYCHARSET=<EM>kdovn</EM></TT>
<DD> <STRONG>Pklad pouit: </STRONG>
<TT>MYCHARSET=ISO-8859-2</TT>
<P>
<UL>
<LI> k CSku, e nsledujc text je zapsn v zadanm
<EM>kdovn</EM>.
<LI> me bt uvedeno jmno kterhokoli podporovanho kdovn
<LI> pkaz lze v dokumentu pout i nkolikrt, vztahuje se na
nj omezen <TT>PART</TT>, <TT>DOMAIN</TT> a <TT>CHARSET</TT>
</UL>
<P>
<DT>
<TT><A NAME="prikaz_SET">SET</A></TT>
<DD> <STRONG>Syntax:</STRONG>
<TT>SET volba1=hodnota1 ...</TT>
<DD> <STRONG>Pklad pouit:</STRONG>
<TT>SET CHANGEURL=NO</TT>
<P>
<DD> Nastavuje nkter vlastnosti zpracovn textu. Rozpoznvan
parametry mohou bt nastaveny na <TT>YES</TT> nebo <TT>NO</TT>.
<P>
<DD> <STRONG>Parametry:</STRONG>
<TABLE WIDTH="100%">
<TR>
<TD WIDTH=50> <TT>CHECKURL</TT>
<TD> nastavuje, jestli se m v nsledujcm
textu u HTML znaek, pouvajcch URL (<TT>A</TT>, <TT>BASE</TT>
atd.), toto URL pepisovat tak, aby vedlo pes CSek;
defaultn zapnuto
</TR>
<TR>
<TD> <TT>EXECCMDS</TT>
<TD> nastavuje, jestli se v nsledujcm textu maj provdt CSek pkazy;
i v ppad, e je provdn pkaz vypnuto se stle nkter
provdj (nap. <TT>SET</TT>) - jinak by nebylo mon pznak
zase zapnout;
defaultn zapnuto
</TR>
</TABLE>
</DL>
<h3>Zastaral pkazy</h3>
Nsledujc pkazy jsou stle podporovny v ad 2.1.*, ale budou
odstranny ve verzi 3.0:
<ul>
<li><tt>BAR</tt></li>
<li><tt>BARDEF</tt></li>
<li><tt>PART</tt></li>
<li><tt>DOMAIN</tt></li>
<li><tt>CHARSET</tt></li>
<li><tt>csacekServer</tt></li>
<li><tt>csacekServers</tt> (konfiguran direktiva <em>zstv</em>)</li>
</ul>
<A HREF="#_top"><IMG SRC="img/zpet.gif" width=16 height=16 ALT=ZPET> Zpt</A> <P>
</td>
</tr>
</table>
<HR>
<FONT SIZE=1>
This page is part of documentation of
<A HREF="http://www.csacek.cz/">C-SaCzech</A>.
It has been created and is maintained by
<A HREF="http://www.ics.muni.cz/~dolecek/">Jaromr Doleek</A>,
<A HREF="mailto:dolecek@sky.cz">dolecek@sky.cz</A> <BR>
</FONT>
<EM>$Id: csacek.html,v 1.96 2002/03/10 20:03:31 dolecek Exp $</EM>
</BODY>
</HTML>
|
