Doxyfile

# Doxyfile for SleakEngine

PROJECT_NAME           = "SleakEngine"
PROJECT_NUMBER         = "0.1.0"
PROJECT_BRIEF          = "C++23 multi-backend game engine"
OUTPUT_DIRECTORY       = docs

CREATE_SUBDIRS         = NO
ALLOW_UNICODE_NAMES    = YES
OUTPUT_LANGUAGE        = English

# Input source files and directories
INPUT                  = docs/mainpage.md \
                         docs/pages \
                         include/public \
                         include/private \
                         src \
                         docs/groups.dox \
                         docs/namespaces.dox
USE_MDFILE_AS_MAINPAGE = docs/mainpage.md
RECURSIVE              = YES
FILE_PATTERNS          = *.hpp \
                         *.h \
                         *.cpp \
                         *.md \
                         *.dox

# Vendor symbols that would otherwise surface in the namespace/class lists.
# YAML is the only one currently reachable (yaml-cpp convert<> specializations
# in src/Core/Serializable.cpp); the rest are defensive.
# Sleak::RenderEngine::Sleak is a phantom namespace Doxygen synthesizes from a
# misplaced #include inside a namespace block (src/Graphics/DirectX11/
# DirectX11Buffer.cpp:202). It duplicates the exception hierarchy, Logger, and
# Math one level too deep. Drop this entry once that include moves to the top.
EXCLUDE_SYMBOLS        = YAML YAML::* ImGui ImGui::* ImGui_* Im[A-Z]* \
                         spdlog spdlog::* fmt fmt::* FMT_* \
                         Assimp Assimp::* ai[A-Z]* \
                         SDL SDL_* nlohmann nlohmann::* stbi_* glad_* gl[A-Z]* \
                        

EXTENSION_MAPPING      = hpp=C++ \
                         h=C++ \
                         cpp=C++

# Extraction settings
EXTRACT_ALL            = YES
EXTRACT_PRIVATE        = NO
EXTRACT_PRIV_VIRTUAL   = NO
EXTRACT_PACKAGE        = YES
EXTRACT_STATIC         = YES
EXTRACT_LOCAL_CLASSES  = YES
EXTRACT_LOCAL_METHODS  = YES
EXTRACT_ANON_NSPACES   = NO
HIDE_UNDOC_MEMBERS     = NO
HIDE_UNDOC_CLASSES     = NO
HIDE_FRIEND_COMPOUNDS  = NO
HIDE_IN_BODY_DOCS      = NO
INTERNAL_DOCS          = NO
CASE_SENSE_NAMES       = YES
SHORT_NAMES            = NO
SHOW_INCLUDE_FILES     = YES
SHOW_GROUPED_MEMB_INC  = YES
FORCE_INCLUDES         = NO
INLINE_INFO            = YES
SORT_MEMBER_DOCS       = YES
SORT_BRIEF_DOCS        = YES
SORT_MEMBERS_CTORS_1ST = YES

# Markdown & formatting
MARKDOWN_SUPPORT       = YES
AUTOLINK_SUPPORT       = YES
BUILTIN_STL_SUPPORT    = YES
CPP_CLI_SUPPORT        = NO
SIP_SUPPORT            = NO

# Preprocessing
ENABLE_PREPROCESSING   = YES
MACRO_EXPANSION        = YES
EXPAND_ONLY_PREDEF     = NO
SEARCH_INCLUDES        = YES
INCLUDE_PATH           = include/public \
                         include/private

# Warnings and logging
QUIET                  = YES
WARNINGS               = YES
WARN_IF_UNDOCUMENTED   = NO
WARN_IF_DOC_ERROR      = YES
WARN_NO_PARAMDOC       = NO

# Output Formats
GENERATE_HTML          = YES
HTML_OUTPUT            = html
HTML_FILE_EXTENSION    = .html
HTML_COLORSTYLE        = LIGHT
HTML_COLORSTYLE_HUE    = 210
HTML_COLORSTYLE_SAT    = 100
HTML_COLORSTYLE_GAMMA  = 80
HTML_DYNAMIC_MENUS     = YES
HTML_DYNAMIC_SECTIONS  = YES
HTML_INDEX_NUM_ENTRIES = 100
GENERATE_DOCSET        = NO
GENERATE_HTMLHELP      = NO
GENERATE_CHI           = NO
GENERATE_QHP            = NO
GENERATE_ECLIPSEHELP   = NO
GENERATE_TREEVIEW      = YES
TREEVIEW_WIDTH         = 335
ENUM_VALUES_PER_LINE   = 4

GENERATE_LATEX         = NO
GENERATE_RTF           = NO
GENERATE_MAN           = NO
GENERATE_XML           = NO
GENERATE_DOCBOOK       = NO

# Diagrams and Graphs (Graphviz/dot)
HAVE_DOT               = YES
DOT_NUM_THREADS        = 4
DOT_FONTNAME           = Helvetica
DOT_FONTSIZE           = 10
DOT_FONTPATH           =
CLASS_GRAPH            = YES
COLLABORATION_GRAPH    = NO
GROUP_GRAPHS           = YES
UML_LOOK               = YES
UML_LIMIT_NUM_FIELDS   = 10
DOT_UML_DETAILS        = YES
DOT_WRAP_THRESHOLD     = 17
TEMPLATE_RELATIONS     = YES
INCLUDE_GRAPH          = NO
INCLUDED_BY_GRAPH      = NO
CALL_GRAPH             = NO
CALLER_GRAPH           = NO
GRAPHICAL_HIERARCHY    = YES
DIRECTORY_GRAPH        = YES
DOT_IMAGE_FORMAT       = svg
INTERACTIVE_SVG        = YES
DOT_GRAPH_MAX_NODES    = 100
MAX_DOT_GRAPH_DEPTH    = 0

WARN_IF_INCOMPLETE_DOC = YES

WARN_LOGFILE           = docs/doxygen_warnings.log

DISABLE_INDEX          = NO

FULL_SIDEBAR           = NO

HTML_EXTRA_STYLESHEET  = docs/theme/doxygen-awesome.css \
 docs/theme/custom.css
HTML_EXTRA_FILES       = docs/theme/logo-256.png \
 docs/theme/doxygen-awesome-darkmode-toggle.js \
 docs/theme/doxygen-awesome-fragment-copy-button.js \
 docs/theme/doxygen-awesome-interactive-toc.js \
 docs/theme/doxygen-awesome-paragraph-link.js \
 docs/theme/favicon.png
HTML_HEADER            = docs/theme/header.html

SOURCE_BROWSER         = YES

STRIP_CODE_COMMENTS    = NO

GENERATE_TAGFILE       = docs/SleakEngine.tag

SHOW_USED_FILES        = NO

TIMESTAMP              = YES

PROJECT_LOGO           = docs/theme/logo.svg

TOC_INCLUDE_HEADINGS   = 2

LAYOUT_FILE            = docs/theme/DoxygenLayout.xml

IMAGE_PATH             = docs/images