[ 
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: java-dev-unsubscr...@axis.apache.org
For additional commands, e-mail: java-dev-h...@axis.apache.org

Reply via email to