Add the Publish Site workflow - #580
Draft
slachiewicz wants to merge 1 commit into
Draft
Conversation
Calls the shared workflow added in codehaus-plexus/.github#62, so the site can be published from the Actions tab instead of from a maintainer's laptop. Multi-module project, so multi-module: true. That switches the shared workflow from site-deploy to 'site site:stage scm-publish:publish-scm', which is required here because the site has to be assembled across the four modules before it is pushed. The plugin's default content is target/staging, which is exactly what site:stage produces, so no further configuration is needed. Exposes dry-run so the first publish here can be verified without committing to gh-pages. Part of codehaus-plexus/.github#58
slachiewicz
marked this pull request as draft
August 9, 2026 15:06
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Part of codehaus-plexus/.github#58. Second caller for the shared workflow (codehaus-plexus/.github#62), and the multi-module form — the companion to codehaus-plexus/plexus-utils#334, which is the single-module one.
The only difference between the two is one line:
That switches the shared workflow from
site-deploytosite site:stage scm-publish:publish-scm. Required here because the site has to be assembled across the four modules before it is pushed, andsite-deployalone would publish only the aggregator.Nothing else needs configuring:
maven-scm-publish-plugindefaultscontentto${project.build.directory}/staging, which is exactly whatsite:stageproduces. I checked that in the plugin descriptor rather than assuming it.The other multi-module repos are
plexus-compiler,plexus-languagesandplexus-interactivity; they will get the identical file.Please run it with
dry-runticked first — it builds the site and checks outgh-pageswithout committing, which is the safe way to confirm the token permission and thepubScmUrlrewrite work. I have not run it; the first real publish should be a maintainer’s call.