1. casa
  2. Domanda e risposta
  3. Eventuali tutorial su come usare phpDocumentor?

Eventuali tutorial su come usare phpDocumentor?

2009-12-02 20 views
21

Voglio iniziare a utilizzare phpDocumentor ma sto trovando difficile andare - l'interfaccia web non sta giocando bene e non riesco a farlo analizzare i file di esempioEventuali tutorial su come usare phpDocumentor?

Probabilmente non l'ho impostato correttamente e Vorrei un bel tutorial step-by-step (cioè NOT THIS ONE) per verificare dove ho sbagliato e si spera farlo parsing qualcosa

Ma io non riesco a trovare nulla tramite google - qualcuno può suggerire eventuali buoni tutorial o risorse per iniziare con phpdoc?

Grazie mille!

Ian

EDIT: Grazie per saltare in, ashnazg! Questi sono stati i passi che ho seguito:

  1. Pera non funzionava sul mio Mac in modo scaricato la versione 1.4.3 e decompressi in una directory
  2. specificato il percorso assoluto di assaggiare file di 2 sul mio HD nella scheda di file
  3. Specificata una cartella di output che era scrivibile in tutto il mondo
  4. Clicked Crea ... roba in corso nel registro, cartella multimediale creata ma nessun rapporto. Il registro conclude "ERRORE: niente analizzato"

Da quando Pear ha funzionato e installato phpdoc in questo modo; può usarlo attraverso la riga di comando, ma qualche idea su cosa potrebbe essere successo con l'interfaccia web per impedirgli di analizzare il file? Sembra essere felice sotto tutti gli altri aspetti.

MODIFICA 2: Grazie per il collegamento allo Developer.com article, Liz: È molto semplice ma un utile quickstart.

fonte

2009-12-02 Polsonby

+0

Secondato. Scrivo codice phpDoc da più di un anno, ma non ho mai fatto funzionare il dannato. Sarei davvero grato per un buon tutorial passo-passo. L'interfaccia web e la documentazione lasciano molto a desiderare. –

+0

ERRORE: niente analizzato ===> è necessario specificare il percorso della scansione -d ./ C: \ xampp \ htdocs \ my_project> phpdoc -o HTML: frame: earthli, PDF: default: default -t ./docs -d ./ – websky

risposta

-1

Google è tuo amico :)

ecco uno: http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_phpDocumentor.howto.pkg.html

fonte

2009-12-02 16:40:40

+2

Questo è davvero straordinariamente inutile: se leggi la domanda che ho chiesto, è lo stesso a cui mi sono collegato. Il punto è che le istruzioni qui non funzionano per me e ho chiesto altri tutorial. – Polsonby

+0

Hai ragione, ti ho dato la risposta sbagliata. Questo aiuto? http://www.developer.com/lang/php/article.php/10941_3440261_2/Documenting-PHP-Code-with-PHPDocumentor.htm –

+0

Grazie per quello; sì, ho trovato che usare anche Google :) Ma è abbastanza buono. – Polsonby

0

io non sono a conoscenza di questi tutorial per quanto riguarda utilizzando l'interfaccia web. In realtà non ho molte domande per il supporto che lo utilizzano. Se puoi evidenziare come stai usando senza successo, potrei aiutarti.

fonte

2009-12-03 11:42:37 ashnazg

+0

Grazie per questo - ho aggiunto alcune spiegazioni al mio post sopra – Polsonby

+0

"ERRORE: niente analizzato" indica che phpDocumentor non pensa di aver dato alcun file PHP da elaborare. Dai un'occhiata più da vicino all'output di runtime, e vedi se riesci a individuare dove tenta di utilizzare il percorso assoluto che hai fornito. La mia prima impressione potrebbe essere che contiene una cartella con uno spazio nel suo nome ... che potrebbe causare un problema. – ashnazg

1

Personalmente, uso tag standard JavaDoc e un piccolo programma Python per convertire il mio PHP in file Java (con corpi di metodo vuoti). Quindi eseguo JavaDoc: mi piacciono le funzionalità e l'aspetto molto meglio di qualsiasi altra cosa abbia visto. Bene, ho iniziato con java prima di PHP.

Questo piccolo programma Python è parte della mia roba PHP e può essere trovato su

http://code.google.com/p/mcrwebapp/source/browse/trunk/tools/php2java

(per quello che vale.)

fonte

2009-12-07 05:29:25 Don

+0

Don molto interessante, JavaDoc è sempre stato il mio preferito. Non che sarebbe un compito enorme, ma ti dispiacerebbe condividere il tuo programma Python per convertire il PHP in uno scheletro di Java? – defines

5

La documentazione non ti dice questo, ma si deve spostare il campione file in una directory che non ha la stringa "tutorial" in qualsiasi punto del percorso. phpDocumentor considera "tutorial" come una parola riservata e rifiuta di analizzare tutti i file che lo hanno nel percorso.

fonte

2010-11-02 19:28:49 phenry

Problemi correlati

 Problemi correlati