Doxygen for Mac OS X in Action

  • Documentazione HTML generata con Doxygen
    Documentazione HTML generata con Doxygen
  • Documentazione HTML generata con Doxygen
    Documentazione HTML generata con Doxygen
  • Generazione documentazione step 5
    Generazione documentazione step 5
  • Generazione documentazione step 4
    Generazione documentazione step 4
  • Generazione documentazione step 3
    Generazione documentazione step 5
  • Generazione documentazione step 2
    Generazione documentazione step 2
  • Generazione documentazione step 1
    Generazione documentazione step 1

Continuando la serie di articoli dedicata alla documentazione del software iniziata con l’articolo PHP Documentation APIs on the fly, vedremo come generare la documentazione del nostro software utilizzando Doxygen[1] per Mac OS X. Questo articolo è d’introduzione per il successivo che tratterà come sia possibile generare al volo la documentazione utilizzando la combinata Eclipse + Ant + Doxygen.

Lo strumento più semplice per iniziare a generare la documentazione con Doxygen è rappresentato dalla Doxygen GUI. Vedremo step-by-step tutto il processo di creazione della documentazione. La prima azione da compiere è scaricare e installare Doxygen per Mac OS X. E’ possibile scaricare il software direttamente dall’indirzzo http://ftp.stack.nl/pub/users/dimitri/Doxygen-1.7.3.dmg. La versione di Doxygen presa in considerazione è la 1.7.3 per Mac OS X 10.6 (Snow Leopard).

Ho preso come “cavia” un progetto PHP chiamato PAFS (PHP Authenticator Framework Service) progettato da me parecchi anni addietro (2005/2006).

A seguire sono illustrati gli step necessari per creare la documentazione del progetto “cavia” tramite la GUI di Doxygen. Credo che le illustrazioni siano abbastanza parlanti da non richiedere ulteriori approfondimenti.

Una sola nota che desidero fare è sulla quinta illustrazione. L’azione sul pulsante “Show Configuration” mostra all’interno della text area della GUI la configurazione utilizzata per generare la documentazione, quest’ultima può essere salvata su file per essere eventualmente ripresa per i successivi aggiornamenti della documentazione del software. Questo file di configurazione sarà poi oggetto del prossimo articolo sull’argomento, come anticipato in precedenza.

Doxygen GUI Step 1 - Dati sul progetto

Doxygen GUI Step 1 - Dati sul progetto

Doxygen GUI Step 2 - Modalità di analisi del codice

Doxygen GUI Step 2 - Modalità di analisi del codice

Doxygen GUI Step 3 - Selezione formato di Output

Doxygen GUI Step 3 - Selezione formato di Output

Doxygen GUI Step 4 - Scelta sulla generazione dei diagrammi

Doxygen GUI Step 4 - Scelta sulla generazione dei diagrammi

Doxygen GUI Step 5 - Run Doxgen

Doxygen GUI Step 5 - Run Doxgen

Documentazione HTML generata con Doxygen

Documentazione HTML generata con Doxygen con un Class Diagramm in evidenza

Documentazione HTML generata con Doxygen

Documentazione HTML generata con Doxygen con vista su metodi pubblici


[1] Doxygen è una applicazione per la generazione automatica della documentazione a partire dal codice sorgente di un generico software. È un progetto open source rilasciato sotto licenza GPL, scritto per la maggior parte da Dimitri van Heesch a partire dal 1997. Il sito ufficiale è http://www.stack.nl/~dimitri/doxygen/index.html

Antonio Musarra

I began my journey into the world of computing from an Olivetti M24 PC (http://it.wikipedia.org/wiki/Olivetti_M24) bought by my father for his work. Day after day, quickly taking control until … Now doing business consulting for projects in the enterprise application development using web-oriented technologies such as J2EE, Web Services, ESB, TIBCO, PHP.

You may also like...

Cos'è il progetto CIE/CNS Apache Docker - Developers Italia

In questo video https://youtu.be/TcAzn1POhsM introdurrò il progetto CIE/CNS Apache Docker di Developers Italia (https://developers.italia.it/it/cie/#resourcecontent-3) nato circa due anni fa.

L'obiettivo di questo progetto è quello di fornire un template pronto all'uso che realizza un sistema di autenticazione tramite la Smart Card TS-CNS (o CNS) e la CIE (Carta d'Identità Elettronica) basato su Apache HTTP. Ognuno può poi modificare o specializzare questo progetto sulla base delle proprie esigenze Si tratta di un progetto docker per la creazione di un container che implementa un sistema di mutua autenticazione o autenticazione bilaterale SSL/TLS.

Questo meccanismo di autenticazione richiede anche il certificato digitale da parte del client, certificato che in questo caso risiede all'interno della TS-CNS o della CIE. La particolarità del sistema implementato (attraverso questo container) è quella di consentire l'autenticazione tramite:

  • La TS-CNS (Tessera Sanitaria - Carta Nazionale Servizi), rilasciata dalla regione di appartenenza;
  • La CIE (Carta d'Identità Elettronica), rilasciata dal comune di residenza.

Nella versione 2.0.0 il progetto è stato aggiornato per essere uniforme alle linee guida di Bootstrap Italia. A seguire alcune risorse che possono essere utili.

  • Cos’è il progetto CIE/CNS Apache Docker (http://bit.ly/3aJ5Gbl)
  • CIE Carta d'Identità Elettronica (https://developers.italia.it/it/cie/)
  • Carta Nazionale dei Servizi (https://www.agid.gov.it/it/piattaforme/carta-nazionale-servizi)
  • Raspberry Pi – Un esempio di applicazione della TS-CNS (https://bit.ly/3hkJ8Aj)
  • Pubblicare il servizio CIE/CNS Apache Docker su Azure Cloud (http://bit.ly/3aPoq8V)
  • Come accedere al portale VETINFO tramite TS-CNS e Mac OS (http://bit.ly/2VFMKq7)