Polonistą nie jestem dlatego proszę o rzucenie okiem. Interesuje mnie czy :

- jest w miarę czytelnie
- czy łatwo idzie uzyskać informacje
- czy jest w miare zrozumiale jak na doc'a
- wszystko co sie nie podoba

http://www.vertis.com.pl/doc/

jak dla mnie to wszystko łatwo _idzie_ znalezc podoba mi sie bardzo, wresz jestem pelen uznania

zgodnie z instrukcją w temacie

Miło sie czyta, szybko i zwięźle

Pare literówek:

Dokumentacja -> Pluginy -> Własne rozszerzenia

Tan rozdział ma na zadanie przedstawić proces tworzenia modyfikatora na wybranych przykładach.

Dokumentacja -> Pluginy -> Od czego zacząć ?

W tym celu w katalogu pluginówm...
&$input - do którego przekazwyana jest...

Modyfikatory -> links()

wtedy jako parametr nalezy podać zmienną zawierająca tabelę styli dla znanych protokołow

Modyfikatory -> lucfirst() AND lucwords()

W pierwszej kolejności ciąg zamienieniany jets na małe...

Funkcje publiczne -> cached() AND parse() AND source()

Zwaraca wartość True, jeśli szablon znajduje się w cache, w przeciwnym wypadku funkcja zwaraca wartość False.

Funkcje publiczne -> setVar()

Przypuje wartość zmiennej value do zmiennej variable

Parametry konfiguracyjne -> force_compile()

wymagane do poprawnegod działania klasy

Budowa szablonów -> Słowo wstępne

...przykład stylem kaskoadowym...

Budowa szablonów -> Tablica

...dodatkowy parametr okresląjący klucz...

Budowa szablonów -> Funkcja

Funkcję poprzeda się znakiem “@”...

Nie dopuszczone jest przekazywanie pojedyń(n)czego... (na samym dole)

ale ze mnie językowy kaleka poprawione w/w

Teraz ja
Forma uwag: rozna; moje odczucia, moje wskazowki, nakazy (szybciej sie popprostu je pisze ), itd

1. http://www.vertis.com.pl/doc/doku.php?id=instalacja


Skoro zapisujesz znak zachety a zeby wykonacz chowna trzeba byc rootem -- to przydalby sie '#' zamiast '$' i dopisek ze trzeba byc rootem.

2. (link ten sam)

Przeciez nie trzeba takich nazw uzywac -- konfigurujesz obiekt Chameleon nazwami tych katalogow -- dopisz ze sa to defaultowe nazwy i mozna uzyc innych i t tym-a-tymn miejscu to ustawic.

3. http://www.vertis.com.pl/doc/doku.php?id=budowa_szablonow
a co robi tam foo_bar? spracyzuj dozwolone znaki (ew. oddaj regexpa walidujacego nazwe).

4.
A jak ja indeksujemy? Jak indeksowac liczbamnia a jak stringami (chodzi o apostrofy/cydzysl.)


5. Tablice tez.
Brakowalo mi odnosnikow "parametr jest opisany tutaj (click)" do opisu parametrow w opisie tablic, funkcji itd.
Dalej nie ma info o apostrofach dla parametrow tekstowych.

6. A jest co zaokraglac? Przeciez nie podaje sie wielkosci pliku w stylu: 3,45B -- bo bajty sa tylko cale (nie da sie zapisac pojedynczych bitow). Troche niejasno to napisales.

7.

[PHP] pobierz, plaintext 
<?php
/* Jeśli szablon posiada plik cache, nie ma potrzeby definiować zmiennych */
	if (!$tpl -> cached())
	{
		/* Ustawienie zmiennych "kto" oraz "co" */
		$tpl -> setVar('kto', 'misiu');
?>
[PHP] pobierz, plaintext 

Dotyczy kodu Chameleona -- a nie prosciej dla usera byloby dodanie takze do metody setVar() sprawdzenia :

[PHP] pobierz, plaintext 
<?php
if ( $this->cached() )
{
	return
	}
//... ustawianie zmiennej
?>
[PHP] pobierz, plaintext 

Wtedy mozna by pominac ta konstrukcje warunkowa if ( ! tpl->cached() )

8. http://www.vertis.com.pl/doc/doku.php?id=modyfikatory

Brakuje opisu definiujacego koplejnosc parametrow, tzn. "parametry sa wypisane w kolejnosci w jakiej musza/maja wystepowac w modyfikatorze", lub dodaj je w definicji modyfikatora: modyfikator( param1, par2, ... )

9. http://www.vertis.com.pl/doc/doku.php?id=funkcje

Kiedy warunek NIE jest spelniony? Gdy warunek === FALSE czy np. "" lub zero (0)?


10. list()


(Smartyego nie pamietam juz) Nie rozumiem jak dziala list()... Mam tablice TAB
{@list(TAB)}
{TAB['indeks']} <<< tutaj TAB jest elementem tablicy TAB? a 'indeks' wyciaga element (drugi wymiar) tego elementu?
{@end}

Poza tym ta tablica chyba nie musi byc jednowymiarowa? Bo mozna chyba zagniezdzac list()'a?

11. math()

Jak wstawiac wyrazenie matematyczne jako parametr? W apostrofach, bez? Jakie funkje, operatory sa dostepne?



12. http://www.vertis.com.pl/doc/doku.php?id=pluginy


Niby referencja jest zaznaczona w nazwie parametru a jednak przydala by sie notka ze te parametry musza byc przekazywane przez referencje -- przeciez to jest wazne gdy chcemy zmodyfikowac zmienna.


13. JAk dziala modyfikator?
Kiedy jest zmieniona na stale wartos podanej zmiennej? Co trzeba zrobic zeby ja na stale zmienic (oproch $overwrite), chyba ($input = 'cosNowego' ?)?
Co sie dzieje z wartosci zwrocona przez modyfikator?

14.
Jak to zrobic?

XX. Chyba tak

Tyle

u la la bonzo bardzo cenne uwagi , poprawki beda naniesione ale juz nie dzis

co do


parametry przekazuje sie dowlnie jak w htmlu np :

{zmienna|modyfikator(param1="foo" param2="bar")}

zadziala tak samo jak :

{zmienna|modyfikator(param2="bar" param1="foo")}

chyba tam wspomnialem o tym, moze niezbyt jasno

Jeszcze raz dzieki

Pardon -- tak wspominales. Tylko ja to szybko czytalem i zapamietalem: drugiego parametru nie mozna podawac w skroconej wersji (tak jak pierwszego). I stad sie wzielo: brak kolejnosci parametrow.

http://www.vertis.com.pl/doc/doku.php?id=changeLog

w changelog'u na dole:

- optymalizacje kodu, zwrost wydajności od 15% do 25%
- nowa funkcja lączenia szablonów : inc(szablon)

Poprawki naniesione

@dr_bonzo : punktem 13. JAk dziala modyfikator? podsunales mi ciekawy pomysl, to czy modyfikator ma dokonac trwalej modyfikacji czy nie mozna rozwiazac lepszym sposobem niz parametr overwrite, ktory obecnie jest jedynym sposobem. mozna by uzyc do tego celu podwojnego znaku ||

{zmienna|modyfikator} wyswietlenie zmodyfikowanej zmiennej
{zmienna||modyfikator} wyswietlenie zmodyfikowanej na stałe zmiennej

@dr_bonzo, ActivePlayer, sinq : http://www.vertis.com.pl/doc/doku.php?id=c...n#podziekowania
Chyba, że wolicie inną formę podpisu to krzyczeć