Vydělávej až 160.000 Kč měsíčně! Akreditované rekvalifikační kurzy s garancí práce od 0 Kč. Více informací.
Hledáme nové posily do ITnetwork týmu. Podívej se na volné pozice a přidej se do nejagilnější firmy na trhu - Více informací.

Diskuze: Generování PHP dokumentace

Aktivity
Avatar
Neaktivní uživatel
Tvůrce
Avatar
Neaktivní uživatel:1.2.2014 19:55

Zdravím,

pracuju na PHP frameworku pro LerainSoft a potřeboval bych z komentářů ve zdrojovém kódu vygenerovat dokumentaci. Narazil jsem na phpdoc a podobné, ale nevím jak se používají. Má s tím někdo zkušennosti?

Je to jeden z mých prvních projektů ve skupině, takže jsem dokumentaci nikdy nedělal. :D

Odpovědět
1.2.2014 19:55
Neaktivní uživatelský účet
Avatar
David Hartinger
Vlastník
Avatar
Odpovídá na Neaktivní uživatel
David Hartinger:2.2.2014 11:55

Tyto nástroje se bohužel instalují přes pear. To je extension do PHP, který slouží k instalaci komponent. U PHPDoc máš napsané jak se instaluje, pear je soubor někde ve složce s PHP, sputíš ho s danými parametry a on by měl doplněk nainstalovat. Nevím jestli se na Windows nemusí ještě něco nastavit, snažím se konzolím vyhýbat, takže jsem to ještě nezkoušel.

Nahoru Odpovědět
2.2.2014 11:55
New kid back on the block with a R.I.P
Avatar
Neaktivní uživatel
Tvůrce
Avatar
Odpovídá na David Hartinger
Neaktivní uživatel:2.2.2014 13:49

Aha. Radši nebudu experimentovat a udělám to manuálně.

Nahoru Odpovědět
2.2.2014 13:49
Neaktivní uživatelský účet
Avatar
Drahomír Hanák
Tvůrce
Avatar
Odpovídá na Neaktivní uživatel
Drahomír Hanák:2.2.2014 13:55

Psát dokumentaci manuálně se ti pravděpodobně nepodaří :) Už i v kódu je problém udržet dokumentační komentáře aktuální. Zkus ApiGen http://apigen.org/ Můžeš si ho normálně stáhnout a použití v konzoli je jednoduché (je to jen PHP skript)

 
Nahoru Odpovědět
2.2.2014 13:55
Avatar
Neaktivní uživatel
Tvůrce
Avatar
Odpovídá na Drahomír Hanák
Neaktivní uživatel:2.2.2014 14:12

ApiGen jsem taky zkoušel, ale nemám ponětí jak funguje.

Nahoru Odpovědět
2.2.2014 14:12
Neaktivní uživatelský účet
Avatar
mkub
Tvůrce
Avatar
Odpovídá na David Hartinger
mkub:3.2.2014 17:21

nie vsetko ide v grafike a okrem toho textovy rezim je ovela rychlejsi, nez graficky, i ked je zlozitejsi na ovladanie... ale nie vsetko sa da naklikat, napr. automatiku na stiahnutie celeho kanala z youtube s ulozenim nazvu podla preddefinovanej masky a v pozadovanom formate, aby sa ti to spustilo v urcity cas a po stiahnuti, aby sa ti to vypalilo na medium a nakoniec sam sa vypol pocitac jednoducho tak lahko nenaklikas :D budes si musiet pomoc s jednoucelovymi konzolovymi programami:

  • program na viacnasobne stiahnutie videi z youtube podla kanalu,
  • konvertor multimedii
  • konzolovy vypalovaci soft
  • prikaz shutdown (sucast systemu)
  • planovac (sucast systemu/cron)
 
Nahoru Odpovědět
3.2.2014 17:21
Avatar
David Hartinger
Vlastník
Avatar
Odpovídá na mkub
David Hartinger:3.2.2014 17:23

Všechno se dá naklikat, vždyť je jedno odkud tu logiku spustíš, jestli z konzole nebo z GUI, je stejná. Jsme lidi, ne stroje, nikdy jsem s konzolí nepracoval a nikdy mi to nechybělo, je to zastaralý způsob používání aplikací.

Nahoru Odpovědět
3.2.2014 17:23
New kid back on the block with a R.I.P
Avatar
Petr Nymsa
Tvůrce
Avatar
Odpovídá na David Hartinger
Petr Nymsa:3.2.2014 17:26

No musím se zastat konzolí například na serverech apod. Nedokážu si představit že by CISCO routery měli kompletně všechno klikatelné. Byl by to GUI masochismus :D Takže CMD se občas také hodí :)..ale na běžné používání opravdu ne

Nahoru Odpovědět
3.2.2014 17:26
Pokrok nezastavíš, neusni a jdi s ním vpřed
Avatar
mkub
Tvůrce
Avatar
Odpovídá na David Hartinger
mkub:3.2.2014 17:29

iba scasti to je pravda, ze vsetko sa da z GUI
ja mam rad aj GUI, aj konzolu, oba pristupy maju nieco do seba...

 
Nahoru Odpovědět
3.2.2014 17:29
Avatar
mkub
Tvůrce
Avatar
Odpovídá na Petr Nymsa
mkub:3.2.2014 17:33

sdraco je asi prilis pohodlny a na vsetko by najradsej chcel GUI, aj na nastavenie serverov (i ked sa da aj na server nahodit X Windows System a pracovat s nim cez VNC, ale na nahodenie XWS a potrebnych veci, je potrebne poznat aj konzolove prikazy)

 
Nahoru Odpovědět
3.2.2014 17:33
Děláme co je v našich silách, aby byly zdejší diskuze co nejkvalitnější. Proto do nich také mohou přispívat pouze registrovaní členové. Pro zapojení do diskuze se přihlas. Pokud ještě nemáš účet, zaregistruj se, je to zdarma.

Zobrazeno 10 zpráv z 10.