POM.XML文檔漢化

#class_issueManagement

project

所述 <project> 元素是描述符的根。下表列出了全部可能的子元素。

modelVersion：String：聲明此POM符合哪一個版本的項目描述符。

parent：Parent：父項目的位置（若是存在）。若是未指定，則父項目中的值將是此項目的默認值。該位置以組ID，工件ID和版本的形式給出。

groupId：String：項目的通用惟一標識符。使用徹底限定的包名稱以區別於具備相似名稱的其餘項目（例如org.apache.maven）是正常的。

artifactId：String：此工件的標識符在組ID指定的組中是惟一的。工件是由項目生成或使用的東西。Maven爲項目生成的工件示例包括：JAR，源和二進制分發以及WAR。

version：String：此項目生成的工件的當前版本。

packaging：String：這個項目產生的神器類型，例如jar war ear pom。插件能夠建立本身的包裝，所以也能夠建立本身的包裝類型，所以該列表不包含全部可能的類型。

name：String：項目的全名。

description：String：項目的詳細描述，Maven在須要描述項目時使用，例如在網站上。雖然能夠將此元素指定爲CDATA以在說明中使用HTML標記，但不鼓勵容許純文本表示。若是須要修改生成的網站的索引頁面，則能夠指定本身的索引頁面，而不是調整此文本。

url：String：項目主頁的URL。 
默認值爲：父值[+路徑調整] +（artifactId或 project.directory屬性）

inceptionYear：String：項目開始的那一年，用4位數字指定。在生成版權聲明和信息時使用此值。

organization：Organization：此元素描述項目所屬組織的各類屬性。建立文檔時使用這些屬性（用於版權聲明和連接）。

licenses/license*：List<License>：（不少）此元素描述了此項目的全部許可證。每一個許可證都由 許可證元素描述，而後由其餘元素描述。項目應僅列出適用於項目的許可證，而不是列出適用於依賴項的許可證。若是列出了多個許可證，則假定用戶能夠選擇其中任何一個，而不是他們必須接受全部許可證。

developers/developer*：List<Developer>：（不少）描述項目的提交者。

contributors/contributor*：List<Contributor>：（不少）描述了還沒有提交的項目的貢獻者。

mailingLists/mailingList*：List<MailingList>：（不少）包含有關項目郵件列表的信息。

prerequisites：Prerequisites：描述此項目的構建環境中的先決條件。

modules/module*：List<String>：（不少）做爲該項目的一部分構建的模塊（有時稱爲子項目）。列出的每一個模塊都是包含該模塊的目錄的相對路徑。爲了與從父計算默認URL的方式一致，建議使模塊名稱與工件ID匹配。

scm：Scm：項目使用的SCM規範，如CVS，Subversion等。

issueManagement：IssueManagement：該項目的問題管理系統信息。

ciManagement：CiManagement：該項目的持續整合信息。

distributionManagement：DistributionManagement：項目的分發信息，能夠分別將站點和工件部署到遠程Web服務器和存儲庫。

properties/key=value*：Properties：（多個）能夠在整個POM中用做替換的屬性，並在啓用時用做資源中的過濾器。格式爲 <name> value </ name>。

dependencyManagement：DependencyManagement：從這個項目繼承的項目的默認依賴項信息。本節中的依賴項不會當即解決。相反，當從這個派生的POM聲明由匹配的groupId和artifactId描述的依賴關係時，若是還沒有指定該依賴關係，則此部分的版本和其餘值將用於該依賴關係。

dependencies/dependency*：List<Dependency>：（不少）此元素描述與項目關聯的全部依賴項。這些依賴項用於在構建過程當中爲項目構造類路徑。它們會自動今後項目中定義的存儲庫下載。有關更多信息，請參閱 依賴性機制。

repositories/repository*：List<Repository>：（多個）用於發現依賴關係和擴展的遠程存儲庫的列表。

pluginRepositories/pluginRepository*：List<Repository>：（多個）用於發現構建和報告的插件的遠程存儲庫的列表。

build：Build：構建項目所需的信息。

reports：DOM：不推薦。如今被Maven忽略了。

reporting：Reporting：此元素包括用於在Maven生成的站點上生成報告的報告插件的規範。當用戶執行mvn站點時，將運行這些報告 。全部報告都將包含在導航欄中以供瀏覽。

