Diskuze: Generování PHP dokumentace

PHP PHP Generování PHP dokumentace American English version English version

Avatar
Inoue Yūki
Redaktor
Avatar
Inoue Yūki:

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
Avatar
David Čápka
Tým ITnetwork
Avatar
Odpovídá na Inoue Yūki
David Čápka:

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
Miluji svou práci a zdejší komunitu, baví mě se rozvíjet, děkuji každému členovi za to, že zde působí.
Avatar
Inoue Yūki
Redaktor
Avatar
Odpovídá na David Čápka
Inoue Yūki:

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

Nahoru Odpovědět 2.2.2014 13:49
Avatar
Drahomír Hanák
Tým ITnetwork
Avatar
Odpovídá na Inoue Yūki
Drahomír Hanák:

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  +1 2.2.2014 13:55
Avatar
Inoue Yūki
Redaktor
Avatar
Odpovídá na Drahomír Hanák
Inoue Yūki:

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

Nahoru Odpovědět 2.2.2014 14:12
Avatar
mkub
Redaktor
Avatar
Odpovídá na David Čápka
mkub:

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 Čápka
Tým ITnetwork
Avatar
Odpovídá na mkub
David Čápka:

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  ±0 3.2.2014 17:23
Miluji svou práci a zdejší komunitu, baví mě se rozvíjet, děkuji každému členovi za to, že zde působí.
Avatar
Petr Nymsa
Redaktor
Avatar
Odpovídá na David Čápka
Petr Nymsa:

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  +2 3.2.2014 17:26
Pokrok nezastavíš, neusni a jdi s ním vpřed
Avatar
mkub
Redaktor
Avatar
Odpovídá na David Čápka
mkub:

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
Redaktor
Avatar
Odpovídá na Petr Nymsa
mkub:

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  +1 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.