Can I have my GitHub Pages index.html in a subfolder of the repository?

Question

I\'m trying to use GitHub pages to host a Doxygen site. Ideally, I\'d like to be able to push the generated files and directories to GitHub without having to tweak them at a

Answer 1

To use Doxygen and gh-pages, you need to:

1. Create the file .nojekyll in the root of your gh-pages branch
2. Make sure you removed .png, .html, and similars from your .gitignore file

3. And finally, create the index.html file in the root of your project:

   
   
       
           
           
           
       
       
           If you are not redirected automatically, 
           follow the link to the documentation
       
   
   

References:

1. GitHub Pages (github.io) doxygen generated page not found (404)
2. How to automatically generate doxygen documentation using Travis
3. Auto-deploying Doxygen documentation to gh-pages with Travis CI
4. https://help.github.com/categories/github-pages-basics/
5. Publish Your Project Documentation with GitHub Pages
6. How to make an introduction page with Doxygen