Adding sphinx to target doc2 cmake build

Author: cepellotti

CMakeLists.txt

@@ -13,6 +13,9 @@ set(CMAKE_CXX_STANDARD 14)
 
 project(Phoebe C CXX Fortran)
 
+## load custom cmake find_package
+set(CMAKE_MODULE_PATH "${CMAKE_SOURCE_DIR}/cmake")
+
 if(CMAKE_CXX_COMPILER_ID MATCHES GNU)
     SET(GCC_COVERAGE_COMPILE_FLAGS "-Wall -Wextra -ggdb -fno-omit-frame-pointer -Wno-deprecated-copy -Wno-ignored-attributes")
     add_definitions(${GCC_COVERAGE_COMPILE_FLAGS})
@@ -144,14 +147,15 @@ endif()
 ############# DOCS ############
 
 find_package(Doxygen)
+find_package(Sphinx)
 
 IF (BUILD_DOC)
     IF (NOT DOXYGEN_FOUND)
         message("Doxygen need to be installed to generate the doxygen documentation")
     else()
         # set input and output files
-        set(DOXYGEN_IN ${CMAKE_CURRENT_SOURCE_DIR}/doc/Doxyfile)
-        set(DOXYGEN_OUT ${CMAKE_CURRENT_BINARY_DIR}/doc/Doxyfile.out)
+        set(DOXYGEN_IN ${CMAKE_CURRENT_SOURCE_DIR}/doc/doxygen/Doxyfile)
+        set(DOXYGEN_OUT ${CMAKE_CURRENT_BINARY_DIR}/doc/doxygen/Doxyfile.out)
 
         # request to configure the file
         configure_file(${DOXYGEN_IN} ${DOXYGEN_OUT} @ONLY)
@@ -161,9 +165,22 @@ IF (BUILD_DOC)
         add_custom_target(
             doc
             COMMAND ${DOXYGEN_EXECUTABLE} ${DOXYGEN_IN}
-            WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/../doc
+            WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/../doc/doxygen
             COMMENT "Generating API documentation with Doxygen"
             VERBATIM)
+
+	IF (NOT SPHINX_FOUND)
+	  message("Documentation needs also sphinx")
+	else()		
+	  add_custom_target(
+	    doc2
+	    COMMAND make html
+	    WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/../doc/sphinx
+	    COMMENT "Building user documentation with Sphinx"
+	    VERBATIM)
+	endif()
     ENDIF()
 endif()
 
+
+

cmake/FindSphinx.cmake

@@ -0,0 +1,14 @@
+find_program(SPHINX_EXECUTABLE NAMES sphinx-build
+    HINTS
+    $ENV{SPHINX_DIR}
+    PATH_SUFFIXES bin
+    DOC "Sphinx documentation generator"
+)
+ 
+include(FindPackageHandleStandardArgs)
+ 
+find_package_handle_standard_args(Sphinx DEFAULT_MSG
+    SPHINX_EXECUTABLE
+)
+ 
+mark_as_advanced(SPHINX_EXECUTABLE)

doc/Doxyfile renamed to doc/doxygen/Doxyfile

@@ -832,7 +832,7 @@ WARN_LOGFILE           =
 INPUT = ./doc_pages/developerOverview.md \
 	./doc_pages/Units.md \
 	./doc_pages/UnitTesting.md \
-	../src/ 
+	../../src/ 
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses

doc/doc_pages/UnitTesting.md renamed to doc/doxygen/doc_pages/UnitTesting.md

@@ -14,7 +14,7 @@ Welcome to Phoebe's documentation!
    postProcessing
    tutorials/tutorials
    theory/theory
-   Developers' documentation <../../html/index.html#http://>
+   Developers' documentation <../../../doxygen/html/index.html#http://>
 
 This is the documentation of Phoebe's project.
 

doc/doc_pages/Units.md renamed to doc/doxygen/doc_pages/Units.md

@@ -157,6 +157,7 @@ On top of that, you should also see several files named as `{prefix}.phoebe.****
 These files contain the values of the electron-phonon coupling that will be used by Phoebe.
 
 *Current limitations:*
+
 * There are restrictions to the choice of k and q points.
   The `K_POINTS` in `pw.x` must be `automatic`. The `K_POINTS` must be gamma centered.
   And the q-point mesh must be the same as the k-point mesh.