How to include folder in doxygen documentation?

I want to include folder in doxygen documentation.

I have tried \page and \include but it hasn't worked, does anyone know how to do it? Here is the tree :

+root
-+controllers
--- category.php
-+models
--- categories.php
- mai开发者_JAVA百科npage.php

To add to the comments on your question, the \page command will add pages into your documentation that you have manually written. I.e. if a source file contains a \page declaration it will add the contents to the documentation index. You can add extra help here, such as:

/*! \page overviewpage Architecture Overview
 *
 * \section memorymanagement Memory Management
 *
 * Some writing you want to appear as a help page in the documentation here.
 */

The \include command will include a copy of a file as a source code block.

I think you're actually asking how you get Doxygen to add multiple source directories. As long as the recursive setting is YES, which is not the default, it should work fine for your structure if you've set the root folder as the Doxygen input.

RECURSIVE              = YES

If you haven't, you can add different folders like this, with paths relative to the Doxyfile file.

#---------------------------------------------------------------------------
# configuration options related to the input files
#---------------------------------------------------------------------------

# The INPUT tag can be used to specify the files and/or directories that contain 
# documented source files. You may enter file names like "myfile.cpp" or 
# directories like "/usr/src/myproject". Separate the files or directories 
# with spaces.

INPUT                  = src test/src

The solution by @Martin Foot doesn't work when there are spaces in your folder names because then doxygen treats those as separate filepaths. If you quote the whole thing, that doesn't work. Taking inspiration from here ... Excluding directories for Doxygen

Here is my proposed solution, where you quote each folder, and use the multiline syntax

INPUT                  = "src" 
INPUT                  += "spaced folder/test/src"

Reference: https://www.doxygen.nl/manual/config.html

the += operator can be used instead of = to append new values to the list.