minor changes to cmake and travis build

.travis.yml

@@ -14,40 +14,42 @@ matrix:
           addons:
               apt:
                   sources: ['ubuntu-toolchain-r-test', 'llvm-toolchain-precise-3.5', 'george-edison55-precise-backports']
-                  packages: ['clang-3.5', 'lcov', 'cmake', 'cmake-data']
+                  packages: ['clang-3.5', 'lcov', 'cmake', 'cmake-data', 'doxygen']
         - dist: xenial
           compiler: clang
           env: INSTALL_CXX=clang++-3.6
           addons:
               apt:
                   sources: ['ubuntu-toolchain-r-test', 'llvm-toolchain-precise-3.6', 'george-edison55-precise-backports']
-                  packages: ['clang-3.6', 'lcov', 'cmake', 'cmake-data']
+                  packages: ['clang-3.6', 'lcov', 'cmake', 'cmake-data', 'doxygen']
         - dist: xenial
           compiler: gcc-5
           env: INSTALL_CXX=g++-5 INSTALL_CC=gcc-5
           addons:
               apt:
                   sources: ['ubuntu-toolchain-r-test', 'george-edison55-precise-backports']
-                  packages: ['g++-5', 'lcov', 'cmake', 'cmake-data']
+                  packages: ['g++-5', 'lcov', 'cmake', 'cmake-data', 'doxygen']
         - dist: xenial
           compiler: gcc-9
           env: INSTALL_CXX=g++-9 INSTALL_CC=gcc-9
           addons:
               apt:
                   sources: ['ubuntu-toolchain-r-test', 'george-edison55-precise-backports']
-                  packages: ['g++-9', 'lcov', 'cmake', 'cmake-data']
+                  packages: ['g++-9', 'lcov', 'cmake', 'cmake-data', 'doxygen']
         - os: osx
           osx_image: xcode10.1
           compiler: clang
           env: INSTALL_CXX=clang++ INSTALL_CC=clang
+          install:
+              - brew install doxygen
 
 before_install:
     - gem install coveralls-lcov
 
 script:
     - mkdir -p build
     - cd build
-    - CC=$INSTALL_CC CXX=$INSTALL_CXX cmake ../ -DMeshIO_BUILD_COVERAGE:BOOL=ON
+    - CC=$INSTALL_CC CXX=$INSTALL_CXX cmake ../ -DMeshIO_BUILD_COVERAGE:BOOL=ON -DMeshIO_BUILD_DOCS:BOOL=ON
     - make -j4
     - ctest --output-on-failure
 
@@ -57,5 +59,15 @@ after_success:
         brew install lcov;
       fi
     - lcov --directory test --base-directory ../include/meshio/ --capture --no-external --output-file coverage.info
+    - genhtml coverage.info --output-directory ./docs/html/coverage
     - lcov --remove coverage.info '/usr*' -o coverage.info
     - coveralls-lcov coverage.info
+
+deploy:
+    provider: pages
+    skip_cleanup: true
+    local_dir: ./build/docs/html
+    github_token: $GH_REPO_TOKEN
+    on:
+        branch: master
+        os: osx

CMakeLists.txt

@@ -64,4 +64,4 @@ install(DIRECTORY "${CMAKE_CURRENT_LIST_DIR}/include"
 )
 
 mark_as_advanced(MeshIO_BUILD_COVERAGE)
-mark_as_advanced(MeshIO_BUILD_DOCS)
+mark_as_advanced(MeshIO_BUILD_EXAMPLES)

README.md

@@ -9,3 +9,11 @@ Currently supported formats
 * STL
 
 We plan to add support for Wavefront OBJ format next.
+
+## Documentation
+
+* [Documentation]
+* [Coverage]
+
+[Documentation]: https://9prady9.github.io/meshio/
+[Coverage]: https://9prady9.github.io/meshio/coverage

docs/doxygen.mk

@@ -1032,7 +1032,7 @@ HTML_OUTPUT            = html
 # The default value is: .html.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_FILE_EXTENSION    = .htm
+HTML_FILE_EXTENSION    = .html
 
 # The HTML_HEADER tag can be used to specify a user-defined HTML header file for
 # each generated HTML page. If the tag is left blank doxygen will generate a

docs/pages/README.md

@@ -15,6 +15,14 @@ A header only library to load/store polygonal meshes.
 
 No Examples Written Yet.
 
+## Documentation
+
+* [Documentation]
+* [Coverage]
+
 #### Email
 
 * Engineering: [email protected]; [email protected]
+
+[Documentation]: https://9prady9.github.io/meshio/
+[Coverage]: https://9prady9.github.io/meshio/coverage