doxygenize

This is a GitHub Action to automatically generate Doxygen code documentation and publish it to GitHub Pages. The generator only supports HTML format, and currently it cannot handle LaTeX outputs.

Setup

• Generate a default Doxygen configuration file called Doxyfile (Special thanks to @MatiasLGonzalez for correcting me and also adding dot tool support);
• Disable the following option in the Doxygen configuration file:

GENERATE_LATEX         = NO

• doxygen is called from the root directory of your repository, so any path on your Doxyfile should be relative to this directory and NOT relative to directory where your Doxyfile is located, i.e. if you have a project set up like:

.
│     
├───src
│   ├───sourcefile1.c
│   └───sourcefile2.c
├───docs
└───doc
    └───Doxyfile

then your OUTPUT_DIRECTORY, HTML_OUTPUT and INPUT variables (and any other path variable) should be set like

OUTPUT_DIRECTORY       = ./ # Relative path to root of your repository (e.g, ./)
INPUT                  = ./src # Relative path to root of your repository (e.g, ./src)
HTML_OUTPUT            = ./docs # Relative path to root of your repository

• Enable GitHub Pages branch (i.e., gh-pages) on your repository using this tutorial;
• Copy the Doxygen configuration file to root of your repository;
• Call action/checkoutv2 in the workflow to clone the repository;
• Add following step to your respository workflow script:

uses: langroodi/doxygenize@[version/tag/commit hash (i.e., v1)]

• In case of different:
  • Doxygen configuration file name and/or path;
  • HTML output folder;
  • GitHub Pages branch name;
  • GitHub Pages home directory which contains index.html file;
  • Using Doxygen Dark Mode (partially tested on Mozilla 96.0 (64-bit) for Ubuntu)

please refer to the Inputs section.

Inputs

Name	Type	Default	Description
doxygenconf	string	./Doxyfile	Doxygen configuration file path
htmloutput	string	./docs/	Doxygen-generated HTML files output folder
ghpagesbranch	string	gh-pages	Repository branch which is selected as the host of GitHub Pages
ghpagesdir	string	./	GitHub Pages home directory in the GitHub Pages branch
darkmode	boolean	false	Switching between Dark Mode and Light Mode
customheader	string	empty	Customized Doxygen HTML pages header file URL

# In the case of no checkout action call in the whole build script, following action should be called before executing the doxygenize action
uses: actions/checkout@v3
uses: langroodi/doxygenize@[version/tag/commit hash (e.g., v1)]
with:
    doxygenconf: '[Configuration file path including the file name (e.g., ./doc/doxygen.conf)]'
    htmloutput: '[HTML output folder (e.g., ./doc/html/)]'
    ghpagesbranch: '[GitHub Pages branch name (e.g., master)]'
    ghpagesdir: '[GitHub Pages directory path (e.g., ./docs/)]'
    darkmode: '[true to enable Doxygen dark theme; otherwise use Doxygen default theme]'
    customheader: '[HTML header file URL (e.g., https://raw.githubusercontent.com/langroodi/doxygenize/master/header/woman_life_freedom.html)]'

Semantic versioning

Following is the latest doxygenize version:

Release version	Docker image	Tag aliases
v1.7.0	Alpine 3.15.4	v1, v1.7