Added: Ability to build to a specific location.

Author: Sewer56

README.MD

@@ -70,6 +70,7 @@ The action supports the following input parameters:
 - `CONFIG_FILE`: (Optional) The path to your MkDocs configuration file. Defaults to `mkdocs.yml` in the repository root.
 - `PUBLISH_TO_PAGES`: (Optional) Whether to publish the generated site to GitHub Pages. Defaults to `true`.
 - `CHECKOUT_CURRENT_REPO`: (Optional) Whether to perform a repository checkout before building the site. Defaults to `true`.
+- `OUTPUT_DIRECTORY`: (Optional) Location of the built MkDocs site. Defaults to `./site`.
 - `PRE_BUILD_SCRIPT`: (Optional) The path to a pre-build script to run before building the site.
 - `PRE_BUILD_SHELL`: (Optional) The shell to use for running the pre-build script. Defaults to `bash`.
 

action.yml

@@ -1,4 +1,5 @@
 name: Build and Deploy MkDocs Material (Reloaded)
+description: Builds and/or Deploys MkDocs Material to GitHub Pages, or a Directory
 
 inputs:
   MKDOCS_VERSION:
@@ -35,6 +36,11 @@ inputs:
     required: false
     default: "bash"
     description: "Shell to use for running the pre-build script"
+  OUTPUT_DIRECTORY:
+    type: string
+    required: false
+    default: "./site"
+    description: "Custom output directory for the MkDocs build"
 
 runs:
   using: "composite"
@@ -73,14 +79,14 @@ runs:
 
     - name: Build MkDocs Site
       shell: bash
-      run: mkdocs build --config-file "${{ inputs.CONFIG_FILE }}"
+      run: mkdocs build --config-file "${{ inputs.CONFIG_FILE }}" --site-dir "${{ inputs.OUTPUT_DIRECTORY }}"  # Updated command
 
     - name: Upload pages artifact
       if: ${{ inputs.PUBLISH_TO_PAGES }}
       uses: actions/upload-pages-artifact@v3
       with:
         name: "github-pages"
-        path: "./site"
+        path: "${{ inputs.OUTPUT_DIRECTORY }}"
 
     - name: Deploy to GitHub Pages
       if: ${{ inputs.PUBLISH_TO_PAGES }}