integrate doxygen with sphinx using breathe

docs/source/conf.py

@@ -31,7 +31,8 @@ release = '1.0'
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    'sphinx.ext.imgmath'
+    'sphinx.ext.imgmath',
+    'breathe'
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -55,7 +56,6 @@ html_theme = 'alabaster'
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
 
-
 ## Read the docs style:
 if os.environ.get('READTHEDOCS') != 'True':
     try:
@@ -68,3 +68,12 @@ if os.environ.get('READTHEDOCS') != 'True':
     
 #def setup(app):
 #    app.add_stylesheet("fix_rtd.css")
+
+
+# -- Breathe configuration -------------------------------------------------
+
+breathe_projects = {
+	"LBPM Doxygen": "/home/mcclurej/local/dev/LBPM/doc/xml/"
+}
+breathe_default_project = "LBPM Doxygen"
+breathe_default_members = ('members', 'undoc-members')

docs/source/developerGuide/doxygen/Analysis.rst

@@ -0,0 +1,9 @@
+###############################################################################
+Analysis methods
+###############################################################################
+
+.. toctree::
+   :glob:
+   :maxdepth: 2
+   
+   analysis/*

docs/source/developerGuide/doxygen/Models.rst

@@ -0,0 +1,10 @@
+###############################################################################
+Models
+###############################################################################
+
+.. toctree::
+   :glob:
+   :maxdepth: 2
+
+   models/*
+   

docs/source/developerGuide/doxygen/ScaLBL.rst

@@ -0,0 +1,5 @@
+============================================
+Scalable Lattice Boltzmann Library (ScalBL)
+============================================
+.. doxygenfile:: ScaLBL.h
+   :project: LBPM Doxygen

docs/source/developerGuide/doxygen/analysis/DCEL.rst

@@ -0,0 +1,5 @@
+============================================
+DCEL
+============================================
+.. doxygenfile:: dcel.h
+   :project: LBPM Doxygen

docs/source/developerGuide/doxygen/analysis/FlowAdaptor.rst

@@ -0,0 +1,5 @@
+============================================
+FlowAdaptor
+============================================
+.. doxygenfile:: FlowAdaptor.h
+   :project: LBPM Doxygen

docs/source/developerGuide/doxygen/analysis/Minkowski.rst

@@ -0,0 +1,5 @@
+============================================
+Minkowski
+============================================
+.. doxygenfile:: Minkowski.h
+   :project: LBPM Doxygen

docs/source/developerGuide/doxygen/analysis/SubPhase.rst

@@ -0,0 +1,5 @@
+============================================
+SubPhase analysis 
+============================================
+.. doxygenfile:: SubPhase.h
+   :project: LBPM Doxygen

docs/source/developerGuide/doxygen/models/ColorModel.rst

@@ -0,0 +1,5 @@
+============================================
+Color Model 
+============================================
+.. doxygenfile:: ColorModel.h
+   :project: LBPM Doxygen

docs/source/developerGuide/doxygen/models/FreeEnergyModel.rst

@@ -0,0 +1,5 @@
+============================================
+Free Energy Model
+============================================
+.. doxygenfile:: FreeLeeModel.h
+   :project: LBPM Doxygen

docs/source/developerGuide/doxygen/models/GreyscaleModel.rst

@@ -0,0 +1,5 @@
+============================================
+Greyscale Model 
+============================================
+.. doxygenfile:: GreyscaleModel.h
+   :project: LBPM Doxygen

docs/source/developerGuide/doxygen/models/MRTModel.rst

@@ -0,0 +1,5 @@
+============================================
+Multi-relaxation time (MRT) Model 
+============================================
+.. doxygenfile:: MRTModel.h
+   :project: LBPM Doxygen

docs/source/developerGuide/doxygen/models/NernstPlanckModel.rst

@@ -0,0 +1,5 @@
+============================================
+Ion Model 
+============================================
+.. doxygenfile:: IonModel.h
+   :project: LBPM Doxygen

docs/source/developerGuide/doxygen/models/PoissonModel.rst

@@ -0,0 +1,5 @@
+============================================
+Poisson Model 
+============================================
+.. doxygenfile:: PoissonSolver.h
+   :project: LBPM Doxygen

docs/source/developerGuide/index.rst

@@ -15,4 +15,8 @@ into the framework.
 
    testingModels/*
 
- 
+   doxygen/ScaLBL.rst
+
+   doxygen/Models.rst
+
+   doxygen/Analysis.rst