doxygen + sfinge (respirare) per documentazione

Question

Sono nuovo per l'uso di ossigeno e sfinge. Ho l'obbligo di creare documenti che sono programmati in linguaggio C. L'idea è di generare file xml da doxygen per ogni file e quindi utilizzare breathe come un ponte per sfinge per creare pagine html. Sono riuscito a generare i file xml e sono in grado di ottenere anche le pagine html. Tuttavia, vedo che ogni file html contiene tutti i contenuti del file, piuttosto che ogni html per file/directory.

ie. dir1 => file1.h and file1.c 
    dir2 => file2.h and file2.c 

uscita:

file1.html => file1.xml & file2.xml 
file2.html => file1.xml & file2.xml 

uscita prevista

file1.html to contain file1.xml(both header the implementation) 
file2.html for file2.xml 

Qui ci sono le impostazioni: Doxyfile (Doxygen)

GENERATE_XML = YES 

conf.py (sfinge)

breathe_projects = { <dir1_name>: <xml_path>, 
        <dir2_name>: <xml_path> } 

Qualcuno potrebbe aiutarmi a impostare la configurazione corretta per ottenere l'output previsto, per favore?

Answer 1

Per il requisito precedente, è necessario creare Doxyfile per directory. Questo genererà i file XML in base a Doxyfile

i.e. for the files 
dir1 => file1.h and file1.c 
dir2 => file2.h and file2.c 

create 
Doxyfile1 in dir1 
Doxyfile2 in dir2 

Questo genera file index.xml separati per directory.

Nella configurazione Sfinge (conf.py), la posizione di XML dovrebbe essere fornito

i.e. breathe_projects = { <dir1_name>: <dir1/xml_path>, 
          <dir2_name>: <dir2/xml_path> } 

Con le modifiche di cui sopra, i file HTML separato - file1.html (con file1.h e file1.c) e file2.html (con file2.h e file2.c) vengono generati.