                       KOMUNIKATY WWWOFFLE - Wersja 2.6
                       ================================

Strony HTML, ktre generuje WWWOFFLE zawarte s w tym katalogu.

Opis Stron
----------

Strony umieszczone w tym katalogu s komunikatami, ktre generuje sam WWWOFFLE.

Wszystkie pliki w tym katalogu odpowiadaj jednemu komunikatowi oprcz tych,
ktre s nazwane *-Head.html, *-Body.html lub *-Tail.html, i s one czciami
strony, ktra jest czona z innymi do stworzenia caej strony.


Pisanie Stron
-------------

Jeli modyfikujesz te strony dla samego siebie, wtedy prosz aby pamita o
nastpujcych punktach:

    Nazwa wwwoffle powinna pojawia si wyranie, gdziekolwiek znajduje si na
    stronie.
    Interfejs URL dla wwwoffle moe si zmienia pomidzy wersjami.
    Utrzymuj specyfikacj HTML (odwied http://www.w3.org/).
    Pliki musz by w formacie UNIX, a nie w formacie MS-DOS (LF, nie CRLF).

Jeli generujesz jakie strony, ktre chciaby zobaczy zaczone do nastpnych
wersji wwwoffle, powiadom mnie o tym. Faktycznie, moe bdziesz chcia powiedzie
mi o tym zanim zaczniesz, poniewa inni mog ju robi to co chcesz i ty. Nie
wysyaj mi stron dopki o nie nie poprosz, poniewa mog one by do due.

Jestem zainteresowany zaczeniem nastpujcych typw stron w przyszoci:

    Rozszerzone wersje
        Obrazki
        Javascript
        Bardziej pomocne (odniesienie do stron pomocy/FAQ w przypadku bdu?)

Udostpnie je ze strony web wwwoffle, jeli zostan zatwierdzone, rwnie w
nastpnych wersjach.


Zasady Rozkadu
---------------

Parser jest bardzo prostym mikro jzykiem (zbyt prosty, aby by makro
jzykiem!).

Zasady, ktre s posuszne s nastpujce:

Klasa-1

$foo                    - Zamieniane przez zawarto zmiennej foo.
%foo[bar]               - Zamieniane przez warto zwracan przez funkcj foo z
                          argumentem $bar.
                          Dostpnymi funkcjami s encode, decode i html.

Klasa-2

$foo=bar                - Podstawia warto 'bar' pod zmienn foo.
$foo="bar 1"            - Podstawia warto 'bar 1' pod zmienn foo.
$foo='bar 2'            - Podstawia warto 'bar 2' pod zmienn foo.

Klasa-3

$foo?{tak}{nie}         - Zamieniane przez 'tak', jeli $foo jest ustawione lub
                          'nie', jeli nie jest.
$foo?=bar{tak}{nie}     - Zamieniane przez 'tak', jeli $foo == bar lub 'nie',
                          jeli nie.


Due i mae litery nazw zmiennych i funkcji nie s rozrnialne, dla reszty s
rozrnialne.

Konstrukcja Klasa-1 moe zosta uyta po prawej stronie Klasa-2.

Konstrukcje Klasa-1 i Klasa-2 mog zosta uyte wewntrz konstrukcji Klasa-3.

Konstrukcja Klasa-3 nie moe by zagniedana.

Znaki { i } musz by notowane jako \{ i \} w konstrukcjach Klasa-2 i Klasa-3.

Znaki ' i " musz by notowane tak jak wyej, jeli s uyte wewntrz kontrukcji
Klasa-2.


----------
Andrew M. Bishop 31 marzec 2000
