url pre online verziu API v1.0 je nefukcna
- edke
- Člen | 198
Mate aj vy podobny problem ? API pre 1.0 su nefunkcne, rovnako zmizli linky z download page → https://api.nette.org/nette/2.0/
Bez API som strateny a stiahnutelne v baliku je vo framoch a nie je take pekne ako online :)))
- David Grudl
- Nette Core | 8218
phpDoc je mrtvý projekt a neumí namespaces, proto hledám jiný generátor dokumentace. Současná podoba je provizorní a časově nabouraná WebExpem, tak sorry za výpadky.
- Patrik Votoček
- Člen | 2221
Doctrine 2 používá phpDoctor (btw pokud narazíš na něco použitelnějšího dej prosím vědět)
- hason
- Člen | 23
A co se podívat ještě do PEAR repozitáře na PHP_UML http://pear.php.net/…age/PHP_UML/? Používá se pro generování API dokumentace frameworku Flow3.
Editoval hason (20. 9. 2010 15:08)
- David Grudl
- Nette Core | 8218
Nejhorší na tom je, že za ten čas, co jsem vynaložil do hledání a opravování a ohýbání existujících generátorů dokumentací, bych jich měl napsaných hned několik.
- David Grudl
- Nette Core | 8218
hason napsal(a):
A co se podívat ještě do PEAR repozitáře na PHP_UML http://pear.php.net/…age/PHP_UML/? Používá se pro generování API dokumentace frameworku Flow3.
Tím je tvořena dokumentace právě teď. Jenže jsem tam musel opravit několik závažných bugů, což stálo spoustu hodin času pochopit vnitřnosti. Další hromadu času stály úpravy XSL šablon, ono to není úplně intuitivní, generátor obarvených zdrojováků jsem k tomu nenašel vůbec, neporadí si to s nativními třídami PHP, prostě poloviční práce…
Ale musím pochválit, že to dokumentaci (byť teda bez těch zdrojáků) generuje tak 50× rychleji než phpDoc ;)
- hason
- Člen | 23
David Grudl napsal(a):
Jenže jsem tam musel opravit několik závažných bugů
Bylo by určitě dobré je nahlásit a pokud existuje i řešení, tak poslat autorovi. Při nedávné diskusi o Symfony2\Finder se narazilo na chybu (nefunkční kód na Windows), ale bohužel už nebyla nálezcem hlášena. Nicméně jsem ji tedy nahlásil a nyní je už opravena. Ono to skoro vypadá, že jakýkoliv cizí kód je chápán jako konkurence a bastl, který je ponechán bez oprav těm nenettovým uživatelům.
Editoval hason (20. 9. 2010 18:07)
- Patrik Votoček
- Člen | 2221
@hason: necituj prosím zbytečně předchozí post za*** se tím zbytečně forum (citaci jsem odstranil)
btw pokud je doopravdy rychlejší napsat vlastní řešení než opravovat stávající tak je to ekonomicky výhodné a nevidím důvod proč to řešit jinak.
- Ondřej Mirtes
- Člen | 1536
Ten vlastní generátor API by stálo za to uvolnit :)
Dále se tam otevírá možnost pro nové anotace, např.
@see parent bych uvítal jako sůl :) Taky by to mohlo pracovat s
@property(-read|-write) apod.
- westrem
- Člen | 398
Viem, ze sa API generator pise nanovo ale napada ma otazka, ktora bola polozena uz aj v tomto threade
- bude v buducnu aj prelinkovanie do kodu? Je to podla mna dolezite jak sol ..
- bude tento API generator aj zverejneny? Ako sam pises, pre narocnych nie je pouzitelne mmtalne nic ..