Add publish flag

Author: janhoy

pelican/README.md

@@ -22,8 +22,26 @@ jobs:
         with:
           destination: master
           gfm: 'true'
+          publish: 'true'
 ```
 
+Example workflow for only building the site, not publishing. Useful for PR tests:
+
+```
+...
+jobs:
+  build-pelican:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+      - uses: apache/infrastructure-actions/pelican@main
+        with:
+          gfm: 'true'
+          publish: 'false'
+```
+
+
 # Pelican Migration Scripts
 
 The generate_settings.py script is designed to facilitate migrating away from the

pelican/action.yml

@@ -3,8 +3,12 @@ description: "Generate a Pelican website from Markdown"
 inputs:
   destination:
     description: "Pelican Output branch"
-    required: true
+    required: false
     default: "asf-site"
+  publish:
+    description: "Publish the site to the destination branch. If false, the site is built but not published."
+    required: false
+    default: "true"
   gfm:
     description: "Uses GitHub Flavored Markdown"
     required: false
@@ -100,6 +104,7 @@ runs:
         python3 -B -m pelican content -e "$PP" -o ${{ inputs.tempdir }} $OPTS
 
     - name: Check out previous branch
+      if: ${{ inputs.publish == 'true' }}
       shell: bash
       run: | 
         git config --global user.email "[email protected]"
@@ -119,6 +124,7 @@ runs:
         fi
 
     - name: Commit Directly to the branch
+      if: ${{ inputs.publish == 'true' }}
       shell: bash
       run: |
         # Remove all existing output so deletions will be captured