Author: svn-site-role
Date: Sat Jun 6 08:42:25 2020
New Revision: 1878538
Log:
Site checkin for project Apache Maven Site
Modified:
maven/website/content/guides/introduction/introduction-to-repositories.html
maven/website/content/guides/mini/guide-3rd-party-jars-local.html
maven/website/content/guides/mini/guide-3rd-party-jars-remote.html
maven/website/content/guides/mini/guide-relocation.html
maven/website/content/guides/mini/guide-repository-ssl.html
maven/website/content/maven-site-1.0-site.jar
maven/website/content/repository-management.html
Modified:
maven/website/content/guides/introduction/introduction-to-repositories.html
==============================================================================
--- maven/website/content/guides/introduction/introduction-to-repositories.html
(original)
+++ maven/website/content/guides/introduction/introduction-to-repositories.html
Sat Jun 6 08:42:25 2020
@@ -75,8 +75,9 @@ Brian Fox" />
<li><a href="../../guides/introduction/introduction-to-archetypes.html"
title="Archetypes"><span class="icon-chevron-right"></span>Archetypes</a></li>
<li class="active"><a href="#"><span
class="icon-chevron-down"></span>Repositories</a>
<ul class="nav nav-list">
- <li><a href="../../guides/mini/guide-3rd-party-jars-local.html"
title="Local"><span class="none"></span>Local</a></li>
- <li><a href="../../guides/mini/guide-3rd-party-jars-remote.html"
title="Remote"><span class="none"></span>Remote</a></li>
+ <li><a href="../../guides/mini/guide-3rd-party-jars-local.html"
title="Install to Local"><span class="none"></span>Install to Local</a></li>
+ <li><a href="../../guides/mini/guide-3rd-party-jars-remote.html"
title="Deploy to Remote"><span class="none"></span>Deploy to Remote</a></li>
+ <li><a href="../../repository-management.html" title="Repository
Management"><span class="none"></span>Repository Management</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html"
title="Authenticated HTTPS"><span class="none"></span>Authenticated
HTTPS</a></li>
<li><a href="../../guides/mini/guide-relocation.html"
title="Relocation"><span class="none"></span>Relocation</a></li>
</ul></li>
@@ -147,27 +148,28 @@ Brian Fox" />
<h2><a name="Introduction_to_Repositories"></a>Introduction to
Repositories</h2><section>
<h3><a name="Artifact_Repositories"></a>Artifact Repositories</h3>
<p>A repository in Maven holds build artifacts and dependencies of varying
types.</p>
-<p>There are exactly two types of repositories: local and remote. The local
repository is a directory on the computer where Maven runs. It caches remote
downloads and contains temporary build artifacts that you have not yet
released.</p>
-<p>Remote repositories refer to any other type of repository, accessed by a
variety of protocols such as <code>file://</code> and <code>https://</code>.
These repositories might be a truly remote repository set up by a third party
to provide their artifacts for downloading (for example, <a
class="externalLink"
href="https://repo.maven.apache.org/maven2/";>repo.maven.apache.org</a>). Other
"remote" repositories may be internal repositories set up on a file
or HTTP server within your company, used to share private artifacts between
development teams and for releases.</p>
+<p>There are exactly two types of repositories: <b>local</b> and
<b>remote</b>:</p>
+<ol style="list-style-type: decimal">
+<li>the <b>local</b> repository is a directory on the computer where Maven
runs. It caches remote downloads and contains temporary build artifacts that
you have not yet released.</li>
+<li><b>remote</b> repositories refer to any other type of repository, accessed
by a variety of protocols such as <code>file://</code> and
<code>https://</code>. These repositories might be a truly remote repository
set up by a third party to provide their artifacts for downloading (for
example, <a class="externalLink"
href="https://repo.maven.apache.org/maven2/";>repo.maven.apache.org</a>). Other
"remote" repositories may be internal repositories set up on a file
or HTTP server within your company, used to share private artifacts between
development teams and for releases.</li></ol>
<p>Local and remote repositories are structured the same way so that scripts
can run on either side, or they can be synced for offline use. The layout of
the repositories is completely transparent to the Maven user,
however.</p></section><section>
<h3><a name="Using_Repositories"></a>Using Repositories</h3>
<p>In general, you should not need to do anything with the local repository on
a regular basis, except clean it out if you are short on disk space (or erase
it completely if you are willing to download everything again).</p>
<p>For the remote repositories, they are used for both downloading and
uploading (if you have the permission to do so).</p><section>
<h4><a name="Downloading_from_a_Remote_Repository"></a>Downloading from a
Remote Repository</h4>
<p>Downloading in Maven is triggered by a project declaring a dependency that
is not present in the local repository (or for a <code>SNAPSHOT</code>, when
the remote repository contains one that is newer). By default, Maven will
download from the <a class="externalLink"
href="https://repo.maven.apache.org/maven2/";>central</a> repository.</p>
-<p>To override this, you need to specify a <code>mirror</code> as shown in <a
href="../mini/guide-mirror-settings.html">Using Mirrors for Repositories</a></p>
+<p>To override this, you need to specify a <code>mirror</code> as shown in <a
href="../mini/guide-mirror-settings.html">Using Mirrors for
Repositories</a>.</p>
<p>You can set this in your <code>settings.xml</code> file to globally use a
certain mirror. However, it is common for a project to customise the repository
in its <code>pom.xml</code> and that your setting will take precedence. If
dependencies are not being found, check that you have not overridden the remote
repository.</p>
<p>For more information on dependencies, see <a
href="./introduction-to-dependency-mechanism.html">Dependency
Mechanism</a>.</p></section><section>
<h4><a name="Using_Mirrors_for_the_Central_Repository"></a>Using Mirrors for
the Central Repository</h4>
-<p>There are several official Central repositories geographically distributed.
You can make changes to your <code>settings.xml</code> file to use one or more
mirrors. Instructions for this can be found in the guide <a
href="../mini/guide-mirror-settings.html">Using Mirrors for
Repositories</a>.</p></section></section><section>
+<p>There are <a href="/repository/">several official Central repositories</a>
geographically distributed. You can make changes to your
<code>settings.xml</code> file to use one or more mirrors. Instructions for
this can be found in the guide <a
href="../mini/guide-mirror-settings.html">Using Mirrors for
Repositories</a>.</p></section></section><section>
<h3><a name="Building_Offline"></a>Building Offline</h3>
<p>If you are temporarily disconnected from the internet and you need to build
your projects offline, you can use the offline switch on the CLI:</p>
-<div class="source"><pre class="prettyprint linenums">
- mvn -o package
-</pre></div>
+<div>
+<pre> mvn -o package</pre></div>
<p>Many plugins honor the offline setting and do not perform any operations
that connect to the internet. Some examples are resolving Javadoc links and
link checking the site.</p></section><section>
<h3><a name="Uploading_to_a_Remote_Repository"></a>Uploading to a Remote
Repository</h3>
-<p>While this is possible for any type of remote repository, you must have the
permission to do so. To have someone upload to the central Maven repository,
see <a href="../../repository/index.html">Repository
Center</a>.</p></section><section>
+<p>While this is possible for any type of remote repository, you must have the
permission to do so. To have someone upload to the Central Maven repository,
see <a href="../../repository/index.html">Repository
Center</a>.</p></section><section>
<h3><a name="Internal_Repositories"></a>Internal Repositories</h3>
<p>When using Maven, particularly in a corporate environment, connecting to
the internet to download dependencies is not acceptable for security, speed or
bandwidth reasons. For that reason, it is desirable to set up an internal
repository to house a copy of artifacts, and to publish private artifacts
to.</p>
<p>Such an internal repository can be downloaded using HTTP or the file system
(with a <code>file://</code> URL), and uploaded to using SCP, FTP, or a file
copy.</p>
Modified: maven/website/content/guides/mini/guide-3rd-party-jars-local.html
==============================================================================
--- maven/website/content/guides/mini/guide-3rd-party-jars-local.html (original)
+++ maven/website/content/guides/mini/guide-3rd-party-jars-local.html Sat Jun
6 08:42:25 2020
@@ -75,8 +75,9 @@ Robert Scholte" />
<li><a href="../../guides/introduction/introduction-to-archetypes.html"
title="Archetypes"><span class="icon-chevron-right"></span>Archetypes</a></li>
<li><a
href="../../guides/introduction/introduction-to-repositories.html"
title="Repositories"><span class="icon-chevron-down"></span>Repositories</a>
<ul class="nav nav-list">
- <li class="active"><a href="#"><span class="none"></span>Local</a></li>
- <li><a href="../../guides/mini/guide-3rd-party-jars-remote.html"
title="Remote"><span class="none"></span>Remote</a></li>
+ <li class="active"><a href="#"><span class="none"></span>Install to
Local</a></li>
+ <li><a href="../../guides/mini/guide-3rd-party-jars-remote.html"
title="Deploy to Remote"><span class="none"></span>Deploy to Remote</a></li>
+ <li><a href="../../repository-management.html" title="Repository
Management"><span class="none"></span>Repository Management</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html"
title="Authenticated HTTPS"><span class="none"></span>Authenticated
HTTPS</a></li>
<li><a href="../../guides/mini/guide-relocation.html"
title="Relocation"><span class="none"></span>Relocation</a></li>
</ul></li>
@@ -146,7 +147,7 @@ Robert Scholte" />
<section>
<h2><a name="Guide_to_installing_3rd_party_JARs"></a>Guide to installing 3rd
party JARs</h2>
<p>Although rarely, but sometimes, you will have 3rd party JARs that you need
to put in your local repository for use in your builds, since they don't exist
in any public repository like <a class="externalLink"
href="https://search.maven.org";>Maven Central</a>. The JARs must be placed in
the local repository in the correct place in order for it to be correctly
picked up by Apache Maven.</p>
-<p>To make this easier, and less error prone, we have provided an
<b>install-file</b> goal in the <a
href="/plugins/maven-install-plugin/">maven-install-plugin</a> which should
make this relatively painless. </p>
+<p>To make this easier, and less error prone, we have provided an
<code>install-file</code> goal in the <a
href="/plugins/maven-install-plugin/">maven-install-plugin</a> which should
make this relatively painless. </p>
<p>To install a JAR in the local repository use the following command:</p>
<div>
<pre>mvn install:install-file -Dfile=<path-to-file>
-DgroupId=<group-id> -DartifactId=<artifact-id>
-Dversion=<version> -Dpackaging=<packaging></pre></div>
Modified: maven/website/content/guides/mini/guide-3rd-party-jars-remote.html
==============================================================================
--- maven/website/content/guides/mini/guide-3rd-party-jars-remote.html
(original)
+++ maven/website/content/guides/mini/guide-3rd-party-jars-remote.html Sat Jun
6 08:42:25 2020
@@ -74,8 +74,9 @@
<li><a href="../../guides/introduction/introduction-to-archetypes.html"
title="Archetypes"><span class="icon-chevron-right"></span>Archetypes</a></li>
<li><a
href="../../guides/introduction/introduction-to-repositories.html"
title="Repositories"><span class="icon-chevron-down"></span>Repositories</a>
<ul class="nav nav-list">
- <li><a href="../../guides/mini/guide-3rd-party-jars-local.html"
title="Local"><span class="none"></span>Local</a></li>
- <li class="active"><a href="#"><span
class="none"></span>Remote</a></li>
+ <li><a href="../../guides/mini/guide-3rd-party-jars-local.html"
title="Install to Local"><span class="none"></span>Install to Local</a></li>
+ <li class="active"><a href="#"><span class="none"></span>Deploy to
Remote</a></li>
+ <li><a href="../../repository-management.html" title="Repository
Management"><span class="none"></span>Repository Management</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html"
title="Authenticated HTTPS"><span class="none"></span>Authenticated
HTTPS</a></li>
<li><a href="../../guides/mini/guide-relocation.html"
title="Relocation"><span class="none"></span>Relocation</a></li>
</ul></li>
Modified: maven/website/content/guides/mini/guide-relocation.html
==============================================================================
--- maven/website/content/guides/mini/guide-relocation.html (original)
+++ maven/website/content/guides/mini/guide-relocation.html Sat Jun 6 08:42:25
2020
@@ -74,8 +74,9 @@
<li><a href="../../guides/introduction/introduction-to-archetypes.html"
title="Archetypes"><span class="icon-chevron-right"></span>Archetypes</a></li>
<li><a
href="../../guides/introduction/introduction-to-repositories.html"
title="Repositories"><span class="icon-chevron-down"></span>Repositories</a>
<ul class="nav nav-list">
- <li><a href="../../guides/mini/guide-3rd-party-jars-local.html"
title="Local"><span class="none"></span>Local</a></li>
- <li><a href="../../guides/mini/guide-3rd-party-jars-remote.html"
title="Remote"><span class="none"></span>Remote</a></li>
+ <li><a href="../../guides/mini/guide-3rd-party-jars-local.html"
title="Install to Local"><span class="none"></span>Install to Local</a></li>
+ <li><a href="../../guides/mini/guide-3rd-party-jars-remote.html"
title="Deploy to Remote"><span class="none"></span>Deploy to Remote</a></li>
+ <li><a href="../../repository-management.html" title="Repository
Management"><span class="none"></span>Repository Management</a></li>
<li><a href="../../guides/mini/guide-repository-ssl.html"
title="Authenticated HTTPS"><span class="none"></span>Authenticated
HTTPS</a></li>
<li class="active"><a href="#"><span
class="none"></span>Relocation</a></li>
</ul></li>
Modified: maven/website/content/guides/mini/guide-repository-ssl.html
==============================================================================
--- maven/website/content/guides/mini/guide-repository-ssl.html (original)
+++ maven/website/content/guides/mini/guide-repository-ssl.html Sat Jun 6
08:42:25 2020
@@ -74,8 +74,9 @@
<li><a href="../../guides/introduction/introduction-to-archetypes.html"
title="Archetypes"><span class="icon-chevron-right"></span>Archetypes</a></li>
<li><a
href="../../guides/introduction/introduction-to-repositories.html"
title="Repositories"><span class="icon-chevron-down"></span>Repositories</a>
<ul class="nav nav-list">
- <li><a href="../../guides/mini/guide-3rd-party-jars-local.html"
title="Local"><span class="none"></span>Local</a></li>
- <li><a href="../../guides/mini/guide-3rd-party-jars-remote.html"
title="Remote"><span class="none"></span>Remote</a></li>
+ <li><a href="../../guides/mini/guide-3rd-party-jars-local.html"
title="Install to Local"><span class="none"></span>Install to Local</a></li>
+ <li><a href="../../guides/mini/guide-3rd-party-jars-remote.html"
title="Deploy to Remote"><span class="none"></span>Deploy to Remote</a></li>
+ <li><a href="../../repository-management.html" title="Repository
Management"><span class="none"></span>Repository Management</a></li>
<li class="active"><a href="#"><span class="none"></span>Authenticated
HTTPS</a></li>
<li><a href="../../guides/mini/guide-relocation.html"
title="Relocation"><span class="none"></span>Relocation</a></li>
</ul></li>
Modified: maven/website/content/maven-site-1.0-site.jar
==============================================================================
Binary files - no diff available.
Modified: maven/website/content/repository-management.html
==============================================================================
--- maven/website/content/repository-management.html (original)
+++ maven/website/content/repository-management.html Sat Jun 6 08:42:25 2020
@@ -61,7 +61,28 @@
<li class="nav-header">Documentation</li>
<li><a href="plugins/index.html" title="Maven Plugins"><span
class="none"></span>Maven Plugins</a></li>
<li><a href="guides/index.html" title="Index (category)"><span
class="none"></span>Index (category)</a></li>
- <li><a href="users/index.html" title="User Centre"><span
class="icon-chevron-right"></span>User Centre</a></li>
+ <li><a href="users/index.html" title="User Centre"><span
class="icon-chevron-down"></span>User Centre</a>
+ <ul class="nav nav-list">
+ <li><a href="guides/getting-started/maven-in-five-minutes.html"
title="Maven in 5 Minutes"><span class="none"></span>Maven in 5 Minutes</a></li>
+ <li><a href="guides/getting-started/index.html" title="Getting Started
Guide"><span class="icon-chevron-right"></span>Getting Started Guide</a></li>
+ <li><a href="users/getting-help.html" title="Getting Help"><span
class="none"></span>Getting Help</a></li>
+ <li><a href="run-maven/index.html" title="Running Maven"><span
class="none"></span>Running Maven</a></li>
+ <li><a href="guides/mini/guide-configuring-plugins.html"
title="Configuring Plugins"><span class="icon-chevron-right"></span>Configuring
Plugins</a></li>
+ <li><a href="guides/mini/guide-site.html" title="Creating a site"><span
class="icon-chevron-right"></span>Creating a site</a></li>
+ <li><a href="guides/introduction/introduction-to-archetypes.html"
title="Archetypes"><span class="icon-chevron-right"></span>Archetypes</a></li>
+ <li><a href="guides/introduction/introduction-to-repositories.html"
title="Repositories"><span class="icon-chevron-down"></span>Repositories</a>
+ <ul class="nav nav-list">
+ <li><a href="guides/mini/guide-3rd-party-jars-local.html"
title="Install to Local"><span class="none"></span>Install to Local</a></li>
+ <li><a href="guides/mini/guide-3rd-party-jars-remote.html"
title="Deploy to Remote"><span class="none"></span>Deploy to Remote</a></li>
+ <li class="active"><a href="#"><span class="none"></span>Repository
Management</a></li>
+ <li><a href="guides/mini/guide-repository-ssl.html"
title="Authenticated HTTPS"><span class="none"></span>Authenticated
HTTPS</a></li>
+ <li><a href="guides/mini/guide-relocation.html"
title="Relocation"><span class="none"></span>Relocation</a></li>
+ </ul></li>
+ <li><a href="guides/mini/index.html" title="Guides"><span
class="icon-chevron-right"></span>Guides</a></li>
+ <li><a href="settings.html" title="Settings Reference"><span
class="none"></span>Settings Reference</a></li>
+ <li><a href="pom.html" title="POM Reference"><span
class="none"></span>POM Reference</a></li>
+ <li><a href="general.html" title="FAQ"><span
class="none"></span>FAQ</a></li>
+ </ul></li>
<li><a href="plugin-developers/index.html" title="Plugin Developer
Centre"><span class="icon-chevron-right"></span>Plugin Developer Centre</a></li>
<li><a href="repository/index.html" title="Maven Central Repository"><span
class="icon-chevron-right"></span>Maven Central Repository</a></li>
<li><a href="developers/index.html" title="Maven Developer Centre"><span
class="icon-chevron-right"></span>Maven Developer Centre</a></li>
