New SciDocs for GWv1 release and LandDA capability (NCAR#1226)

* add doxygen action

* minor changes

* minor changes

* minor changes

* doxy only

* Create main.yml

* Create jekyll-gh-pages.yml

* change

* add doxyfile into wkfl

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update ccpp_doxyfile

* Update ccpp_doxyfile

* update ccpp doxyfile

* Update doxygen.yml

* update doxyfile

* Update doxygen.yml

* Update doxygen.yml

* update doxyfile

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* Update doxygen.yml

* change path

* add mactex

* add mactex

* minor changes

* minor fix

* try1

* try1

* try2

* updates

* update perl

* update perl

* update path

* explicitly install

* updates

* updates

* fix

* fix path

* fix

* fix path

* fixes

* fix3

* cleanup

* restore yml files

* hsd updates

* add doxygen.yml

* update branch

* update wflw

* test

* fix

* fix

* fix

* fix

* rearrange steps

* oops

* .

* debug

* chng dir

* chng dir

* chng dir

* -landing page

* -update para

* try to add a backlink, fix typo

* fix css link

* link path

* try cp stylesheet

* Add CCPP website

* fix

* add SRW build, backlink

* try mainpage

* changes for mainpage

* mainpage config

* mainpage config

* mainpage config

* mainpage debug

* mainpage debug

* mainpage debug

* mainpage debug

* mainpage debug

* fix landing page sidebar.

* fix landing page sidebar.

* fix landing page sidebar.

* fix landing page sidebar.

* style updates

* mainpage style

* mainpage style

* hide tree on mainpage

* add back tree

* try adding backlink

* add backlink to other pages

* updates migrated from mzhangw

* fix missed conflicts

* fix syntax

* run workflow on this branch

* remove branch from workflow run, update doxyfile

* mods to mainpag dxy

* updates

* try update for v7 arg table

* turn on scidoc branch for deploy

* recurse checkout

* fix directory

* try fix

* update landing page with acknowledgements

* fix path

* fix path

* debug

* add prebuild_config for building tables

* fix

* debug

* debug

* restructure workflow to work with metadata2html.py

* add remaining prebuild configs

* attempt fix srwv3 checkout

* fix main checkout for landing page, stash prebuild configs

* fix syntax

* update prebuild location

* workflow updates

* point to NCAR/main

* initial landDA sciDoc commits

* point to fork for testing

* point to fork for testing in 1 more place

* add sciDocs for GW release, some reorg

* point to fork

* remove main

* Changes to GW mainpage

* try fix

* fix!

* fix few things

* Add nml links

* fix land DA overview page

* fixes

* oops

* oops

* updates to GFS_ugwpv1 from Michael Toy and Bo Yang

* updates to SAMFdeep from Lisa Bengtsson

* updates from Jongil Han for convective, sfc, pbl schemes

* Update SciDoc link on README

* updates for H2O/Ozone schemes from Qingfu Lui

* fix sfclyr link

* update reference

* try bib fix

* try bib tweak

* trying to get ref to work

* fix bib links

* updates for RRTMG from Qingfu Lui

* update tracy-fork > main for merging into NCAR/main

---------

Co-authored-by: mzhangw <man.zhang@noaa.gov>
Co-authored-by: mzhangw <mzhangw@gmail.com>
Co-authored-by: Grant Firl <grant.firl@noaa.gov>

Author: 3 people

.github/workflows/doxygen.yml

@@ -65,6 +65,20 @@ jobs:
         mkdir -p $GITHUB_WORKSPACE/physics/docs/html/HSD
         mv doc/html/* $GITHUB_WORKSPACE/physics/docs/html/HSD
 
+    - name: Build GW docs
+      run: |
+        cd scm_repo/ccpp/physics/physics/docs
+        doxygen ccppgw_doxyfile
+        mkdir -p $GITHUB_WORKSPACE/physics/docs/html/GWv1
+        mv doc/html/* $GITHUB_WORKSPACE/physics/docs/html/GWv1
+
+    - name: Build Land DA docs
+      run: |
+        cd scm_repo/ccpp/physics/physics/docs
+        doxygen ccpplandda_doxyfile
+        mkdir -p $GITHUB_WORKSPACE/physics/docs/html/LandDA
+        mv doc/html/* $GITHUB_WORKSPACE/physics/docs/html/LandDA
+
     - name: Switch to v7 tag
       run: |
         cd scm_repo

README.md

@@ -7,7 +7,7 @@ Please see more information about the CCPP at the locations below.
 - [CCPP website hosted by the Developmental Testbed Center (DTC)](https://dtcenter.org/ccpp)
 - [CCPP public release information](https://dtcenter.org/community-code/common-community-physics-package-ccpp/download)
 - [CCPP Technical Documentation](https://ccpp-techdoc.readthedocs.io/en/v6.0.0/)
-- [CCPP Scientific Documentation](https://dtcenter.ucar.edu/GMTB/v6.0.0/sci_doc/index.html)
+- [CCPP Scientific Documentation](https://ncar.github.io/ccpp-physics/)
 - [CCPP Physics GitHub wiki](https://github.com/NCAR/ccpp-physics/wiki)
 - [CCPP Framework GitHub wiki](https://github.com/NCAR/ccpp-framework/wiki)
 

physics/docs/ccppgw_doxyfile

@@ -984,15 +984,15 @@ WARN_LOGFILE           =
 # spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
 # Note: If this tag is empty the current directory is searched.
 
-INPUT                  = pdftxt/HSD_overview.txt \
-                         pdftxt/Idealized_TC.txt \
-                         pdftxt/Aquaplanet.txt \
-                         pdftxt/HAFS_TC_suite.txt  \
-                         pdftxt/GFS_v17_p8_ugwpv1_aquaplanet_suite.txt \
+INPUT                  = pdftxt/HSD/HSD_overview.txt \
+                         pdftxt/HSD/Idealized_TC.txt \
+                         pdftxt/HSD/Aquaplanet.txt \
+                         pdftxt/HSD/HAFS_TC_suite.txt  \
+                         pdftxt/HSD/GFS_v17_p8_ugwpv1_aquaplanet_suite.txt \
                          pdftxt/suite_input.nml.txt \
                          pdftxt/acronyms.txt   \
                          pdftxt/GFS_RRTMG.txt \
-                         pdftxt/GFS_SFCLYR.txt \
+                         pdftxt/GFS_v17_SFCLYR.txt \
                          pdftxt/GFS_NSST.txt \
                          pdftxt/GFS_OCEAN.txt \
                          pdftxt/NOAH_LSM.txt \