profiles/profile*：List<Profile>：（不少）項目本地構建配置文件的列表，它將在激活時修改構建過程。

parent

所述 <parent>元素包含以定位父項目從該項目將繼承所需的信息。 注意：此元素的子元素不是插值的，必須以文字值的形式給出

groupId：String：要繼承的父項目的組ID。

artifactId：String：要繼承的父項目的工件ID。

version：String：要繼承的父項目的版本。

relativePath：String：簽出中父pom.xml文件的相對路徑 。若是未指定，則默認爲../pom.xml。Maven首先在文件系統上的這個位置查找父POM，而後是本地存儲庫，最後在遠程倉庫中查找。 relativePath容許您選擇不一樣的位置，例如，當您的結構是平的時，或者更深，沒有中間父POM。可是，組ID，工件ID和版本仍然是必需的，而且必須與給定位置中的文件匹配，不然它將恢復爲POM的存儲庫。此功能僅用於加強該項目的本地結賬的開發。若是要禁用該功能，請將值設置爲空字符串，並始終從存儲庫中解析父POM。
默認值爲：../ pom.xml。

organization

指定生成此項目的組織。

name：String：組織的全名。

url：String：組織主頁的URL。

license

描述此項目的許可證。這用於生成項目網站的許可頁面，以及在其餘報告和驗證中考慮。爲項目列出的許可證是項目自己的許可證，而不是依賴項。

name：String：許可證的完整法定名稱。

url：String：許可證文本的官方URL。

distribution：String：能夠分發此項目的主要方法。

comments：String：有關此許可證的附錄信息。

developer

有關此項目的其中一個提交者的信息。

id：String：SCM中開發人員的惟一ID。

name：String：貢獻者的全名。

email：String：貢獻者的電子郵件地址。

url：String：貢獻者主頁的URL。

organization：String：貢獻者所屬的組織。

organizationUrl：String：組織的URL。

roles/role*：List<String>：（不少）貢獻者在項目中扮演的角色。每一個角色由角色元素描述，角色元素的主體是角色名稱。這也能夠用來描述貢獻。

timezone：String：貢獻者所在的時區。一般，這是-12到 +14範圍內的數字， 或者是「America / Montreal」（UTC-05：00）或「Europe / Paris」（UTC + 01）的有效時區ID ：00）。

properties/key=value*：Properties：（不少）關於貢獻者的屬性，例如即時消息句柄。

contributor

對項目有貢獻但沒有提交權限的人員的描述。一般，這些貢獻以提交的補丁的形式出現。

name：String：貢獻者的全名。

email：String：貢獻者的電子郵件地址。

url：String：貢獻者主頁的URL。

organization：String：貢獻者所屬的組織。

organizationUrl：String：組織的URL。

roles/role*：List<String>：（不少）貢獻者在項目中扮演的角色。每一個角色由角色元素描述，角色元素的主體是角色名稱。這也能夠用來描述貢獻。

timezone：String：貢獻者所在的時區。一般，這是-12到 +14範圍內的數字， 或者是「America / Montreal」（UTC-05：00）或「Europe / Paris」（UTC + 01）的有效時區ID ：00）。

properties/key=value*：Properties：（不少）關於貢獻者的屬性，例如即時消息句柄。

mailingList

此元素描述與項目關聯的全部郵件列表。自動生成的站點引用此信息。

name：String：郵件列表的名稱。

subscribe：String：可用於訂閱郵件列表的電子郵件地址或連接。若是這是電子郵件地址， 則在建立文檔時將自動建立mailto：連接。

unsubscribe：String：可用於取消訂閱郵件列表的電子郵件地址或連接。若是這是電子郵件地址， 則在建立文檔時將自動建立mailto：連接。

post：String：可用於發佈到郵件列表的電子郵件地址或連接。若是這是電子郵件地址， 則在建立文檔時將自動建立mailto：連接。

archive：String：指向您能夠瀏覽郵件列表存檔的URL的連接。

otherArchives/otherArchive*：List<String>：（多個）指向備用URL的連接，您能夠在其中瀏覽列表存檔。

prerequisites

描述項目能夠具備的先決條件。

