Zamyšlení – zmatení začátečníci?

… v první řadě zkusil bych do vyhledávání google nebo tady zadat dibi připojení Nette 2.
Je jen málo věcí, na které by na tomhle foru neexistovala odpověď.

Tak dokumentace nemůže obsahovat všechno, zejména pokud se preferuje nyní Nette\Database před dibi, ale i tak třeba v kuchařce se dá najít, jak na to.

Naopak se domnívám, čím více odkazů na google najdeš v souvislosti s tvým dotazem k Nette, tím lépe pro jeho příznivce. .-)

Edit: to, že v dokumentaci jsou staré/nefunkční příklady, je samozřejmě nedostatek. Stačilo by, kdyby nováčci na takové příklady upozornili a jistě to někdo z nás opraví.. já krom svého tutoriálu žadné příklady z dokumentace neviděl asi už rok, čili možná se ani neví, že je tam něco špatně, dokud na to někdo neupozorní.

Edit2: námět na řešení

Editoval 22 (24. 9. 2011 12:48)

@Mirda:

1. S Nette 2 som nikdy nemal žiadne problémy, všetko funguje ako má. Podpora je dobrá (fórum, doc, jabber)
2. Niečo také by sa určite hodilo, je to ale na autoroch tutoriálov.
3. To aj sú.
4. Súhlasím, a naďalej to platí.
5. Pretože sa tak autor rozhodol. Nette\Database je do Nette priamo zabudovaná, preto sa aj používa vo všetkých ukážkach. dibi je third-party, aj keď od toho istého autora. Nikto ale nikoho nenúti používať jedno či druhé, alebo niečo úplne iné.
6. Autori alebo dobrovoľníci, keď budú mať čas.
7. Komu sa nepáči? Mne funguje bez problémov. Stačí nemiešať medzery s tabulátormi a zvyšok je absolútne intuitívny.

Protože mi to přijde jako dost zásadní věc a tady se mi to nepodařilo najít. Chtěl jsem prostě best practice. Co je na tom špatného? Co napsat do config.neon, modelu a jak to vypsat v presenteru.

Ptám se proto, že to má být tady, jako podpora začátečníků.

Editoval Mirda (24. 9. 2011 21:32)

Na dotaz jak se připojit s Nette 2b k dibi jsem já odpovídal nejméně 3× a to nemluvím o ostatních. Stačí použít hledání vpravo nahoře tady na této stránce. Je tam takový rámeček světle modrý, tam klikneš, napíšeš co tě zajímá a čteš co to najde.

Ale klidně ti odpovím ještě jednou, extra pro tebe.

V Nette 2beta se k dibi připojuješ úplně stejně jako v Nette 0.9.

ad připojení k dibi, je to jednoduché:

1. v config.neon zadat login data, příklad zde (část production < common a development < common). K formátování config.neon používej buď mezery, nebo tabulátory, ale ne obojí (v tom případě tě na to laděnka upozorní).
2. v bootstrapu pak stačí zavolat připojení dibi::connect($container->params['database']);, tím to hasne.

Mirda napsal(a):

@ net-vor
Díky moc!!! Už jsem to rozjel. Jen jsem uvažoval o inovaci a nějak jsem se v tom zamotal. Chtěl jsem zkusit volat připojení z nějakého baseModelu. Když napíšu dibi::connect($container->params[‚database‘]); do bootstrapu, tak se vytvoří připojení automaticky bez ohledu na to, jestli zrovna používám db, nebo se mýlím?

Pridej do configu: „lazy: true“ a bude se to pripojovat, jenom, kdyz bude pripojeni k databazi treba

Imho jako zacatecnik mam problem s dokumentaci.
Nasel jsem dokumentaci k v0.9 do ktere se obcas michaji veci z 2.0

Kdyby se jasne oddelila stara dokumentace a vedle toho by se vytvoril dalsi link s dokumentaci od verze 2.0.. byla by to bomba – napr. nejakt jako je to u SFML frameworku: http://www.sfml-dev.org/tutorials/

Ale je to jen nazor jednoho kolemjdouciho cloveka, ktery s nette prisel teprve pred tydnem do styku… tak to berte s rozvahou :)

Cya.

To smasty: Jo kdyby to bylo tak jednoduché. Bohužel dokumentace je otřesná. Například hned na začátku v první aplikaci je v tasklist.php uvedeno toto:

use Nette\Database\Connection,
Nette\Database\Table\Selection;

Bohužel class Selection neexistuje. Místo něj je TableSelection atd.. opravdu podle toho se nedá učit. Nebo úplně na začátku když jsem o nette uvažoval, jsem shlédl video , které ukazuje Framework::promo, které dnes již neexistuje. Přitom v tom videu není uvedené, že je pro nette verze xy. To konec konců neuvádíte nikde. Chtělo by to udělat wiki a hezky u všeho psát verze. Skutečně mě nebaví luštit jak asi něco může fungovat. Uvědomte si, že Nette stejně jako všechny frameworky jsou velmi složitý software.

Bohužel dokumentace je otřesná.

Není, je jen neúplná. Vyvíjí se, je čím dál lepší, ale není dokonalá.

To je zcela v pořádku. Dokumentace je psána pro verzi s namespaces na PHP 5.3+. Ve verzi pro 5.2 samozřejmě namespeces nejsou a třídy se musí jmenovat jinak – v tomto případě TableSelection. Není možné udržovat dokumentaci pro každou verzi zvlášť.

Neřekl bych, že je to zcela v pořádku. Je to nedostatek dokumentace. Pro začátečníka je opravdu těžké, si tyhle věci uvědomit. Chtělo by to vymyslet způsob jak dokumentovat srozumitelně a všechny verzi současně.

Aby to bylo zcela v pořádku, tak by každý řádek kódu a každý příklad měl být napsán funkčně pro každou verzi nette. Nebo měl mít alespoň obsahovat informaci pro kterou verzi nette byl kód otestován a je použitelný bez modifikací.

Jinak si myslím, že když to přeženu, tak by bylo jednodušší a uživatelsky přívětivější udržovat jen jednu verzi nette, aby nebyly zmatky.

LeonardoCA napsal(a):
Neřekl bych, že je to zcela v pořádku. Je to nedostatek dokumentace. Pro začátečníka je opravdu těžké, si tyhle věci uvědomit. Chtělo by to vymyslet způsob jak dokumentovat srozumitelně a všechny verzi současně.

To mi nepřipadá moc reálné. Ale je fakt, že na stránce downloadu i v dokumentaci úplně chybí zdůraznění, že dokumentace je psaná výhradně pro doporučenou namespacovanou verzi Nette. To v pořádku rozhodně není.

@Tharos: S tím nelze než souhlasit. :-) Přesto si myslím, že by to na stránce downloadu a/nebo dokumentace mělo být uvedeno. Že to některé nováčky může zmást jsme o kousek výše zcela jasně viděli.

Já včera stáhl aktuální verzi Nette a chtěl použít sandbox pro nějaké pokusy. Bohužel ani samotný sanbox nefunguje. Je v něm 2× celé Nette. Musel jsem ten sandbox promazat aby fungoval :-(. Bohužel víc z hlavy nevím a teď nejsem u svého PC.

HosipLan napsal(a):

Na stránce download klikáš na odkaz „Nette Framework 2.0.3 pro PHP 5.3 nebo 5.4“ – to je ti málo?

Jestli to byla reakce na mě, tak jsem měl na mysli, že by mělo někde být výslovně uvedeno, že dokumentace je psána pro tuto verzi. Takže ano, je mi to málo.