You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by hb...@apache.org on 2020/06/06 08:41:30 UTC
[maven-site] branch master updated: added "Repository Management"
to menu
This is an automated email from the ASF dual-hosted git repository.
hboutemy pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-site.git
The following commit(s) were added to refs/heads/master by this push:
new 27149d3 added "Repository Management" to menu
27149d3 is described below
commit 27149d3c85abd90eb0c8371c26418d29aa9d77d0
Author: Hervé Boutemy <hb...@apache.org>
AuthorDate: Sat Jun 6 10:41:25 2020 +0200
added "Repository Management" to menu
---
.../introduction/introduction-to-repositories.apt | 20 +++++++++++---------
.../apt/guides/mini/guide-3rd-party-jars-local.apt | 2 +-
content/site.xml | 5 +++--
3 files changed, 15 insertions(+), 12 deletions(-)
diff --git a/content/apt/guides/introduction/introduction-to-repositories.apt b/content/apt/guides/introduction/introduction-to-repositories.apt
index a721482..26113d8 100644
--- a/content/apt/guides/introduction/introduction-to-repositories.apt
+++ b/content/apt/guides/introduction/introduction-to-repositories.apt
@@ -33,11 +33,13 @@ Introduction to Repositories
A repository in Maven holds build artifacts and dependencies of varying types.
- There are exactly two types of repositories: local and remote. The local repository is a directory
+ There are exactly two types of repositories: <<local>> and <<remote>>:
+
+ [[1]] 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.
- Remote repositories refer to any other type of repository, accessed by a variety of protocols such as
+ [[2]] <<remote>> repositories refer to any other type of repository, accessed by a variety of protocols such as
<<<file://>>> and <<<https://>>>. These repositories might be a truly remote repository
set up by a third party to provide their artifacts for downloading (for example,
{{{https://repo.maven.apache.org/maven2/}repo.maven.apache.org}}).
@@ -45,6 +47,8 @@ Introduction to Repositories
set up on a file or HTTP server within your company, used to share private artifacts between development teams
and for releases.
+ []
+
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.
@@ -63,7 +67,7 @@ Introduction to Repositories
repository (or for a <<<SNAPSHOT>>>, when the remote repository contains one that is newer).
By default, Maven will download from the {{{https://repo.maven.apache.org/maven2/}central}} repository.
- To override this, you need to specify a <<<mirror>>> as shown in {{{../mini/guide-mirror-settings.html}Using Mirrors for Repositories}}
+ To override this, you need to specify a <<<mirror>>> as shown in {{{../mini/guide-mirror-settings.html}Using Mirrors for Repositories}}.
You can set this in your <<<settings.xml>>> file to globally use a certain mirror. However,
it is common for a project to customise the repository in its <<<pom.xml>>>
@@ -74,7 +78,7 @@ Introduction to Repositories
** Using Mirrors for the Central Repository
- There are several official Central repositories geographically distributed. You can make
+ There are {{{/repository/}several official Central repositories}} geographically distributed. You can make
changes to your <<<settings.xml>>> file to use one or more mirrors. Instructions for this can be
found in the guide {{{../mini/guide-mirror-settings.html}Using Mirrors for Repositories}}.
@@ -83,11 +87,9 @@ Introduction to Repositories
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:
-+---+
-
+-----
mvn -o package
-
-+---+
+-----
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.
@@ -95,7 +97,7 @@ Introduction to Repositories
* Uploading to a Remote Repository
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 {{{../../repository/index.html}Repository Center}}.
+ To have someone upload to the Central Maven repository, see {{{../../repository/index.html}Repository Center}}.
* Internal Repositories
diff --git a/content/apt/guides/mini/guide-3rd-party-jars-local.apt b/content/apt/guides/mini/guide-3rd-party-jars-local.apt
index d122a2e..f34bf3b 100644
--- a/content/apt/guides/mini/guide-3rd-party-jars-local.apt
+++ b/content/apt/guides/mini/guide-3rd-party-jars-local.apt
@@ -34,7 +34,7 @@ Guide to installing 3rd party JARs
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.
- To make this easier, and less error prone, we have provided an <<install-file>> goal in the
+ To make this easier, and less error prone, we have provided an <<<install-file>>> goal in the
{{{/plugins/maven-install-plugin/}maven-install-plugin}} which should make this relatively painless.
To install a JAR in the local repository use the following command:
diff --git a/content/site.xml b/content/site.xml
index ce1e76e..f2cef6b 100644
--- a/content/site.xml
+++ b/content/site.xml
@@ -102,8 +102,9 @@ under the License.
<item name="Creating Archetypes" href="/guides/mini/guide-creating-archetypes.html" />
</item>
<item name="Repositories" href="/guides/introduction/introduction-to-repositories.html" collapse="true">
- <item name="Local" href="/guides/mini/guide-3rd-party-jars-local.html" />
- <item name="Remote" href="/guides/mini/guide-3rd-party-jars-remote.html" />
+ <item name="Install to Local" href="/guides/mini/guide-3rd-party-jars-local.html" />
+ <item name="Deploy to Remote" href="/guides/mini/guide-3rd-party-jars-remote.html" />
+ <item name="Repository Management" href="/repository-management.html" />
<item name="Authenticated HTTPS" href="/guides/mini/guide-repository-ssl.html" />
<item name="Relocation" href="/guides/mini/guide-relocation.html" />
</item>