Change to two separate workflows

* Build runs like normal without the deploy
* Deploy only runs on the ros2 branch
* Reused workflows: https://docs.github.com/en/actions/using-workflows/reusing-workflows

Signed-off-by: Ryan Friedman <[email protected]>

.github/workflows/doxygen.yml → .github/workflows/doxygen_build.yml

@@ -1,24 +1,18 @@
-name: Doxygen Pages
+name: Doxygen Build
 on:
   push:
     branches:
       - 'ros2'
   pull_request:
     branches:
-    - '*'
+      - '*'
 
 jobs:
   build:
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
-    permissions:
-      contents: write
     steps:
     - uses: actions/checkout@v4
     - uses: mattnotmitt/[email protected]
-    - uses: peaceiris/actions-gh-pages@v3
-      with: 
-        github_token: ${{ secrets.GITHUB_TOKEN }}
-        publish_dir: ./html
 

.github/workflows/doxygen_deploy.yml

@@ -0,0 +1,17 @@
+name: Doxygen Deploy to GH Pages
+on:
+  push:
+    branches:
+      - 'ros2'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+    steps:
+    - uses: ./.github/workflows/doxygen_build.yml
+    - uses: peaceiris/actions-gh-pages@v3
+      with: 
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: ./html