maven：String：對於插件項目（打包是 maven-plugin），使用生成的插件須要Maven的最低版本。 
在Maven 2中，這也指定了構建項目所需的Maven的最低版本，可是這種用法 在Maven 3中已棄用，而再也不被檢查：使用 Maven Enforcer插件的requireMavenVersion規則。
默認值爲：2.0。

scm

所述 <SCM>元素包含該項目的所需的SCM（源控制管理）信息。

connection：String：源代碼管理系統URL，用於描述存儲庫以及如何鏈接到存儲庫。有關更多信息，請參閱 URL格式和 支持的SCM列表。此鏈接是隻讀的。
默認值爲：父值[+路徑調整] +（artifactId或project.directory屬性） 

developerConnection：String：就像鏈接同樣 ，但對於開發人員來講，即這個scm鏈接不會是隻讀的。 
默認值爲：父值[+路徑調整] +（artifactId或project.directory屬性）

tag：String：當前代碼的標記。默認狀況下，它在開發期間設置爲HEAD。
默認值爲：HEAD。

url：String：項目可瀏覽的SCM存儲庫的URL，例如ViewVC或Fisheye。 
默認值爲：父值[+路徑調整] +（artifactId或project.directory屬性）

issueManagement

有關用於管理此項目的問題跟蹤（或錯誤跟蹤）系統的信息。

Element	Type	Description
system	String	問題管理系統的名稱，例如Bugzilla
url	String	項目使用的問題管理系統的URL。

ciManagement

所述 <CiManagement>元素包含所需項目的持續集成系統信息。

system：String：持續集成系統的名稱，例如 連續統一體。

url：String：項目使用的持續集成系統的URL（若是它具備Web界面）。

notifiers/notifier*：List<Notifier>：（多個）用於在構建不成功時通知開發人員/用戶的配置，包括用戶信息和通知模式。

notifier

配置一種在構建中斷時通知用戶/開發人員的方法。

type：String：用於傳遞通知的機制。
默認值爲：mail。

sendOnError：boolean：是否發送錯誤通知。
默認值爲：true。

sendOnFailure：boolean：是否在發生故障時發送通知。
默認值爲：true。

sendOnSuccess：boolean：是否發送成功通知。
默認值爲：true。

sendOnWarning：boolean：是否發送警告通知。
默認值爲：true。

address：String：不推薦。在何處發送通知 - 例如電子郵件地址。

configuration/key=value*：Properties：（不少）特定於此通知程序的擴展配置在此處。

distributionManagement

此元素描述了與項目分發相關的全部內容。它主要用於部署工件和構建生成的站點。

repository：DeploymentRepository：將項目生成的工件部署到遠程存儲庫所需的信息。

snapshotRepository：DeploymentRepository：何處將工件快照部署到。若是沒有給出，則默認爲 repository元素。

site：Site：部署項目網站所需的信息。

downloadUrl：String：項目下載頁面的URL。若是沒有給出用戶將被引用到url給出的主頁 。這是爲了幫助定位因爲許可限制而不在存儲庫中的工件。

relocation：Relocation：工件的重定位信息（若是已移動到新的組ID和/或工件ID）。

status：String：在遠程存儲庫中提供此工件的狀態。這不能在您的本地項目中設置，由於它是由放置在reposiory中的工具更新的。有效值包括：無（默認）， 轉換（存儲庫管理器從Maven 1 POM轉換）， 合做夥伴（直接從合做夥伴Maven 2存儲庫同步）， 部署（從Maven 2實例部署）， 驗證（已手動）驗證爲正確且最終）。

repository

存儲庫包含部署到遠程存儲庫所需的信息。

uniqueVersion：boolean：不管分配快照包含時間戳的獨特版本和版本號，或者使用相同的版本，每次
默認值是：true。

releases：RepositoryPolicy：如何處理今後存儲庫下載的版本。

snapshots：RepositoryPolicy：如何處理今後存儲庫下載快照。

id：String：存儲庫的惟一標識符。例如，這用於將存儲庫與settings.xml文件中的配置進行匹配 。此外，在POM繼承和配置文件注入期間使用標識符來檢測應合併的存儲庫。

name：String：人類可讀的存儲庫名稱。

url：String：存儲庫的URL，格式爲 protocol：// hostname / path。

layout：String：此存儲庫用於定位和存儲工件的佈局類型 - 能夠是 舊版或 默認版。
默認值爲：default。

releases

下載政策。

