Maven站点生成与发布

Maven站点生成：mvn site:site

Maven站点发布：mvn clean site:deploy

一、配置Apache支持WebDav，使生成站点的网页可以发布自动发布到站点上。

1. 修改Apache配置文件http.conf，增加对WebDav功能的支持

增加webdav功能支持代码   

Include conf/httpd-dav.conf

2. 在httpd-dav.conf配置文件中，增加对WebDav功能的支持

Xml代码   

# Add Web-Dav Module Support if there is no setting in http.conf.   

LoadModule dav_module modules/mod_dav.so  

LoadModule dav_fs_module modules/mod_dav_fs.so  

DavLockDB "D:/Server/apache2/tmp/DavLock"  

# Setup Web-Dav deploy directory  

Alias /seurat "D:/Server/apache2/htdocs/seurat"  

<Directory "D:/Server/apache2/htdocs/seurat">  

     Dav On  

</Directory>  

3. 如果需要添加对WebDav目录的安全访问控制，则在httpd-dav.conf中按如下配置

Xml代码   

Alias /seurat "D:/Server/apache2/htdocs/seurat"  

<Directory "D:/Server/apache2/htdocs/seurat">  

   Dav On  

   AuthType Basic  

   AuthName Seurat  

   AuthUserFile "D:/dav.user.pwd"  

   <LimitExcept GET PROPFIND OPTIONS>  

     #The username format should be usename@YourDomain  

     require user yyjlinux@localhost  

   </LimitExcept>  

</Directory>  

注意：D:/dav.user.pwd是安全用户认证文件，可以复用svn服务器的用户文件。也可以用Apache的htpasswd命令生成用户认证文件。

二、Maven站点发布配置

1. 在POM中 配置distributionManagement元素

Xml代码   

<project>  

    ...  

    <distributionManagement>  

        <site>  

            <id>seurat.website</id>  

            <url>dav:http://localhost/seurat</url>  

        </site>  

    </distributionManagement>  

    ...  

</project>  

2. 如果WebDav服务器需要安全认证，则需要在$HOME/.m2/settings.xml配置文件中指定服务器认证信息，

Xml代码   

<settings>  

    ...  

    <servers>  

        <server>  

            <id>seurat.website</id>  

            <username>yyjlinux</username>  

            <password>123456</password>  

        </server>  

        ...  

    </servers>  

    ...  

</settings>  

3. 在POM中 配置reporting元素

Xml代码

 <reporting>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-project-info-reports-plugin</artifactId>
                <version>2.6</version>
                <configuration>
                    <dependencyLocationsEnabled>false</dependencyLocationsEnabled>
                </configuration>
                <reportSets>
                    <reportSet>
                        <reports>
                            <report>index</report>
                            <report>summary</report>
                            <report>dependency-info</report>
                            <report>modules</report>
                            <report>license</report>
                            <report>project-team</report>
                            <report>scm</report>
                            <report>issue-tracking</report>
                            <report>mailing-list</report>
                            <report>dependency-management</report>
                            <report>dependencies</report>
                            <report>dependency-convergence</report>
                            <report>cim</report>
                            <report>plugin-management</report>
                            <report>plugins</report>
                            <report>distribution-management</report>
                        </reports>
                    </reportSet>
                </reportSets>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>2.9</version>
                <configuration>
                    <attach>true</attach>
                    <charset>UTF-8</charset>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-site-plugin</artifactId>
                <configuration>
                    <locales>zh_CN</locales>
                    <outputEncoding>UTF-8</outputEncoding>
                </configuration>
                <version>3.3</version>
            </plugin>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>findbugs-maven-plugin</artifactId>
                <version>2.5.2</version>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-checkstyle-plugin</artifactId>
                <version>2.10</version>
                <configuration>
                    <configLocation>checkstyle/huipu_checks.xml</configLocation>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jxr-plugin</artifactId>
                <version>2.3</version>
            </plugin>
        </plugins>
    </reporting>