Modified: maven/website/content/settings.html ============================================================================== --- maven/website/content/settings.html (original) +++ maven/website/content/settings.html Sun May 12 07:42:36 2024 @@ -2,15 +2,15 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/settings.md at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/settings.md at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> - <title>Maven</title> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> + <title>Maven â Settings Reference</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -48,9 +46,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/settings.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Settings Reference <a href="https://github.com/apache/maven-site/tree/master/content/markdown/settings.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -144,7 +141,503 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section> +<section><section> +<h2>Settings Reference</h2><!-- +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, +software distributed under the License is distributed on an +"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +KIND, either express or implied. See the License for the +specific language governing permissions and limitations +under the License. +--> + +<ul> + +<li><a href="#introduction">Introduction</a> +<ul> + +<li><a href="#quick-overview">Quick Overview</a></li> +</ul></li> +<li><a href="#settings-details">Settings Details</a> +<ul> + +<li><a href="#simple-values">Simple Values</a></li> +<li><a href="#plugin-groups">Plugin Groups</a></li> +<li><a href="#servers">Servers</a> +<ul> + +<li><a href="#password-encryption">Password Encryption</a></li> +</ul></li> +<li><a href="#mirrors">Mirrors</a></li> +<li><a href="#proxies">Proxies</a></li> +<li><a href="#profiles">Profiles</a> +<ul> + +<li><a href="#activation">Activation</a></li> +<li><a href="#repositories">Repositories</a></li> +<li><a href="#plugin-repositories">Plugin Repositories</a></li> +</ul></li> +<li><a href="#active-profiles">Active Profiles</a></li> +</ul></li> +</ul></section><section> +<h2>Introduction</h2><section> +<h3>Quick Overview</h3> +<p>The <code>settings</code> element in the <code>settings.xml</code> file contains elements used +to define values which configure Maven execution in various ways, like +the <code>pom.xml</code>, but should not be bundled to any specific project, or +distributed to an audience. These include values such as the local +repository location, alternate remote repository servers, and +authentication information.</p> +<p>There are two locations where a <code>settings.xml</code> file may live:</p> +<ul> + +<li>The Maven install: <code>${maven.home}/conf/settings.xml</code></li> +<li>A user's install: <code>${user.home}/.m2/settings.xml</code></li> +</ul> +<p>The former <code>settings.xml</code> are also called global settings, the latter +<code>settings.xml</code> are referred to as user settings. If both files exists, +their contents gets merged, with the user-specific <code>settings.xml</code> being +dominant.</p> +<p>Tip: If you need to create user-specific settings from scratch, it's +easiest to copy the global settings from your Maven installation to your +<code>${user.home}/.m2</code> directory. Maven's default <code>settings.xml</code> is a +template with comments and examples so you can quickly tweak it to match +your needs.</p> +<p>Here is an overview of the top elements under <code>settings</code>:</p> + +<div class="verbatim"> +<pre><code class="language-xml"><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd"> + <localRepository/> + <interactiveMode/> + <offline/> + <pluginGroups/> + <servers/> + <mirrors/> + <proxies/> + <profiles/> + <activeProfiles/> +</settings> +</code></pre></div> +<p>The contents of the <code>settings.xml</code> can be interpolated using the +following expressions:</p> +<ol style="list-style-type: decimal"> + +<li><code>${user.home}</code> and all other system properties <em>(since Maven 3.0)</em></li> +<li><code>${env.HOME}</code> etc. for environment variables</li> +</ol> +<p>Note that properties defined in profiles within the <code>settings.xml</code> +cannot be used for interpolation.</p></section></section><section> +<h2>Settings Details</h2><section> +<h3>Simple Values</h3> +<p>Half of the top-level <code>settings</code> elements are simple values, +representing a range of values which describe elements of the build +system that are active full-time.</p> + +<div class="verbatim"> +<pre><code><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd"> + <localRepository>${user.home}/.m2/repository</localRepository> + <interactiveMode>true</interactiveMode> + <offline>false</offline> + ... +</settings> +</code></pre></div> +<ul> + +<li><strong>localRepository</strong>: This value is the path of this build system's +local repository. The default value is +<code>${user.home}/.m2/repository</code>. This element is especially useful for +a main build server allowing all logged-in users to build from a +common local repository.</li> +<li><strong>interactiveMode</strong>: <code>true</code> if Maven should attempt to interact with +the user for input, <code>false</code> if not. Defaults to <code>true</code>.</li> +<li><strong>offline</strong>: <code>true</code> if this build system should operate in offline +mode, defaults to <code>false</code>. This element is useful for build servers +which cannot connect to a remote repository, either because of +network setup or security reasons.</li> +</ul></section><section> +<h3>Plugin Groups</h3> +<p>This element contains a list of <code>pluginGroup</code> elements, each contains a +groupId. The list is searched when a plugin is used and the groupId is +not provided in the command line. This list automatically contains +<code>org.apache.maven.plugins</code> and <code>org.codehaus.mojo</code>.</p> + +<div class="verbatim"> +<pre><code class="language-xml"><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd"> + ... + <pluginGroups> + <pluginGroup>org.eclipse.jetty</pluginGroup> + </pluginGroups> + ... +</settings> +</code></pre></div> +<p>For example, given the above settings the Maven command line may execute +<code>org.eclipse.jetty:jetty-maven-plugin:run</code> with the truncated command:</p> + +<div class="verbatim"> +<pre><code>mvn jetty:run +</code></pre></div></section><section> +<h3>Servers</h3> +<p>The repositories for download and deployment are defined by the +<a href="./pom.html#Repositories"><code>repositories</code></a> and +<a href="./pom.html#Distribution_Management"><code>distributionManagement</code></a> elements +of the POM. However, certain settings such as <code>username</code> and <code>password</code> +should not be distributed along with the <code>pom.xml</code>. This type of +information should exist on the build server in the <code>settings.xml</code>.</p> + +<div class="verbatim"> +<pre><code class="language-xml"><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd"> + ... + <servers> + <server> + <id>server001</id> + <username>my_login</username> + <password>my_password</password> + <privateKey>${user.home}/.ssh/id_dsa</privateKey> + <passphrase>some_passphrase</passphrase> + <filePermissions>664</filePermissions> + <directoryPermissions>775</directoryPermissions> + <configuration></configuration> + </server> + </servers> + ... +</settings> +</code></pre></div> +<ul> + +<li><strong>id</strong>: This is the ID of the server <em>(not of the user to login as)</em> +that matches the <code>id</code> element of the repository/mirror that Maven +tries to connect to.</li> +<li><strong>username</strong>, <strong>password</strong>: These elements appear as a pair denoting +the login and password required to authenticate to this server.</li> +<li><strong>privateKey</strong>, <strong>passphrase</strong>: Like the previous two elements, this +pair specifies a path to a private key (default is +<code>${user.home}/.ssh/id_dsa</code>) and a <code>passphrase</code>, if required. The +<code>passphrase</code> and <code>password</code> elements may be externalized in the +future, but for now they must be set plain-text in the +<code>settings.xml</code> file.</li> +<li><strong>filePermissions</strong>, <strong>directoryPermissions</strong>: When a repository +file or directory is created on deployment, these are the +permissions to use. The legal values of each is a three digit number +corresponding to *nix file permissions, e.g. 664, or 775.</li> +</ul> +<p><em>Note:</em> If you use a private key to login to the server, make sure you +omit the <code><password></code> element. Otherwise, the key will be ignored.</p><section> +<h4>Password Encryption</h4> +<p>A new feature - server password and passphrase encryption has been added +to 2.1.0+. See details <a href="./guides/mini/guide-encryption.html">on this +page</a></p></section></section><section> +<h3>Mirrors</h3> + +<div class="verbatim"> +<pre><code class="language-xml"><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd"> + ... + <mirrors> + <mirror> + <id>planetmirror.com</id> + <name>PlanetMirror Australia</name> + <url>http://downloads.planetmirror.com/pub/maven2</url> + <mirrorOf>central</mirrorOf> + </mirror> + </mirrors> + ... +</settings> +</code></pre></div> +<ul> + +<li><strong>id</strong>, <strong>name</strong>: The unique identifier and user-friendly name of +this mirror. The <code>id</code> is used to differentiate between <code>mirror</code> +elements and to pick the corresponding credentials from the +<a href="#Servers"><code><servers></code></a> section when connecting to the mirror.</li> +<li><strong>url</strong>: The base URL of this mirror. The build system will use this +URL to connect to a repository rather than the original repository +URL.</li> +<li><strong>mirrorOf</strong>: The <code>id</code> of the repository that this is a mirror of. +For example, to point to a mirror of the Maven <code>central</code> repository +(<code>https://repo.maven.apache.org/maven2/</code>), set this element to +<code>central</code>. More advanced mappings like <code>repo1,repo2</code> or <code>*,!inhouse</code> +are also possible. This must not match the mirror <code>id</code>.</li> +</ul> +<p>For a more in-depth introduction of mirrors, please read the <a href="./guides/mini/guide-mirror-settings.html">Guide to +Mirror Settings</a>.</p></section><section> +<h3>Proxies</h3> + +<div class="verbatim"> +<pre><code class="language-xml"><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd"> + ... + <proxies> + <proxy> + <id>myproxy</id> + <active>true</active> + <protocol>http</protocol> + <host>proxy.somewhere.com</host> + <port>8080</port> + <username>proxyuser</username> + <password>somepassword</password> + <nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts> + </proxy> + </proxies> + ... +</settings> +</code></pre></div> +<ul> + +<li><strong>id</strong>: The unique identifier for this proxy. This is used to +differentiate between <code>proxy</code> elements.</li> +<li><strong>active</strong>: <code>true</code> if this proxy is active. This is useful for +declaring a set of proxies, but only one may be active at a time.</li> +<li><strong>protocol</strong>, <strong>host</strong>, <strong>port</strong>: The <code>protocol://host:port</code> of the +proxy, separated into discrete elements.</li> +<li><strong>username</strong>, <strong>password</strong>: These elements appear as a pair denoting +the login and password required to authenticate to this proxy +server.</li> +<li><strong>nonProxyHosts</strong>: This is a list of hosts which should not be +proxied. The delimiter of the list is the expected type of the proxy +server; the example above is pipe delimited - comma delimited is +also common.</li> +</ul></section><section> +<h3>Profiles</h3> +<p>The <code>profile</code> element in the <code>settings.xml</code> is a truncated version of +the <code>pom.xml</code> <code>profile</code> element. It consists of the <code>activation</code>, +<code>repositories</code>, <code>pluginRepositories</code> and <code>properties</code> elements. The +<code>profile</code> elements only include these four elements because they +concerns themselves with the build system as a whole (which is the role +of the <code>settings.xml</code> file), not about individual project object model +settings.</p> +<p>If a profile is active from <code>settings</code>, its values will override any +equivalently ID'd profiles in a POM or <code>profiles.xml</code> file.</p><section> +<h4>Activation</h4> +<p>Activations are the key of a profile. Like the POM's profiles, the power +of a profile comes from its ability to modify some values only under +certain circumstances; those circumstances are specified via an +<code>activation</code> element.</p> + +<div class="verbatim"> +<pre><code class="language-xml"><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd"> + ... + <profiles> + <profile> + <id>test</id> + <activation> + <activeByDefault>false</activeByDefault> + <jdk>1.5</jdk> + <os> + <name>Windows XP</name> + <family>Windows</family> + <arch>x86</arch> + <version>5.1.2600</version> + </os> + <property> + <name>mavenVersion</name> + <value>2.0.3</value> + </property> + <file> + <exists>${basedir}/file2.properties</exists> + <missing>${basedir}/file1.properties</missing> + </file> + </activation> + ... + </profile> + </profiles> + ... +</settings> +</code></pre></div> +<p>Activation occurs when all specified criteria have been met, though not +all are required at once.</p> +<ul> + +<li><strong>jdk</strong>: <code>activation</code> has a built in, Java-centric check in the +<code>jdk</code> element. This will activate if the test is run under a jdk +version number that matches the prefix given. In the above example, +<code>1.5.0_06</code> will match. Ranges are also supported. +See the +<a href="https://maven.apache.org/enforcer/enforcer-rules/versionRanges.html" class="externalLink">maven-enforcer-plugin</a> +for more details about supported ranges.</li> +<li><strong>os</strong>: The <code>os</code> element can define some operating system specific +properties shown above. See the +<a href="https://maven.apache.org/plugins/maven-enforcer-plugin/rules/requireOS.html" class="externalLink">maven-enforcer-plugin</a> +for more details about OS values.</li> +<li><strong>property</strong>: The <code>profile</code> will activate if Maven detects a +property (a value which can be dereferenced within the POM by +<code>${name}</code>) of the corresponding <code>name=value</code> pair.</li> +<li><strong>file</strong>: Finally, a given filename may activate the <code>profile</code> by +the <code>existence</code> of a file, or if it is <code>missing</code>.</li> +</ul> +<p>The <code>activation</code> element is not the only way that a <code>profile</code> may be +activated. The <code>settings.xml</code> file's <code>activeProfile</code> element may contain +the profile's <code>id</code>. They may also be activated explicitly through the +command line via a comma separated list after the <code>-P</code> flag (e.g. +<code>-P test</code>).</p> +<p><em>To see which profile will activate in a certain build, use the</em> +<code>maven-help-plugin</code>.</p> + +<div class="verbatim"> +<pre><code>mvn help:active-profiles +</code></pre></div></section><section> +<h4>Properties</h4> +<p>Maven properties are value placeholder, like properties in Ant. Their +values are accessible anywhere within a POM by using the notation +<code>${X}</code>, where <code>X</code> is the property. They come in five different styles, +all accessible from the <code>settings.xml</code> file:</p> +<ol style="list-style-type: decimal"> + +<li><code>env.X</code>: Prefixing a variable with “env.” will return the shell's +environment variable. For example, <code>${env.PATH}</code> contains the $path +environment variable (<code>%PATH%</code> in Windows).</li> +<li><code>project.x</code>: A dot (.) notated path in the POM will contain the +corresponding element's value. For example: +<code><project><version>1.0</version></project></code> is accessible via +<code>${project.version}</code>.</li> +<li><code>settings.x</code>: A dot (.) notated path in the <code>settings.xml</code> will +contain the corresponding element's value. For example: +<code><settings><offline>false</offline></settings></code> is accessible via +<code>${settings.offline}</code>.</li> +<li>Java System Properties: All properties accessible via +<code>java.lang.System.getProperties()</code> are available as POM properties, +such as <code>${java.home}</code>.</li> +<li><code>x</code>: Set within a <properties /> element or an external files, the +value may be used as <code>${someVar}</code>.</li> +</ol><!-- --> + +<div class="verbatim"> +<pre><code class="language-xml"><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd"> + ... + <profiles> + <profile> + ... + <properties> + <user.install>${user.home}/our-project</user.install> + </properties> + ... + </profile> + </profiles> + ... +</settings> +</code></pre></div> +<p>The property <code>${user.install}</code> is accessible from a POM if this profile +is active.</p></section><section> +<h4>Repositories</h4> +<p>Repositories are remote collections of projects from which Maven uses to +populate the local repository of the build system. It is from this local +repository that Maven calls it plugins and dependencies. Different +remote repositories may contain different projects, and under the active +profile they may be searched for a matching release or snapshot +artifact.</p> + +<div class="verbatim"> +<pre><code class="language-xml"><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd"> + ... + <profiles> + <profile> + ... + <repositories> + <repository> + <id>codehausSnapshots</id> + <name>Codehaus Snapshots</name> + <releases> + <enabled>false</enabled> + <updatePolicy>always</updatePolicy> + <checksumPolicy>warn</checksumPolicy> + </releases> + <snapshots> + <enabled>true</enabled> + <updatePolicy>never</updatePolicy> + <checksumPolicy>fail</checksumPolicy> + </snapshots> + <url>http://snapshots.maven.codehaus.org/maven2</url> + <layout>default</layout> + </repository> + </repositories> + <pluginRepositories> + <pluginRepository> + <id>myPluginRepo</id> + <name>My Plugins repo</name> + <releases> + <enabled>true</enabled> + </releases> + <snapshots> + <enabled>false</enabled> + </snapshots> + <url>https://maven-central-eu....com/maven2/</url> + </pluginRepository> + </pluginRepositories> + ... + </profile> + </profiles> + ... +</settings> +</code></pre></div> +<ul> + +<li><strong>releases</strong>, <strong>snapshots</strong>: These are the policies for each type of +artifact, Release or snapshot. With these two sets, a POM has the +power to alter the policies for each type independent of the other +within a single repository. For example, one may decide to enable +only snapshot downloads, possibly for development purposes.</li> +<li><strong>enabled</strong>: <code>true</code> or <code>false</code> for whether this repository is +enabled for the respective type (<code>releases</code> or <code>snapshots</code>).</li> +<li><strong>updatePolicy</strong>: This element specifies how often updates should +attempt to occur. Maven will compare the local POM's timestamp +(stored in a repository's maven-metadata file) to the remote. The +choices are: <code>always</code>, <code>daily</code> (default), <code>interval:X</code> (where X is +an integer in minutes) or <code>never</code>.</li> +<li><strong>checksumPolicy</strong>: When Maven deploys files to the repository, it +also deploys corresponding checksum files. Your options are to +<code>ignore</code>, <code>fail</code>, or <code>warn</code> on missing or incorrect checksums.</li> +<li><strong>layout</strong>: In the above description of repositories, it was +mentioned that they all follow a common layout. This is mostly +correct. Maven 2 has a default layout for its repositories; however, +Maven 1.x had a different layout. Use this element to specify which +if it is <code>default</code> or <code>legacy</code>.</li> +</ul></section><section> +<h4>Plugin Repositories</h4> +<p>Repositories are home to two major types of artifacts. The first are +artifacts that are used as dependencies of other artifacts. These are +the majority of artifacts that reside within central. The other type of +artifact is plugins. Maven plugins are themselves a special type of +artifact. Because of this, plugin repositories may be separated from +other repositories (although, I have yet to hear a convincing argument +for doing so). In any case, the structure of the <code>pluginRepositories</code> +element block is similar to the <code>repositories</code> element. The +<code>pluginRepository</code> elements each specify a remote location of where +Maven can find new plugins.</p></section></section><section> +<h3>Active Profiles</h3> + +<div class="verbatim"> +<pre><code class="language-xml"><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd"> + ... + <activeProfiles> + <activeProfile>env-test</activeProfile> + </activeProfiles> +</settings> +</code></pre></div> +<p>The final piece of the <code>settings.xml</code> puzzle is the <code>activeProfiles</code> +element. This contains a set of <code>activeProfile</code> elements, which each +have a value of a <code>profile</code> <code>id</code>. Any <code>profile</code> <code>id</code> defined as an +<code>activeProfile</code> will be active, regardless of any environment settings. +If no matching profile is found nothing will happen. For example, if +<code>env-test</code> is an <code>activeProfile</code>, a profile in a <code>pom.xml</code> (or +<code>profile.xml</code> with a corresponding <code>id</code> will be active. If no such +profile is found then execution will continue as normal.</p></section></section></section> </main> </div> </div>
Modified: maven/website/content/shared/index.html ============================================================================== --- maven/website/content/shared/index.html (original) +++ maven/website/content/shared/index.html Sun May 12 07:42:36 2024 @@ -2,19 +2,19 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/apt/shared/index.apt at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/apt/shared/index.apt at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> <meta name="author" content="Dennis Lundberg" /> <meta name="author" content="John Casey" /> <meta name="author" content="Karl Heinz Marbaise" /> <meta name="date" content="2017-05-03" /> - <title>Maven</title> + <title>Maven â Shared Components</title> <link rel="stylesheet" href="../css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="../css/site.css" /> <link rel="stylesheet" href="../css/print.css" media="print" /> @@ -41,10 +41,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href=".././" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="../images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href=".././" id="bannerRight"><img src="../images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -52,9 +50,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="../index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/apt/shared/index.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Shared Components <a href="https://github.com/apache/maven-site/tree/master/content/apt/shared/index.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="../scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="../download.cgi" title="Download">Download</a></li> @@ -133,7 +130,7 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section><a id="Shared_Components"></a> +<section> <h1>Shared Components</h1> <p>The shared components are currently under transition to Maven 3.x only components.</p> <table class="table table-bordered table-striped"> Modified: maven/website/content/skins/index.html ============================================================================== --- maven/website/content/skins/index.html (original) +++ maven/website/content/skins/index.html Sun May 12 07:42:36 2024 @@ -2,19 +2,19 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/apt/skins/index.apt at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/apt/skins/index.apt at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> <meta name="author" content="Dennis Lundberg" /> <meta name="author" content="Karl Heinz Marbaise" /> <meta name="author" content="Michael Osipov" /> <meta name="date" content="2012-04-05" /> - <title>Maven</title> + <title>Maven â Available Skins</title> <link rel="stylesheet" href="../css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="../css/site.css" /> <link rel="stylesheet" href="../css/print.css" media="print" /> @@ -41,10 +41,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href=".././" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="../images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href=".././" id="bannerRight"><img src="../images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -52,9 +50,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="../index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/apt/skins/index.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Available Skins <a href="https://github.com/apache/maven-site/tree/master/content/apt/skins/index.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="../scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="../download.cgi" title="Download">Download</a></li> @@ -133,9 +130,9 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section><a id="Available_Skins"></a> +<section> <h1>Available Skins</h1> -<p>The following table lists skins that are available for you to use in your Maven generated site.</p><section><a id="Maintained_By_The_Maven_Project"></a> +<p>The following table lists skins that are available for you to use in your Maven generated site.</p><section> <h2>Maintained By The Maven Project</h2> <table class="table table-bordered table-striped"> <tr class="a"> @@ -158,7 +155,7 @@ <td style="text-align: left;">[4,)</td> <td style="text-align: left;">Skin based on Bootstrap CSS.</td> <td style="text-align: left;"><a class="externalLink" href="http://gitbox.apache.org/repos/asf/maven-fluido-skin/">GitBox</a> / <a class="externalLink" href="https://github.com/apache/maven-fluido-skin/">GitHub</a></td> -<td style="text-align: left;"><a class="externalLink" href="https://issues.apache.org/jira/issues/?jql=project = MSKINS AND status != Closed AND component = "Fluido+Skin"">JIRA</a></td></tr></table><section><a id="Retired"></a> +<td style="text-align: left;"><a class="externalLink" href="https://issues.apache.org/jira/issues/?jql=project = MSKINS AND status != Closed AND component = "Fluido+Skin"">JIRA</a></td></tr></table><section> <h3>Retired</h3> <table class="table table-bordered table-striped"> <tr class="a"> @@ -184,7 +181,7 @@ <td style="text-align: left;">1.5</td> <td style="text-align: left;">(,3.4]</td> <td style="text-align: left;">2015-12-28</td> -<td style="text-align: left;">The skin used for the website of Maven itself.</td></tr></table></section></section><section><a id="Outside_The_Maven_Land"></a> +<td style="text-align: left;">The skin used for the website of Maven itself.</td></tr></table></section></section><section> <h2>Outside The Maven Land</h2> <table class="table table-bordered table-striped"> <tr class="a"> @@ -210,10 +207,10 @@ <tr class="b"> <td style="text-align: left;"><a class="externalLink" href="https://sentrysoftware.org/sentry-maven-skin/"> <code>Sentry Maven Skin</code></a></td> <td style="text-align: left;"><a class="externalLink" href="https://github.com/sentrysoftware/sentry-maven-skin"> Sentry Software</a></td> -<td style="text-align: left;">Responsive skin, Bootstrap-based, with local search, light/dark colors switch, WEBP conversion, etc.</td></tr></table></section><section><a id="Instructions"></a> +<td style="text-align: left;">Responsive skin, Bootstrap-based, with local search, light/dark colors switch, WEBP conversion, etc.</td></tr></table></section><section> <h2>Instructions</h2> <p>To use one of these skins in your project, you use the <code>skin</code> element of the <a href="/plugins/maven-site-plugin/examples/sitedescriptor.html">site descriptor</a>. This is a regular artifact or dependency-like element. For example, to use the Maven Fluido Skin, you would include the this in your <code>site.xml</code> file:</p> -<pre><code><project> +<div class="verbatim source"><pre class="prettyprint linenums"><project> ... <skin> <groupId>org.apache.maven.skins</groupId> @@ -221,7 +218,7 @@ <version>1.11.1</version> </skin> ... -</project></code></pre></section></section> +</project></pre></div></section></section> </main> </div> </div> Modified: maven/website/content/support-and-training.html ============================================================================== --- maven/website/content/support-and-training.html (original) +++ maven/website/content/support-and-training.html Sun May 12 07:42:36 2024 @@ -2,15 +2,15 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/support-and-training.md at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/support-and-training.md at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> - <title>Maven</title> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> + <title>Maven â Providers of Apache Maven Support and Training</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -48,9 +46,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/support-and-training.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Providers of Apache Maven Support and Training <a href="https://github.com/apache/maven-site/tree/master/content/markdown/support-and-training.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -136,7 +133,7 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section><a id="Providers_of_Apache_Maven_Support_and_Training"></a> +<section> <h1>Providers of Apache Maven Support and Training</h1><!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file @@ -167,9 +164,9 @@ under the License. <p>The page to modify is: content/markdown/support-and-training.md</p> <p>There aren't any hard and fast rules about what is acceptable but please keep your entry to a few lines, a link and a small logo.</p> <p>Remember to add you company to both sections if you provide support and training.</p> -<p><strong>Please note entries are listed in Alpha order of company names.</strong></p><section><a id="Support"></a> -<h2>Support</h2></section><section><a id="Training"></a> -<h2>Training</h2><section><a id="Takari"></a> +<p><strong>Please note entries are listed in Alpha order of company names.</strong></p><section> +<h2>Support</h2></section><section> +<h2>Training</h2><section> <h3>Takari</h3> <p><img src="http://takari.io/assets/img/takari_logo.png" alt="Takari" /></p> <p>Takari's <a href="http://takari.io/training.html" class="externalLink">Introduction to Maven</a> virtual training course <a href="http://takari.io/training-outline.html" class="externalLink">curriculum</a> was designed by Jason van Zyl, the creator of the Apache Maven project. Whether you're a new user looking for a solid introduction or a current user looking for an essential refresh, this course was designed to offer a practical and relevant baseline of knowledge to help your team collaborate more effectively on Maven projects.</p> @@ -184,11 +181,11 @@ under the License. <li>Configure plugins to run unit tests</li> <li>Create and configure Maven multi-module projects</li> </ul> -<p>Public virtual classes run monthly. If you are interested in setting up a private virtual session, we can customize the hours to the needs of your team. Please contact us for more details at <a href="mailto:train...@takari.io" class="externalLink">train...@takari.io</a>. To learn more or get registered for an upcoming class, please click <a href="http://takari.io/training.html" class="externalLink">here</a>.</p></section><section><a id="vogella_GmbH"></a> +<p>Public virtual classes run monthly. If you are interested in setting up a private virtual session, we can customize the hours to the needs of your team. Please contact us for more details at <a href="mailto:train...@takari.io" class="externalLink">train...@takari.io</a>. To learn more or get registered for an upcoming class, please click <a href="http://takari.io/training.html" class="externalLink">here</a>.</p></section><section> <h3>vogella GmbH</h3> <p><img src="https://www.vogella.com/img/logo/index_logo.png" alt="vogella" /><br /> <a href="https://www.vogella.com/training/testbuild/maven.html" class="externalLink">vogella</a> offers a one day training to learn the benefits of the Maven build system to build, test and package Java applications.</p> -<p>vogella GmbH offers this training as a traditional classroom course or as a live virtual course.</p></section><section><a id="Web_Age_Solutions"></a> +<p>vogella GmbH offers this training as a traditional classroom course or as a live virtual course.</p></section><section> <h3>Web Age Solutions</h3> <p><img src="http://www.webagesolutions.com/graphics/new_logo.gif" alt="Web Age Solutions" /><br /> <a href="http://www.webagesolutions.com/training/continuous_integration/" class="externalLink">Web Age Solutions</a> offers training to introduce students to the theory and practice behind Apache Maven, and give the tools to build and manage software projects using Maven, Nexus, Artifactory, and Jenkins</p> Modified: maven/website/content/team.html ============================================================================== --- maven/website/content/team.html (original) +++ maven/website/content/team.html Sun May 12 07:42:36 2024 @@ -2,14 +2,14 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.5.0:team at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.5.0:team at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> <title>Maven â Project Team</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -49,7 +47,7 @@ <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> <li class="active ">Project Team</li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> Modified: maven/website/content/testimonials.html ============================================================================== --- maven/website/content/testimonials.html (original) +++ maven/website/content/testimonials.html Sun May 12 07:42:36 2024 @@ -2,15 +2,15 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/testimonials.md at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/testimonials.md at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> - <title>Maven</title> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> + <title>Maven â Testimonials</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -48,9 +46,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/testimonials.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Testimonials <a href="https://github.com/apache/maven-site/tree/master/content/markdown/testimonials.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -129,7 +126,7 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section><a id="Testimonials"></a> +<section> <h1>Testimonials</h1><!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file Modified: maven/website/content/users/getting-help.html ============================================================================== --- maven/website/content/users/getting-help.html (original) +++ maven/website/content/users/getting-help.html Sun May 12 07:42:36 2024 @@ -2,19 +2,19 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/apt/users/getting-help.apt at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/apt/users/getting-help.apt at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> <meta name="author" content="Dennis Lundberg" /> <meta name="author" content="Karl Heinz Marbaise" /> <meta name="date" content="2007-07-24 2015-06-17" /> - <title>Maven</title> + <title>Maven â Getting Help</title> <link rel="stylesheet" href="../css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="../css/site.css" /> <link rel="stylesheet" href="../css/print.css" media="print" /> @@ -41,10 +41,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href=".././" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="../images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href=".././" id="bannerRight"><img src="../images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -52,9 +50,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="../index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/apt/users/getting-help.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Getting Help <a href="https://github.com/apache/maven-site/tree/master/content/apt/users/getting-help.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="../scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="../download.cgi" title="Download">Download</a></li> @@ -148,21 +145,21 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section><a id="Getting_Help"></a> +<section> <h1>Getting Help</h1> <p>So something didn't work as you expected it to? You think that <i>Maven is broken</i>. What should you do?</p> -<p>Here's a list of actions that you can take:</p><section><a id="You_did_check_the_documentation.2C_didn.27t_you.3F"></a> +<p>Here's a list of actions that you can take:</p><section> <h2>You did check the documentation, didn't you?</h2> -<p>Apart from the central Maven site, each of our plugins has a website. Go to the <a href="../plugins/index.html">plugins page</a> and follow the link to the plugin you are having problems with.</p></section><section><a id="Try_the_latest_version_of_Maven_or_the_plugin_in_question"></a> +<p>Apart from the central Maven site, each of our plugins has a website. Go to the <a href="../plugins/index.html">plugins page</a> and follow the link to the plugin you are having problems with.</p></section><section> <h2>Try the latest version of Maven or the plugin in question</h2> -<p>Before you start intensive investigations on your problem, you should try to update Maven and/or the plugins in question to the latest stable release. After all, the issue you encounter might have been fixed already. To find out what is the latest stable release version, consult <a href="../download.html">Maven's download section</a> and the <a href="../plugins/index.html">plugin index</a>.</p></section><section><a id="Search_the_user-list_archives"></a> +<p>Before you start intensive investigations on your problem, you should try to update Maven and/or the plugins in question to the latest stable release. After all, the issue you encounter might have been fixed already. To find out what is the latest stable release version, consult <a href="../download.html">Maven's download section</a> and the <a href="../plugins/index.html">plugin index</a>.</p></section><section> <h2>Search the user-list archives</h2> -<p>Someone else might have experienced the same problem as you before. A list of mail-archives can be found on <a class="externalLink" href="https://maven.apache.org/mailing-lists.html">mailing list index page</a>. Please search one of them before going any further.</p></section><section><a id="Ask_on_the_user_list"></a> +<p>Someone else might have experienced the same problem as you before. A list of mail-archives can be found on <a class="externalLink" href="https://maven.apache.org/mailing-lists.html">mailing list index page</a>. Please search one of them before going any further.</p></section><section> <h2>Ask on the user list</h2> -<p>Our community is very helpful, just ask it the right way. See the references section, at the end of this page, for info on how to do that. Subscribe to the <a class="externalLink" href="https://maven.apache.org/mailing-lists.html">users-list</a> and describe your problem there. Don't expect to get an answer right away. Sometimes it takes a couple of days.</p></section><section><a id="Submit_an_issue"></a> +<p>Our community is very helpful, just ask it the right way. See the references section, at the end of this page, for info on how to do that. Subscribe to the <a class="externalLink" href="https://maven.apache.org/mailing-lists.html">users-list</a> and describe your problem there. Don't expect to get an answer right away. Sometimes it takes a couple of days.</p></section><section> <h2>Submit an issue</h2> <p>If it turns out that there is indeed something wrong with Maven or one of the plugins, you should report it to our issue management system JIRA.</p> -<p>You don't need create JIRA issue only to ask us something - in such case please first ask on <a class="externalLink" href="https://maven.apache.org/mailing-lists.html">users-list</a></p><section><a id="Request_new_JIRA_account"></a> +<p>You don't need create JIRA issue only to ask us something - in such case please first ask on <a class="externalLink" href="https://maven.apache.org/mailing-lists.html">users-list</a></p><section> <h3>Request new JIRA account</h3> <p>Requesting for JIRA account is preferred if you plan to contribute to project by coding or testing by longer time.</p> <p>This is so that we can communicate with you while we work together on the issue.</p> @@ -171,15 +168,15 @@ <li>links to your public projects, social or professional profile can be appreciated</li> <li>you can also tell us a little about yourself and what you intend to use this account for</li></ul> <p>Such information is useful to verify that account is requested for real user not a bot.</p> -<p>Go to the <a class="externalLink" href="https://selfserve.apache.org/jira-account.html?project=maven">Request a JIRA account</a> to request for a new account if you don't already have one.</p></section><section><a id="Where.3F"></a> +<p>Go to the <a class="externalLink" href="https://selfserve.apache.org/jira-account.html?project=maven">Request a JIRA account</a> to request for a new account if you don't already have one.</p></section><section> <h3>Where?</h3> <p>If the problem is in one of the plugins, check the site of that plugin to get the correct link. Each plugin has its own section in JIRA, so using the correct link is important. Click on <i>Project Information</i> and then <i>Issue Management</i>. On that page you will find the correct link.</p> -<p>If the problem is in Maven itself you can find the appropriate link on the <a class="externalLink" href="https://maven.apache.org/issue-management.html">issue management</a> page.</p></section><section><a id="How.3F"></a> +<p>If the problem is in Maven itself you can find the appropriate link on the <a class="externalLink" href="https://maven.apache.org/issue-management.html">issue management</a> page.</p></section><section> <h3>How?</h3> <p>Just describing the problem is not enough. It takes a developer a lot of time to make a usable POM to even attempt to assess the problem. Issues that states problems without something usable to try out will be closed as incomplete.</p> <p>Please attach a working POM, or a set of POMs, that we can download and run. We appreciate reports, but if you don't have something usable for us it's incredibly hard for us to manage the issues. A POM goes a long way to helping us resolve problems. </p> <p>Create a POM that can be used to verify that it is a bug. If your pom uses plugins, make sure that you have specified the version for each and every plugin. If you don't, then we might not be using the same version as you are when we test it.</p> -<p>What we like best are patches that fixes the problem. If you want to create a patch for an issue please read the <a href="../guides/development/guide-maven-development.html">Maven Developer Guide</a> first.</p></section></section><section><a id="References"></a> +<p>What we like best are patches that fixes the problem. If you want to create a patch for an issue please read the <a href="../guides/development/guide-maven-development.html">Maven Developer Guide</a> first.</p></section></section><section> <h2>References</h2> <ul> <li><a class="externalLink" href="http://www.catb.org/~esr/faqs/smart-questions.html">How To Ask Questions The Smart Way</a></li> Modified: maven/website/content/users/index.html ============================================================================== --- maven/website/content/users/index.html (original) +++ maven/website/content/users/index.html Sun May 12 07:42:36 2024 @@ -2,17 +2,17 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/apt/users/index.apt at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/apt/users/index.apt at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> <meta name="author" content="Brett Porter" /> <meta name="date" content="2006-11-03" /> - <title>Maven</title> + <title>Maven â Users Centre</title> <link rel="stylesheet" href="../css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="../css/site.css" /> <link rel="stylesheet" href="../css/print.css" media="print" /> @@ -39,10 +39,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href=".././" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="../images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href=".././" id="bannerRight"><img src="../images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -50,9 +48,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="../index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/apt/users/index.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Users Centre <a href="https://github.com/apache/maven-site/tree/master/content/apt/users/index.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="../scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="../download.cgi" title="Download">Download</a></li> @@ -153,14 +150,14 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section><a id="Maven_Users_Centre"></a> +<section> <h1>Maven Users Centre</h1> <p>This documentation centre is for those that have decided to use Maven to build their project, and would like to get started quickly, or are already using Maven and would like to add new functionality or fix a problem in their build.</p> <ul> <li><a href="../download.html"> Download Maven</a> - Download the latest version of Maven</li> <li><a href="../guides/getting-started/maven-in-five-minutes.html"> The 5 minute test</a> - Learn how to use Maven in 5 minutes</li> <li><a href="../guides/getting-started/index.html"> Getting Started Tutorial</a> - An in depth tutorial once you've learned the basics</li> -<li><a href="./getting-help.html"> Getting Help</a> - How to get help with Maven</li></ul><section><a id="Reference"></a> +<li><a href="./getting-help.html"> Getting Help</a> - How to get help with Maven</li></ul><section> <h2>Reference</h2> <ul> <li><a href="../pom.html"> POM Reference</a></li> Modified: maven/website/content/what-is-maven.html ============================================================================== --- maven/website/content/what-is-maven.html (original) +++ maven/website/content/what-is-maven.html Sun May 12 07:42:36 2024 @@ -2,15 +2,15 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0-M18 from content/markdown/what-is-maven.md at 2024-05-11 + | Generated by Apache Maven Doxia Site Renderer 2.0.0-M10 from content/markdown/what-is-maven.md at 2024-05-12 | Rendered using Apache Maven Fluido Skin 2.0.0-M6 --> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> - <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M18" /> - <title>Maven</title> + <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M10" /> + <title>Maven â Introduction</title> <link rel="stylesheet" href="./css/apache-maven-fluido-2.0.0-M6.min.css" /> <link rel="stylesheet" href="./css/site.css" /> <link rel="stylesheet" href="./css/print.css" media="print" /> @@ -37,10 +37,8 @@ <div class="container-fluid"> <header> <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><h1>Apache Maven Site</h1> -</a></div> - <div class="pull-right"><a href="./" id="bannerRight"><h1>$esc.xml( $banner.name )</h1> -</a></div> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="images/apache-maven-project.png" alt="Apache Maven Site" style="" /></a></div> + <div class="pull-right"><a href="./" id="bannerRight"><img src="images/maven-logo-black-on-white.png" alt="" style="" /></a></div> <div class="clear"><hr/></div> </div> @@ -48,9 +46,8 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> <li><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li> - - <li class="active ">Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/what-is-maven.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-11</li> + <li class="active ">Introduction <a href="https://github.com/apache/maven-site/tree/master/content/markdown/what-is-maven.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2024-05-12</li> <li class="pull-right"><span class="divider">|</span> <a href="scm.html" title="Get Sources">Get Sources</a></li> <li class="pull-right"><a href="download.cgi" title="Download">Download</a></li> @@ -129,7 +126,107 @@ </div> </header> <main id="bodyColumn" class="span10" > -<section> +<section><section> +<h2>Introduction</h2><!-- +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, +software distributed under the License is distributed on an +"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +KIND, either express or implied. See the License for the +specific language governing permissions and limitations +under the License. +--> + +<p>Maven, a <a href="https://en.wikipedia.org/wiki/Maven" class="externalLink">Yiddish word</a> meaning +<em>accumulator of knowledge</em>, began as an attempt to +simplify the build processes in the Jakarta Turbine project. There were +several projects, each with their own Ant build files, that were all +slightly different. JARs were checked into CVS. We wanted a standard +way to build the projects, a clear definition of what the project +consisted of, an easy way to publish project information, and a way to +share JARs across several projects.</p> +<p>The result is a tool that can now be used for building and managing any +Java-based project. We hope that we have created something that will +make the day-to-day work of Java developers easier and generally help +with the comprehension of any Java-based project.</p></section><section> +<h2>Maven's Objectives</h2> +<p>Maven's primary goal is to allow a developer to comprehend the complete +state of a development effort in the shortest period of time. In order +to attain this goal, Maven deals with several areas of concern:</p> +<ul> + +<li>Making the build process easy</li> +<li>Providing a uniform build system</li> +<li>Providing quality project information</li> +<li>Encouraging better development practices</li> +</ul><section> +<h3>Making the build process easy</h3> +<p>While using Maven doesn't eliminate the need to know about the +underlying mechanisms, Maven does shield developers from many details.</p></section><section> +<h3>Providing a uniform build system</h3> +<p>Maven builds a project using its project object model (POM) and +a set of plugins. Once you familiarize yourself with one Maven +project, you know how all Maven projects build. +This saves time when navigating many projects.</p></section><section> +<h3>Providing quality project information</h3> +<p>Maven provides useful project information that is in part +taken from your POM and in part generated from your project's sources. +For example, Maven can provide:</p> +<ul> + +<li>Change log created directly from source control</li> +<li>Cross referenced sources</li> +<li>Mailing lists managed by the project</li> +<li>Dependencies used by the project</li> +<li>Unit test reports including coverage</li> +</ul> +<p>Third party code analysis products also provide Maven plugins that add their +reports to the standard information given by +Maven.</p></section><section> +<h3>Providing guidelines for best practices development</h3> +<p>Maven aims to gather current principles for best practices development +and make it easy to guide a project in that direction.</p> +<p>For example, specification, execution, and reporting of unit tests are +part of the normal build cycle using Maven. Current unit testing best +practices were used as guidelines:</p> +<ul> + +<li>Keeping test source code in a separate, but parallel source tree</li> +<li>Using test case naming conventions to locate and execute tests</li> +<li>Having test cases setup their environment instead of +customizing the build for test preparation</li> +</ul> +<p>Maven also assists in project workflow such as release and issue management.</p> +<p>Maven also suggests some guidelines on how to layout your project's +directory structure. Once you learn the layout, you can easily +navigate other projects that use Maven.</p> +<p>While Maven takes an opinionated approach to project layout, some projects +may not fit with this structure for historical reasons. While Maven is +designed to be flexible to the needs of different projects, +it cannot cater to every situation without compromising its objectives.</p> +<p>If your project has an unusual build structure that +cannot be reorganized, you may have to forgo some features or the use of +Maven altogether.</p></section></section><section> +<h2>What is Maven Not?</h2> +<p>You might have heard some of the following things about Maven:</p> +<ul> + +<li>Maven is a site and documentation tool</li> +<li>Maven extends Ant to let you download dependencies</li> +<li>Maven is a set of reusable Ant scriptlets</li> +</ul> +<p>While Maven does these things, as you can read above in the “What is +Maven?” section, these are not the only features Maven has, and its +objectives are quite different.</p></section></section> </main> </div> </div>