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 <hbout...@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>