Element	Type	Description
enabled	String	是否使用此存儲庫下載此類工件。注意：雖然出於技術緣由，此字段的類型爲 String，但語義類型其實是 布爾值。默認值爲 true。
updatePolicy	String	下載更新的頻率 - 能夠是 始終， 天天（默認）， 間隔：XXX（以分鐘爲單位）或 從不（僅在本地不存在時）
checksumPolicy	String	驗證工件校驗和失敗時該怎麼辦。有效值爲 ignore， fail或warn（默認值）。

snapshots

下載政策。

Element	Type	Description
enabled	String	Whether to use this repository for downloading this type of artifact. Note: While the type of this field is String for technical reasons, the semantic type is actually Boolean. Default value istrue.
updatePolicy	String	The frequency for downloading updates - can be always,daily (default), interval:XXX (in minutes) or never (only if it doesn't exist locally).
checksumPolicy	String	What to do when verification of an artifact checksum fails. Valid values are ignore , fail or warn (the default).

snapshotRepository

存儲庫包含部署到遠程存儲庫所需的信息。

Element	Type	Description
uniqueVersion	boolean	Whether to assign snapshots a unique version comprised of the timestamp and build number, or to use the same version each time Default value is: true.
releases	RepositoryPolicy	How to handle downloading of releases from this repository.
snapshots	RepositoryPolicy	How to handle downloading of snapshots from this repository.
id	String	A unique identifier for a repository. This is used to match the repository to configuration in thesettings.xml file, for example. Furthermore, the identifier is used during POM inheritance and profile injection to detect repositories that should be merged.
name	String	Human readable name of the repository.
url	String	The url of the repository, in the formprotocol://hostname/path.
layout	String	The type of layout this repository uses for locating and storing artifacts - can be legacy or default. Default value is: default.

site

包含部署網站所需的信息。

Element	Type	Description
id	String	A unique identifier for a deployment location. This is used to match the site to configuration in the settings.xml file, for example.
name	String	Human readable name of the deployment location.
url	String	The url of the location where website is deployed, in the formprotocol://hostname/path.  Default value is: parent value [+ path adjustment] + (artifactId orproject.directory property)

relocation

描述工件移動到的位置。若是省略任何值，則假定它與以前相同。

Element	Type	Description
groupId	String	The group ID the artifact has moved to.
artifactId	String	The new artifact ID of the artifact.
version	String	The new version of the artifact.
message	String	An additional message to show the user about the move, such as the reason.

dependencyManagement

用於管理在一組POM中使用的默認依賴關係信息的部分。

Element	Type	Description
dependencies/dependency*	List<Dependency>	(Many) The dependencies specified here are not used until they are referenced in a POM within the group. This allows the specification of a "standard" version for a particular dependency.

dependency

所述 <依賴性>元素包含關於該項目的相關性信息。

Element	Type	Description
groupId	String	The project group that produced the dependency, e.g. org.apache.maven.
artifactId	String	The unique id for an artifact produced by the project group, e.g. maven-artifact.
version	String	The version of the dependency, e.g. 3.2.1. In Maven 2, this can also be specified as a range of versions.
type	String	The type of dependency. While it usually represents the extension on the filename of the dependency, that is not always the case. A type can be mapped to a different extension and a classifier. The type often corresponds to the packaging used, though this is also not always the case. Some examples are jar, war, ejb-client andtest-jar: see default artifact handlers for a list. New types can be defined by plugins that set extensions to true, so this is not a complete list. Default value is: jar.
classifier	String	The classifier of the dependency. It is appended to the filename after the version. This allows: referring to attached artifact, for example sources and javadoc: see default artifact handlers for a list, distinguishing two artifacts that belong to the same POM but were built differently. For example, jdk14 and jdk15.
scope	String	The scope of the dependency - compile,runtime, test, system, and provided. Used to calculate the various classpaths used for compilation, testing, and so on. It also assists in determining which artifacts to include in a distribution of this project. For more information, see the dependency mechanism. The default scope iscompile.
systemPath	String	FOR SYSTEM SCOPE ONLY. Note that use of this property is discouraged and may be replaced in later versions. This specifies the path on the filesystem for this dependency. Requires an absolute path for the value, not relative. Use a property that gives the machine specific absolute path, e.g.${java.home}.
exclusions/exclusion*	List<Exclusion>	(Many) Lists a set of artifacts that should be excluded from this dependency's artifact list when it comes to calculating transitive dependencies.
optional	String	Indicates the dependency is optional for use of this library. While the version of the dependency will be taken into account for dependency calculation if the library is used elsewhere, it will not be passed on transitively. Note: While the type of this field is String for technical reasons, the semantic type is actually Boolean. Default value is false.

exclusion

所述 <排除>元素包含以排除僞影到該項目所需的信息。

Element	Type	Description
artifactId	String	The artifact ID of the project to exclude.
groupId	String	The group ID of the project to exclude.

repository

存儲庫包含與遠程存儲庫創建鏈接所需的信息。

Element	Type	Description
releases	RepositoryPolicy	How to handle downloading of releases from this repository.
snapshots	RepositoryPolicy	How to handle downloading of snapshots from this repository.
id	String	A unique identifier for a repository. This is used to match the repository to configuration in the settings.xml file, for example. Furthermore, the identifier is used during POM inheritance and profile injection to detect repositories that should be merged.
name	String	Human readable name of the repository.
url	String	The url of the repository, in the formprotocol://hostname/path.
layout	String	The type of layout this repository uses for locating and storing artifacts - can be legacy or default. Default value is: default.

pluginRepository

存儲庫包含與遠程存儲庫創建鏈接所需的信息。

Element	Type	Description
releases	RepositoryPolicy	How to handle downloading of releases from this repository.
snapshots	RepositoryPolicy	How to handle downloading of snapshots from this repository.
id	String	A unique identifier for a repository. This is used to match the repository to configuration in the settings.xml file, for example. Furthermore, the identifier is used during POM inheritance and profile injection to detect repositories that should be merged.
name	String	Human readable name of the repository.
url	String	The url of the repository, in the formprotocol://hostname/path.
layout	String	The type of layout this repository uses for locating and storing artifacts - can be legacy or default. Default value is: default.

build

所述 <build>元素包含創建該項目所需的信息。默認值在Super POM中定義。

sourceDirectory：String：此元素指定包含項目源的目錄。生成的構建系統將在構建項目時今後目錄編譯源。給定的路徑是相對於項目描述符的。默認值爲src / main / java。

scriptSourceDirectory：String：此元素指定包含項目腳本源的目錄。此目錄與sourceDirectory的不一樣之處在於，在大多數狀況下，其內容將被複制到輸出目錄（由於腳本是解釋而不是編譯的）。默認值爲src / main / scripts。

testSourceDirectory：String：此元素指定包含項目的單元測試源的目錄。生成的構建系統將在測試項目時編譯這些目錄。給定的路徑是相對於項目描述符的。默認值爲 src / test / java。

outputDirectory：String：放置已編譯應用程序類的目錄。默認值爲target / classes。

testOutputDirectory：String：放置已編譯測試類的目錄。默認值爲target / test-classes。

extensions/extension*：List<Extension>：（不少）從這個項目中使用的一組構建擴展。

defaultGoal：String：當沒有爲項目指定時，要執行的默認目標（或Maven 2中的階段）。請注意，在多模塊構建的狀況下，只有頂級項目的默認目標是相關的，即忽略子模塊的默認目標。從Maven 3開始，多個目標/階段能夠用空格分隔。

resources/resource*：List<Resource>：（不少）此元素描述全部類路徑資源，例如與項目關聯的屬性文件。這些資源一般包含在最終包中。默認值爲 src / main / resources。

testResources/testResource*：List<Resource>：（不少）此元素描述全部類路徑資源，例如與項目的單元測試關聯的屬性文件。默認值爲 src / test / resources。

directory：String：放置構建生成的全部文件的目錄。默認值爲target。

finalName：String：生成的工件將被調用的文件名（不包括擴展名，沒有路徑信息）。默認值爲 $ {artifactId} - $ {version}。

filters/filter*：List<String>：（多個）啓用過濾時使用的過濾器屬性文件列表。

pluginManagement：PluginManagement：默認插件信息可供今後項目派生的項目參考。除非引用，不然此插件配置將不會被解析或綁定到生命週期。給定插件的任何本地配置都將覆蓋插件的整個定義。

plugins/plugin*：List<Plugin>：（不少）要使用的插件列表。

extension

描述要使用的構建擴展。

Element	Type	Description
groupId	String	The group ID of the extension's artifact.
artifactId	String	The artifact ID of the extension.
version	String	The version of the extension.

resource

此元素描述與項目或單元測試關聯的全部類路徑資源。

Element	Type	Description
targetPath	String	Describe the resource target path. The path is relative to the target/classes directory (i.e.${project.build.outputDirectory}). For example, if you want that resource to appear in a specific package ( org.apache.maven.messages), you must specify this element with this value:org/apache/maven/messages. This is not required if you simply put the resources in that directory structure at the source, however.
filtering	String	Whether resources are filtered to replace tokens with parameterised values or not. The values are taken from the properties element and from the properties in the files listed in the filters element. Note: While the type of this field is String for technical reasons, the semantic type is actuallyBoolean. Default value is false.
directory	String	Describe the directory where the resources are stored. The path is relative to the POM.
includes/include*	List<String>	(Many) A list of patterns to include, e.g. **/*.xml.
excludes/exclude*	List<String>	(Many) A list of patterns to exclude, e.g. **/*.xml

testResource

此元素描述與項目或單元測試關聯的全部類路徑資源。

Element	Type	Description
targetPath	String	Describe the resource target path. The path is relative to the target/classes directory (i.e.${project.build.outputDirectory}). For example, if you want that resource to appear in a specific package ( org.apache.maven.messages), you must specify this element with this value:org/apache/maven/messages. This is not required if you simply put the resources in that directory structure at the source, however.
filtering	String	Whether resources are filtered to replace tokens with parameterised values or not. The values are taken from the properties element and from the properties in the files listed in the filters element. Note: While the type of this field is String for technical reasons, the semantic type is actuallyBoolean. Default value is false.
directory	String	Describe the directory where the resources are stored. The path is relative to the POM.
includes/include*	List<String>	(Many) A list of patterns to include, e.g. **/*.xml.
excludes/exclude*	List<String>	(Many) A list of patterns to exclude, e.g. **/*.xml

pluginManagement

用於管理在一組POM中使用的默認插件信息的部分。

Element	Type	Description
plugins/plugin*	List<Plugin>	(Many) The list of plugins to use.

plugin

所述<plugin>元素包含一個插件所需信息。

groupId：String：存儲庫中插件的組ID。
默認值爲：org.apache.maven.plugins。

artifactId：String：存儲庫中插件的工件ID。

version：String：要使用的插件的版本（或有效版本範圍）。

extensions：String：是否今後插件加載Maven擴展（例如打包和類型處理程序）。出於性能緣由，只應在必要時啓用此功能。注意：雖然出於技術緣由，此字段的類型爲 String，但語義類型其實是 布爾值。默認值爲 false。

executions/execution*：List<PluginExecution>：（不少）在構建生命週期中要執行的一組目標的多個規範，每一個目標都具備（可能）不一樣的配置。

dependencies/dependency*：List<Dependency>：（不少）此項目須要引入插件的類加載器的其餘依賴項。

goals：DOM：不推薦。未被Maven使用。

inherited：String：是否應將任何配置傳播到子POM。注意：雖然出於技術緣由，此字段的類型爲 String，但語義類型其實是布爾值。默認值爲 true。

execution

所述<execution>元素包含一個插件的執行所須要的信息。

Element	Type	Description
id	String	The identifier of this execution for labelling the goals during the build, and for matching executions to merge during inheritance and profile injection. Default value is: default.
phase	String	The build lifecycle phase to bind the goals in this execution to. If omitted, the goals will be bound to the default phase specified by the plugin.
goals/goal*	List<String>	(Many) The goals to execute with the given configuration.
inherited	String	Whether any configuration should be propagated to child POMs. Note: While the type of this field is String for technical reasons, the semantic type is actually Boolean. Default value is true.
configuration	DOM	The configuration as DOM object. By default, every element content is trimmed, but starting with Maven 3.1.0, you can add xml:space="preserve" to elements you want to preserve whitespace. You can control how child POMs inherit configuration from parent POMs by adding combine.children or combine.self attributes to the children of the configuration element: combine.children: available values are merge(default) and append, combine.self: available values are merge (default) and override. See POM Reference documentation and Xpp3DomUtils for more information.

reporting

報告及其配置管理部分。

Element	Type	Description
excludeDefaults	String	If true, then the default reports are not included in the site generation. This includes the reports in the "Project Info" menu. Note: While the type of this field is String for technical reasons, the semantic type is actually Boolean. Default value is false.
outputDirectory	String	Where to store all of the generated reports. The default is${project.build.directory}/site.
plugins/plugin*	List<ReportPlugin>	(Many) The reporting plugins to use and their configuration.

plugin

所述 <plugin>元素包含報告插件所需信息。

groupId：String：存儲庫中報告插件的組ID。
默認值爲：org.apache.maven.plugins。

artifactId：String：存儲庫中報告插件的工件ID。

version：String：要使用的報告插件的版本。

reportSets/reportSet*：List<ReportSet>：（多個）一組報告的多個規範，每一個報告具備（可能）不一樣的配置。這是與構建中的執行並行的報告 。

inherited：String：是否應將任何配置傳播到子POM。注意：雖然出於技術緣由，此字段的類型爲 String，但語義類型其實是 布爾值。默認值爲 true。

configuration：DOM：配置爲DOM對象。
默認狀況下，每一個元素內容都會被修剪，但從Maven 3.1.0開始，您能夠將xml：space =「preserve」添加到要保留空格的元素中。
您能夠經過將combine.children或combine.self屬性添加到配置元素的子項來控制子POM如何從父POM繼承配置：
combine.children：可用值是merge（默認）和append，
combine.self：可用值是merge（默認）和override。
有關更多信息，請參閱POM參考文檔和Xpp3DomUtils。

reportSet

表示用於生成它們的一組報告和配置。

id：String：此報告集的惟一ID，用於在POM繼承和概要文件注入期間用於合併報告集。
默認值爲：default。

reports/report*：List<String>：（不少）此插件的報告列表應該今後集合生成。

inherited：String：是否應將任何配置傳播到子POM。注意：雖然出於技術緣由，此字段的類型爲String，但語義類型其實是 布爾值。默認值爲 true。

configuration：DOM：配置爲DOM對象。
默認狀況下，每一個元素內容都會被修剪，但從Maven 3.1.0開始，您能夠將xml：space =「preserve」添加到要保留空格的元素中。
您能夠經過將combine.children或combine.self屬性添加到配置元素的子項來控制子POM如何從父POM繼承配置：
combine.children：可用值是merge（默認）和append，
combine.self：可用值是merge（默認）和override。
有關更多信息，請參閱POM參考文檔和Xpp3DomUtils。

profile

對基於環境參數或命令行參數激活的構建過程的修改。

id：String：此構建配置文件的標識符。這用於命令行激活，並標識要合併的配置文件。
默認值爲：default。

activation：Activation：條件邏輯將自動觸發包含此配置文件。

build：BuildBase：構建項目所需的信息。

modules/module*：List<String>：（不少）做爲該項目的一部分構建的模塊（有時稱爲子項目）。列出的每一個模塊都是包含該模塊的目錄的相對路徑。爲了與從父計算默認URL的方式一致，建議使模塊名稱與工件ID匹配。

distributionManagement：DistributionManagement：項目的分發信息，能夠分別將站點和工件部署到遠程Web服務器和存儲庫。

properties/key=value*：Properties：（多個）能夠在整個POM中用做替換的屬性，並在啓用時用做資源中的過濾器。格式爲 <name> value </ name>。

dependencyManagement：DependencyManagement：從這個項目繼承的項目的默認依賴項信息。本節中的依賴項不會當即解決。相反，當從這個派生的POM聲明由匹配的groupId和artifactId描述的依賴關係時，若是還沒有指定該依賴關係，則此部分的版本和其餘值將用於該依賴關係。

dependencies/dependency*：List<Dependency>：（不少）此元素描述與項目關聯的全部依賴項。這些依賴項用於在構建過程當中爲項目構造類路徑。它們會自動今後項目中定義的存儲庫下載。有關更多信息，請參閱 依賴性機制。

repositories/repository*：List<Repository>：（多個）用於發現依賴關係和擴展的遠程存儲庫的列表。

pluginRepositories/pluginRepository*：List<Repository>：（多個）用於發現構建和報告的插件的遠程存儲庫的列表。

reports：DOM：不推薦。如今被Maven忽略了。

reporting：Reporting：此元素包括用於在Maven生成的站點上生成報告的報告插件的規範。當用戶執行mvn站點時，將運行這些報告 。全部報告都將包含在導航欄中以供瀏覽。

activation

構建運行時環境中的條件將觸發自動包含構建配置文件。能夠定義多個條件，激活配置文件必須知足全部條件。

activeByDefault：boolean：若是設置爲true，則此配置文件將處於活動狀態，除非使用命令行-P選項或該配置文件的激活器之一激活此pom中的另外一個配置文件。
默認值爲：false。

jdk：String：指定在檢測到匹配的JDK時將激活此配置文件。例如， 1.4僅在JDK版本1.4上激活，而 ！1.4匹配任何不是版本1.4的JDK。也支持範圍： 當JDK最小爲1.5時，[1.5，]激活。

os：ActivationOS：指定在檢測到匹配的操做系統屬性時將激活此配置文件。

property：ActivationProperty：指定在指定此係統屬性時將激活此配置文件。

file：ActivationFile：指定將根據文件的存在激活此配置文件。

os

這是一個激活器，它將檢測操做系統的屬性以激活其配置文件。

name：String：用於激活配置文件的操做系統的名稱。這必須與$ {os.name} Java屬性徹底匹配 ，例如 Windows XP。

family：String：用於激活配置文件的OS的通常系列，例如 windows或 unix。

arch：String：用於激活配置文件的操做系統的體系結構。

version：String：用於激活配置文件的操做系統版本。

property

這是用於激活配置文件的屬性規範。若是value字段爲空，則named屬性的存在將激活配置文件，不然它也會對屬性值進行區分大小寫的匹配。

Element	Type	Description
name	String	用於激活配置文件的屬性的名稱。
value	String	激活配置文件所需的屬性值。

file

這是用於激活配置文件的文件規範。的 缺失值是須要存在的文件的位置，若是沒有，配置文件將被激活。另外一方面， exists將測試文件是否存在，若是存在，則激活配置文件。 
這些文件規範的可變插值僅限於 $ {basedir}，系統屬性和請求屬性。

Element	Type	Description
missing	String	激活配置文件時必須缺乏的文件名。
exists	String	激活配置文件必須存在的文件的名稱。

 

build

構建的通用信息。

defaultGoal：String：當沒有爲項目指定時，要執行的默認目標（或Maven 2中的階段）。請注意，在多模塊構建的狀況下，只有頂級項目的默認目標是相關的，即忽略子模塊的默認目標。從Maven 3開始，多個目標/階段能夠用空格分隔。

resources/resource*：List<Resource>：（不少）此元素描述全部類路徑資源，例如與項目關聯的屬性文件。這些資源一般包含在最終包中。默認值爲 src / main / resources。

testResources/testResource*：List<Resource>：（不少）此元素描述全部類路徑資源，例如與項目的單元測試關聯的屬性文件。默認值爲 src / test / resources。

directory：String：放置構建生成的全部文件的目錄。默認值爲target。

finalName：String：生成的工件將被調用的文件名（不包括擴展名，沒有路徑信息）。默認值爲 $ {artifactId} - $ {version}。

filters/filter*：List<String>：（多個）啓用過濾時使用的過濾器屬性文件列表。

pluginManagement：PluginManagement：默認插件信息可供今後項目派生的項目參考。除非引用，不然此插件配置將不會被解析或綁定到生命週期。給定插件的任何本地配置都將覆蓋插件的整個定義。

plugins/plugin*：List<Plugin>：（不少）要使用的插件列表。

 

 

 

 

 

 

 

#

connection：String：源代碼管理系統URL，用於描述存儲庫以及如何鏈接到存儲庫。有關更多信息，請參閱 URL格式和 支持的SCM列表。此鏈接是隻讀的。
默認值爲：父值[+路徑調整] +（artifactId或project.directory屬性） 

developerConnection：String：就像鏈接同樣 ，但對於開發人員來講，即這個scm鏈接不會是隻讀的。 
默認值爲：父值[+路徑調整] +（artifactId或project.directory屬性）

tag：String：當前代碼的標記。默認狀況下，它在開發期間設置爲HEAD。
默認值爲：HEAD。

url：String：項目可瀏覽的SCM存儲庫的URL，例如ViewVC或Fisheye。 
默認值爲：父值[+路徑調整] +（artifactId或project.directory屬性）