[
https://issues.apache.org/jira/browse/AXIS2-6066?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17881845#comment-17881845
]
Andreas Veithen commented on AXIS2-6066:
----------------------------------------
{quote}is `mvn site` supposed to generate the entire documentation in one
place, complete with working inter-module links?{quote}
No, you need to execute the {{site-deploy}} phase (and check the files under
{{target/staging}}). A quick and reliable way of doing that is to use the
following command:
{noformat}
mvn -Dmaven.test.skip=true clean package site-deploy
{noformat}
Regarding the missing Mojo pages, they are actually generated, but something is
going wrong when they are copied to the staging directory:
{noformat}
[INFO] --- site:3.20.0:stage (site-stage) @ axis2-repo-maven-plugin ---
[INFO] Using this base directory for staging:
/workspaces/axis-axis2-java-core/target/staging
[INFO] Pushing
/workspaces/axis-axis2-java-core/modules/tool/axis2-repo-maven-plugin/target/site
[INFO] >>> to
file:///workspaces/axis-axis2-java-core/target/staging/scm:svn:https://svn.apache.org/repos/asf/axis/site/axis2/java/core-staging/tools/maven-plugins/axis2-repo-maven-plugin
{noformat}
> Site generation/deployment is broken
> ------------------------------------
>
> Key: AXIS2-6066
> URL: https://issues.apache.org/jira/browse/AXIS2-6066
> Project: Axis2
> Issue Type: Bug
> Reporter: Steven DH
> Priority: Major
>
> Some issues I noticed when trying to build the site:
> * The maven Mojo pages (*-mojo.html) are not being generated. I could fix
> this by explicitly listing maven-plugin-report-plugin in the POM's reporting
> plugins, but I have no idea whether that is the proper solution.
> * Apidocs generation fails with several errors, apparently because javadoc
> cant' find org.omg.CORBA and related packages. Also, it seems that the
> configuration for the maven-javadoc-plugin is set for Java 8, which is
> perhaps too old?
> * The machinery which transports generated html from the modules'
> target/site directories to the separate axis-site repo is broken. I noticed
> that
> [https://axis.apache.org/axis2/java/core/tools/maven-plugins/axis2-wsdl2code-maven-plugin/wsdl2code-mojo.html]
> shows docs for version 1.7.9. An up-to-date version can be found on
> [https://axis.apache.org/axis2/java/core/scm:svn:https:/svn.apache.org/repos/asf/axis/site/axis2/java/core-staging/tools/maven-plugins/axis2-wsdl2code-maven-plugin/wsdl2code-mojo.html],
> so something must have broken in between.
> And also a small question: is `mvn site` supposed to generate the entire
> documentation in one place, complete with working inter-module links? That
> wasn't clear to me.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
