ci: generate doxygen gh-pages (#3000)

[hyoklee]

This will generate Doxgen documents under:

https://HDFGroup.github.io/hdf5/develop

https://HDFGroup.github.io/hdf5/1.14.1

To see the updated documents,
the repository owner should give the proper permission and
activate pages following this guide:

https://docs.github.com/en/pages/quickstart

Here are the working demo pages:

https://hyoklee.github.io/actions/develop/
https://hyoklee.github.io/actions/1.14.1/

Close #3000.

[brtnfld]

I don't think we want this for each PR, and it should be a weekly update for develop, IMHO.

For 1.14.x, the document should only be updated/generated for a release.

[hdfeos]

I want to recommend it for each PR because developers often forget to document codes properly.
Doxygen is very good at detecting lexical error.
It is also useful for writing documentation first approach in software development (e.g., API prototyping with skeleton).

By the way, please check these URLs if you want to see the latest manuals until this action is merged:

https://hdfeos.github.io/hdf5/develop/
https://hdfeos.github.io/hdf5/1.14.1/

[brtnfld]

We discussed a separate action to check for doxygen warnings and other issues for PRs. This #3000 is for generating up-to-date docs.

[byrnHDF]

the daily-build process shouild generate docs - there should be a PR check ci for warnings only.

[hyoklee]

@byrnHDF Where does the daily generated docs go? Are they available on any website?

[byrnHDF]

Why build 1.14.1 docs in a develop PR? Also, this file will need to be fixed every time 1.14 is released.

[lkurz]

[Get branch name · Actions · GitHub Marketplace]
( https://github.com/marketplace/actions/get-branch-name )

[hyoklee]

@byrnHDF Thanks for reviewing! This PR was a quick demo patch for @brtnfld to show him how both develop & 1.14.1-2 Doxygen documentation should look like on GH pages since S3 docs were out of sync.

[derobins]

Allen's PRs create doxygen now

[hyoklee]

@derobins Does @byrnHDF PRs generate gh-pages? Where are they?

[byrnHDF]

@derobins Does @byrnHDF PRs generate gh-pages? Where are they?

First things first! It is in process.