[
https://issues.apache.org/jira/browse/MSITE-1016?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17885626#comment-17885626
]
Claude Warren commented on MSITE-1016:
--------------------------------------
Ok, so the documentation is wrong and you have to have a valid URL for the
stage to work? Except you don't.
Or, The documentation is correct and you don't need to specify the URL. Except
that it doesn't have to be a valid URL.
In my opinion, the site:stage goal should work without the URL being specified,
or perhaps with the url empty (e.g. "<url></url>"). I suspect that without the
URL "deploy" deploys to the "target/staging" directory as noted in the
documentation. The problem arises in that the documentation says if the URL
is not specified it will write to "target/staging" and that is exactly what it
does if the URL is invalid. But the pom check seems to require the URL so an
invalid one allows the "target/staging" to be written to.
It feels like the check for the URL needs to be relaxed. Perhaps not for all
targets, but for "stage" and from [~michael-o] 's comment "deploy"
> site:stage should function without a URL specified in the POM
> -------------------------------------------------------------
>
> Key: MSITE-1016
> URL: https://issues.apache.org/jira/browse/MSITE-1016
> Project: Maven Site Plugin
> Issue Type: Improvement
> Components: Maven 3
> Affects Versions: 3.20.0
> Reporter: Claude Warren
> Priority: Major
> Fix For: waiting-for-feedback
>
>
> Note: actual version is 3.8.6
> *Documentation states:*
> {quote}By default, the site will be staged in a directory
> {{{}target/staging/{}}}.
> {quote}
> *Issue description:*
> When I try to run site:stage without a site entry in the pom
> distrobutionManagement section I get an error that says the site entry must
> be specified.
> {quote}Specifying
> <distributionManagement>
> <site>
> <id>staging</id>
> </site>
> </distributionManagement>
> {quote}
> Will yield an error that states the URL must be specified. Entering an
> invalid URL solves the problem.
> {quote}<distributionManagement>
> <site>
> <id>staging</id>
> <url>invalid:url</url>
> </site>
> </distributionManagement>
> {quote}
> The above is literally the text in my pom file.
> *Desired setup:*
> I would like to see the URL be optional so that I can trigger the site:stage
> goal without having to specify the URL in the pom and without having to
> specify the stagingDirectory on the command line.
> I would also like this better documented.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)