From 283a5c80cd4c55a92a742ca8fc015a0298d40665 Mon Sep 17 00:00:00 2001 From: Jonah Lawrence Date: Sat, 30 Apr 2022 21:44:35 -0600 Subject: [PATCH 1/3] feat: Add option to specify config file path --- action.yml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/action.yml b/action.yml index d0a65efe..87edef84 100644 --- a/action.yml +++ b/action.yml @@ -17,6 +17,10 @@ inputs: description: 'Folder where Doxygen will generate the HTML build files' required: true default: "docs/html" + config_file: + description: 'Path of the Doxygen configuration file' + required: true + default: "Doxyfile" runs: using: "composite" @@ -31,7 +35,7 @@ runs: shell: bash - name: Generate Doxygen Documentation - run: doxygen + run: doxygen ${{ inputs.config_file }} shell: bash - name: Create .nojekyll (ensures pages with underscores work on gh pages) From 4595c2a3c1eda14dd05462ab5cbc2392d07ead73 Mon Sep 17 00:00:00 2001 From: Jonah Lawrence Date: Sat, 30 Apr 2022 21:51:35 -0600 Subject: [PATCH 2/3] docs: Update docs to include config_file --- README.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 240734e6..6720c0ef 100644 --- a/README.md +++ b/README.md @@ -28,6 +28,7 @@ jobs: - `github_token` (required): GitHub token for pushing to repo. See the [docs](https://git.io/passing-token) for more info. - `branch` (optional): Branch to deploy to. Defaults to `gh-pages`. - `folder` (optional): Folder where the docs are built. Defaults to `docs/html`. +- `config_file` (optional): Path of the Doxygen configuration file. Defaults to `Doxyfile`. ## Advanced Usage @@ -51,6 +52,7 @@ jobs: github_token: ${{ secrets.GITHUB_TOKEN }} branch: gh-pages folder: docs/html + config_file: Doxyfile ``` ## About this Action @@ -71,10 +73,12 @@ sudo apt-get install doxygen -y ### 3. Generate Doxygen Documentation -Doxygen documentation is generated by running the following command: +Doxygen documentation is generated by running the following command. + +Set the `config_file` input option to change `Doxyfile` to a different folder. ```bash -doxygen +doxygen Doxyfile ``` ### 4. Create .nojekyll From 2a9d227eecbfebf4eb69f6ed71fb3aedc66969aa Mon Sep 17 00:00:00 2001 From: Jonah Lawrence Date: Sat, 30 Apr 2022 22:01:40 -0600 Subject: [PATCH 3/3] docs: Change text to say filename --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6720c0ef..75074634 100644 --- a/README.md +++ b/README.md @@ -75,7 +75,7 @@ sudo apt-get install doxygen -y Doxygen documentation is generated by running the following command. -Set the `config_file` input option to change `Doxyfile` to a different folder. +Set the `config_file` input option to change `Doxyfile` to a different filename. ```bash doxygen Doxyfile