You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by sl...@apache.org on 2023/02/18 20:40:06 UTC

[maven-site] 03/14: Revert "[MNGSITE-509] Fix linking to anchors"

This is an automated email from the ASF dual-hosted git repository.

slachiewicz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-site.git

commit b0eb56ddf7578910390ffe5727b18bef048a71d2
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Sat Feb 18 21:31:21 2023 +0100

    Revert "[MNGSITE-509] Fix linking to anchors"
    
    This reverts commit 0cc3ff422b0f00629c2c533a5a690f3f4a54c8d0.
---
 content/markdown/developers/conventions/code.md    | 24 ++++++-------
 content/markdown/docs/3.5.3/release-notes.md       |  2 +-
 content/markdown/docs/3.5.4/release-notes.md       |  2 +-
 content/markdown/docs/3.6.0/release-notes.md       |  4 +--
 content/markdown/docs/3.6.1/release-notes.md       |  4 +--
 content/markdown/docs/3.6.2/release-notes.md       |  4 +--
 content/markdown/docs/3.6.3/release-notes.md       |  4 +--
 content/markdown/docs/3.8.1/release-notes.md       |  2 +-
 content/markdown/glossary.md                       |  2 +-
 .../guides/development/guide-maven-development.md  |  2 +-
 content/markdown/guides/getting-started/index.md   | 36 +++++++++----------
 .../introduction-to-dependency-mechanism.md        | 12 +++----
 .../introduction-to-plugin-prefix-mapping.md       |  2 +-
 .../introduction/introduction-to-profiles.md       | 40 +++++++++++-----------
 .../introduction/introduction-to-the-lifecycle.md  |  2 +-
 .../guides/introduction/introduction-to-the-pom.md | 30 ++++++++--------
 content/markdown/guides/mini/guide-assemblies.md   |  2 +-
 .../guides/mini/guide-configuring-plugins.md       | 36 +++++++++----------
 content/markdown/guides/mini/guide-encryption.md   | 14 ++++----
 .../markdown/guides/mini/guide-http-settings.md    | 38 ++++++++++----------
 .../guide-large-scale-centralized-deployments.md   | 10 +++---
 .../guides/mini/guide-maven-classloading.md        | 18 +++++-----
 .../markdown/guides/mini/guide-snippet-macro.md    |  2 +-
 .../markdown/guides/mini/guide-using-extensions.md |  6 ++--
 content/markdown/issue-management.md               |  2 +-
 content/markdown/plugin-developers/common-bugs.md  | 18 +++++-----
 content/markdown/settings.md                       | 34 +++++++++---------
 27 files changed, 176 insertions(+), 176 deletions(-)

diff --git a/content/markdown/developers/conventions/code.md b/content/markdown/developers/conventions/code.md
index b67457fd..0e2a3ec6 100644
--- a/content/markdown/developers/conventions/code.md
+++ b/content/markdown/developers/conventions/code.md
@@ -30,31 +30,31 @@ under the License.
  Optionally you can still import the code style formatter for your IDE from [shared-resources](https://gitbox.apache.org/repos/asf?p=maven-shared-resources.git;a=tree;f=src/main/resources/config;hb=HEAD)
 
 
- - [Generic Code Style And Convention](#generic-code-style-and-convention)
+ - [Generic Code Style And Convention](Generic_Code_Style_And_Convention)
 
- - [Java](#java)
+ - [Java](Java)
 
-  - [Java Code Style](#java-code-style)
+  - [Java Code Style](Java_Code_Style)
 
-  - [Java Code Convention](#java-code-convention)
+  - [Java Code Convention](Java_Code_Convention)
 
-  - [Java Code Convention - import layouts](#java-code-convention---import-layouts)
+  - [Java Code Convention - import layouts](Java_Code_Convention_-_import_layouts)
 
-  - [JavaDoc Convention](#javadoc-convention)
+  - [JavaDoc Convention](JavaDoc_Convention)
 
 
 
- - [XML](#xml)
+ - [XML](XML)
 
-  - [XML Code Style](#xml-code-style)
+  - [XML Code Style](XML_Code_Style)
 
-  - [Generic XML Code Convention](#generic-xml-code-convention)
+  - [Generic XML Code Convention](Generic_XML_Code_Convention)
 
-  - [POM Code Convention](#pom-code-convention)
+  - [POM Code Convention](POM_Code_Convention)
 
-  - [XDOC Code Convention](#xdoc-code-convention)
+  - [XDOC Code Convention](XDOC_Code_Convention)
 
-  - [FML Code Convention](#fml-code-convention)
+  - [FML Code Convention](FML_Code_Convention)
 
 
 
diff --git a/content/markdown/docs/3.5.3/release-notes.md b/content/markdown/docs/3.5.3/release-notes.md
index 45275985..acf8467a 100644
--- a/content/markdown/docs/3.5.3/release-notes.md
+++ b/content/markdown/docs/3.5.3/release-notes.md
@@ -131,7 +131,7 @@ So now some more interesting things about new (small) features:
 
 - If you have used the deprecated version markers like `RELEASE` or `LATEST` this will now produce a WARNING during the build [MNG-6342][].
 
-## [The detailed issue list](#details)
+## [The detailed issue list](#Details)
 
 Bugs:
 
diff --git a/content/markdown/docs/3.5.4/release-notes.md b/content/markdown/docs/3.5.4/release-notes.md
index 5b2fbf90..9900d13c 100644
--- a/content/markdown/docs/3.5.4/release-notes.md
+++ b/content/markdown/docs/3.5.4/release-notes.md
@@ -72,7 +72,7 @@ There are some additional minor improvements, the most notable of which is:
 
 - The Maven Super POM changes the default execution of the `maven-source-plugin` `jar` goal into `jar-no-fork` which should resolve some issues complex projects had running releases.
 
-## [The detailed issue list](#details)
+## [The detailed issue list](#Details)
 
 ### Bugs
 - [MNG-6370][] `ConcurrencyDependencyGraph#getNumberOfBuilds()` does not remove finished projects from unfinished ones
diff --git a/content/markdown/docs/3.6.0/release-notes.md b/content/markdown/docs/3.6.0/release-notes.md
index a9d034cd..7a2a746b 100644
--- a/content/markdown/docs/3.6.0/release-notes.md
+++ b/content/markdown/docs/3.6.0/release-notes.md
@@ -37,7 +37,7 @@ We hope you enjoy using Maven! If you have any questions, please consult:
 
 We really value the contributions of these non committers, so this section is
 focused on those individuals. Descriptions of the issues fixed can be found at
-the [end of these release notes](#details).
+the [end of these release notes](#Details).
 
 Code Contributors of this release:
 
@@ -131,7 +131,7 @@ At the time of release, there are no known regressions introduced by this releas
 - There was an issue related to the classpath ordering [MNG-6415] in Maven which 
   can cause issues which has been fixed.
 
-## [The detailed issue list](#details)
+## [The detailed issue list](#Details)
 
 ### Bugs:
 
diff --git a/content/markdown/docs/3.6.1/release-notes.md b/content/markdown/docs/3.6.1/release-notes.md
index 7d32def7..3d6217db 100644
--- a/content/markdown/docs/3.6.1/release-notes.md
+++ b/content/markdown/docs/3.6.1/release-notes.md
@@ -37,7 +37,7 @@ We hope you enjoy using Maven! If you have any questions, please consult:
 
 We really value the contributions of these non committers, so this section is
 focused on those individuals. Descriptions of the issues fixed can be found at
-the [end of these release notes](#details).
+the [end of these release notes](#Details).
 
 Issue Reporters of this release:
 
@@ -191,7 +191,7 @@ Detailed explanations can be found in [Inheritance Assembly][inheritance-assembl
 
 [inheritance-assembly]: https://maven.apache.org/ref/3.6.1/maven-model-builder/index.html#Inheritance_Assembly
 
-## The detailed issue list[](#details)
+## The detailed issue list[](#Details)
 
 ### Bugs:
 
diff --git a/content/markdown/docs/3.6.2/release-notes.md b/content/markdown/docs/3.6.2/release-notes.md
index 3a70e194..4b6e041c 100644
--- a/content/markdown/docs/3.6.2/release-notes.md
+++ b/content/markdown/docs/3.6.2/release-notes.md
@@ -37,7 +37,7 @@ If you have any questions, please consult:
 
 We really value the contributions of these non committers, so this section is
 focused on those individuals. Descriptions of the issues fixed can be found at
-the [end of these release notes](#details).
+the [end of these release notes](#Details).
 
 Issue Reporters of this release: Benoit GUERIN, Christian Schulte, Elliotte Rusty Harold, Falko Modler, Francesco Chicchiriccò, Guillaume Nodet, guofei, Joseph Walton, Louis Mills, Mark Derricutt, Mark McKelvy, Mickael Istria, Nicolas Echegut, Nicolas Radde, Raphael Rösch, Ray Tsang, Robert Thornton, Rohan Padhye, Sergey Chernov, Stefan Oehme, Thibaud Lepretre, zhb.
 
@@ -58,7 +58,7 @@ Many thanks to all reporters and contributors for their time and support.
 
 - The toolchain.xml file supports environment variables (see [MNG-6665](https://issues.apache.org/jira/browse/MNG-6665)).
 
-## The detailed issue list[](#details)
+## The detailed issue list[](#Details)
 
 Sub-task
 
diff --git a/content/markdown/docs/3.6.3/release-notes.md b/content/markdown/docs/3.6.3/release-notes.md
index 9980fd54..b1b10d56 100644
--- a/content/markdown/docs/3.6.3/release-notes.md
+++ b/content/markdown/docs/3.6.3/release-notes.md
@@ -37,7 +37,7 @@ If you have any questions, please consult:
 
 We really value the contributions of these non committers, so this section is
 focused on those individuals. Descriptions of the issues fixed can be found at
-the [end of these release notes](#details).
+the [end of these release notes](#Details).
 
 Issue Reporters of this release: Jonathan Chen, Charles Oliver Nutter, Lucas Ludueño, Stig Rohde Døssing, Vladimir Sitnikov
 
@@ -61,7 +61,7 @@ mvn -DbuildNumber=cecedd343002696d0abb50b32b541b8a6ba2883f package
   If you're building on any Unix system, you'll need to add "`-Dline.separator=$'\r\n'`".  
   See the [Maven - Guide to Configuring for Reproducible Builds](/guides/mini/guide-reproducible-builds.html) for more details.
 
-## The detailed issue list[](#details)
+## The detailed issue list[](#Details)
 
 Sub-task
 
diff --git a/content/markdown/docs/3.8.1/release-notes.md b/content/markdown/docs/3.8.1/release-notes.md
index b4045bef..31c5b4df 100644
--- a/content/markdown/docs/3.8.1/release-notes.md
+++ b/content/markdown/docs/3.8.1/release-notes.md
@@ -100,7 +100,7 @@ This release covers two CVEs:
 
   - keep the dependency version but [define a mirror in your settings](/guides/mini/guide-mirror-settings.html).
 
-## The detailed issue list[](#details)
+## The detailed issue list[](#Details)
 
 Bug
 
diff --git a/content/markdown/glossary.md b/content/markdown/glossary.md
index fcb73cab..6030e5ca 100644
--- a/content/markdown/glossary.md
+++ b/content/markdown/glossary.md
@@ -36,7 +36,7 @@ sometimes be confusing for newcomers.
 -   **Artifact**: An artifact is something that is either produced or
     used by a project. Examples of artifacts produced by Maven for a
     project include: JARs, source and binary distributions, WARs. Each
-    artifact is identified by a `group id`, an
+    artifact is identified by a [group id](#GroupId), an
     artifact ID, a version, an extension and a classifier
     (extension+classifier may be named by a [type](/ref/current/maven-core/artifact-handlers.html)).
 
diff --git a/content/markdown/guides/development/guide-maven-development.md b/content/markdown/guides/development/guide-maven-development.md
index e9eb31b9..0411186b 100644
--- a/content/markdown/guides/development/guide-maven-development.md
+++ b/content/markdown/guides/development/guide-maven-development.md
@@ -85,7 +85,7 @@ under the License.
 
 
 
- - Make sure that you follow our code style, see [Further Links](#further-links).
+ - Make sure that you follow our code style, see [Further Links](Further_Links).
 
 
 
diff --git a/content/markdown/guides/getting-started/index.md b/content/markdown/guides/getting-started/index.md
index 3c472de6..443ed0e1 100644
--- a/content/markdown/guides/getting-started/index.md
+++ b/content/markdown/guides/getting-started/index.md
@@ -34,37 +34,37 @@ under the License.
 
 
 
- - [What is Maven?](./index.html#what-is-maven)
+ - [What is Maven?](./index.html#What_is_Maven)
 
- - [How can Maven benefit my development process?](./index.html#how-can-maven-benefit-my-development-process)
+ - [How can Maven benefit my development process?](./index.html#How_can_Maven_benefit_my_development_process)
 
- - [How do I setup Maven?](./index.html#how-do---setup-maven)
+ - [How do I setup Maven?](./index.html#How_do_I_setup_Maven)
 
- - [How do I make my first Maven project?](./index.html#how-do-i-make-my-first-maven-project)
+ - [How do I make my first Maven project?](./index.html#How_do_I_make_my_first_Maven_project)
 
- - [How do I compile my application sources?](./index.html#how-do-i-compile-my-application-sources)
+ - [How do I compile my application sources?](./index.html#How_do_I_compile_my_application_sources)
 
- - [How do I compile my test sources and run my unit tests?](./index.html#how-do-i-compile-my-test-sources-and-run-my-unit-tests)
+ - [How do I compile my test sources and run my unit tests?](./index.html#How_do_I_compile_my_test_sources_and_run_my_unit_tests)
 
- - [How do I create a JAR and install it in my local repository?](./index.html#how-do-i-create-a-jar-and-install-it-in-my-local-repository)
+ - [How do I create a JAR and install it in my local repository?](./index.html#How_do_I_create_a_JAR_and_install_it_in_my_local_repository)
 
- - [What is a SNAPSHOT version?](./index.html#what-is-a-snapshot-version)
+ - [What is a SNAPSHOT version?](./index.html#What_is_a_SNAPSHOT_version)
 
- - [How do I use plugins?](./index.html#how-do-i-use-plugins)
+ - [How do I use plugins?](./index.html#How_do_I_use_plugins)
 
- - [How do I add resources to my JAR?](./index.html#how-do-i-add-resources-to-my-jar)
+ - [How do I add resources to my JAR?](./index.html#How_do_I_add_resources_to_my_JAR)
 
- - [How do I filter resource files?](./index.html#how-do-i-filter-resource-files)
+ - [How do I filter resource files?](./index.html#How_do_I_filter_resource_files)
 
- - [How do I use external dependencies?](./index.html#how-do-i-use-external-dependencies)
+ - [How do I use external dependencies?](./index.html#How_do_I_use_external_dependencies)
 
- - [How do I deploy my jar in my remote repository?](./index.html#how-do-i-deploy-my-jar-in-my-remote-repository)
+ - [How do I deploy my jar in my remote repository?](./index.html#How_do_I_deploy_my_jar_in_my_remote_repository)
 
- - [How do I create documentation?](./index.html#how-do-i-create-documentation)
+ - [How do I create documentation?](./index.html#How_do_I_create_documentation)
 
- - [How do I build other types of projects?](./index.html#how-do-i-build-other-types-of-projects)
+ - [How do I build other types of projects?](./index.html#How_do_I_build_other_types_of_projects)
 
- - [How do I build more than one project at once?](./index.html#how-do-i-build-more-than-one-project-at-once)
+ - [How do I build more than one project at once?](./index.html#How_do_I_build_more_than_one_project_at_once)
 
 
 ### What is Maven?
@@ -179,7 +179,7 @@ mvn -B archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -Darch
 
  - **artifactId** This element indicates the unique base name of the primary artifact being generated by this project. The primary artifact for a project is typically a JAR file. Secondary artifacts like source bundles also use the artifactId as part of their final name. A typical artifact produced by Maven would have the form `<artifactId>-<version>.<extension>` (for example, `myapp-1.0.jar`).
 
- - **version** This element indicates the version of the artifact generated by the project. Maven goes a long way to help you with version management and you will often see the `SNAPSHOT` designator in a version, which indicates that a project is in a state of development. We will discuss the use of [snapshots](./index.html#what-is-a-snapshot-version) and how they work further on in this guide.
+ - **version** This element indicates the version of the artifact generated by the project. Maven goes a long way to help you with version management and you will often see the `SNAPSHOT` designator in a version, which indicates that a project is in a state of development. We will discuss the use of [snapshots](./index.html#What_is_a_SNAPSHOT_version) and how they work further on in this guide.
 
  - **name** This element indicates the display name used for the project. This is often used in Maven's generated documentation.
 
@@ -878,7 +878,7 @@ mvn process-resources "-Dcommand.line.prop=hello again"
  For more information about the dependency mechanism as a whole, see [Introduction to Dependency Mechanism](../introduction/introduction-to-dependency-mechanism.html).
 
 
- With this information about a dependency, Maven will be able to reference the dependency when it builds the project. Where does Maven reference the dependency from? Maven looks in your local repository (`${user.home}/.m2/repository` is the default location) to find all dependencies. In a [previous section](#how-do-i-create-a-jar-and-install-it-in-my-local-repository), we installed the artifact from our project (my-app-1.0-SNAPSHOT.jar) into the local repository. Once it's installed ther [...]
+ With this information about a dependency, Maven will be able to reference the dependency when it builds the project. Where does Maven reference the dependency from? Maven looks in your local repository (`${user.home}/.m2/repository` is the default location) to find all dependencies. In a [previous section](How_do_I_create_a_JAR_and_install_it_in_my_local_repository), we installed the artifact from our project (my-app-1.0-SNAPSHOT.jar) into the local repository. Once it's installed there [...]
 
 
 
diff --git a/content/markdown/guides/introduction/introduction-to-dependency-mechanism.md b/content/markdown/guides/introduction/introduction-to-dependency-mechanism.md
index ff43f3ab..459a8d98 100644
--- a/content/markdown/guides/introduction/introduction-to-dependency-mechanism.md
+++ b/content/markdown/guides/introduction/introduction-to-dependency-mechanism.md
@@ -30,23 +30,23 @@ under the License.
 
 
 
- - [Transitive Dependencies](#transitive-dependencies)
+ - [Transitive Dependencies](Transitive_Dependencies)
 
   - Excluded/Optional Dependencies
 
 
 
- - [Dependency Scope](#dependency-scope)
+ - [Dependency Scope](Dependency_Scope)
 
- - [Dependency Management](#dependency-management)
+ - [Dependency Management](Dependency_Management)
 
-  - [Importing Dependencies](#importing-dependencies)
+  - [Importing Dependencies](Importing_Dependencies)
 
-  - [Bill of Materials (BOM) POMs](#bill-of-materials-bom-poms)
+  - [Bill of Materials (BOM) POMs](bill-of-materials-bom-poms)
 
 
 
- - [System Dependencies](#system-dependencies)
+ - [System Dependencies](System_Dependencies)
 
 
 ### Transitive Dependencies
diff --git a/content/markdown/guides/introduction/introduction-to-plugin-prefix-mapping.md b/content/markdown/guides/introduction/introduction-to-plugin-prefix-mapping.md
index 9f144e42..da041f44 100644
--- a/content/markdown/guides/introduction/introduction-to-plugin-prefix-mapping.md
+++ b/content/markdown/guides/introduction/introduction-to-plugin-prefix-mapping.md
@@ -39,7 +39,7 @@ under the License.
 
 
 
- - `maven-${prefix}-plugin` - for official plugins maintained by the Apache Maven team itself (you **must not** use this naming pattern for your plugin, see [this note for more informations](../plugin/guide-java-plugin-development.html#plugin-naming-convention-and-apache-maven-trademark))
+ - `maven-${prefix}-plugin` - for official plugins maintained by the Apache Maven team itself (you **must not** use this naming pattern for your plugin, see [this note for more informations](../plugin/guide-java-plugin-development.html#Plugin_Naming_Convention_and_Apache_Maven_Trademark))
 
  - `${prefix}-maven-plugin` - for plugins from other sources
 
diff --git a/content/markdown/guides/introduction/introduction-to-profiles.md b/content/markdown/guides/introduction/introduction-to-profiles.md
index 9b7caf2d..920c4327 100644
--- a/content/markdown/guides/introduction/introduction-to-profiles.md
+++ b/content/markdown/guides/introduction/introduction-to-profiles.md
@@ -25,55 +25,55 @@ under the License.
 
 
 
- - [What are the different types of profile? Where is each defined?](#what-are-the-different-types-of-profile-where-is-each-defined)
+ - [What are the different types of profile? Where is each defined?](What_are_the_different_types_of_profile.3F_Where_is_each_defined.3F)
 
- - [How can a profile be triggered? How does this vary according to the type of profile being used?](#how-can-a-profile-be-triggered-how-does-this-vary-according-to-the-type-of-profile-being-used)
+ - [How can a profile be triggered? How does this vary according to the type of profile being used?](How_can_a_profile_be_triggered.3F_How_does_this_vary_according_to_the_type_of_profile_being_used.3F)
 
-  - [Details on profile activation](#details-on-profile-activation)
+  - [Details on profile activation](Details_on_profile_activation)
 
-   - [Explicit profile activation](#explicit-profile-activation)
+   - [Explicit profile activation](Explicit_profile_activation)
 
-   - [Implicit profile activation](#implici-profile-activation)
+   - [Implicit profile activation](Implicit_profile_activation)
 
-    - [JDK](#jdk)
+    - [JDK](JDK)
 
-    - [OS](#os)
+    - [OS](OS)
 
-    - [Property](#property)
+    - [Property](Property)
 
-    - [Files](#files)
+    - [Files](Files)
 
 
 
 
 
-  - [Deactivating a profile](#deactivating-a-profile)
+  - [Deactivating a profile](Deactivating_a_profile)
 
 
 
- - [Which areas of a POM can be customized by each type of profile? Why?](#which-areas-of-a-pom-can-be-customized-by-each-type-of-profile-why)
+ - [Which areas of a POM can be customized by each type of profile? Why?](Which_areas_of_a_POM_can_be_customized_by_each_type_of_profile.3F_Why.3F)
 
-  - [Profiles in external files](#profiles-in-external-files)
+  - [Profiles in external files](Profiles_in_external_files)
 
-  - [Profiles in POMs](#profiles-in-poms)
+  - [Profiles in POMs](Profiles_in_POMs)
 
-  - [POM elements outside `<profiles>`](#pom-elements-outside-profiles)
+  - [POM elements outside `<profiles>`](POM_elements_outside_.3Cprofiles.3E)
 
 
 
- - [Profile Order](#profile-order)
+ - [Profile Order](Profile_Order)
 
- - [Profile Pitfalls](#profile-pitfalls)
+ - [Profile Pitfalls](Profile_Pitfalls)
 
-  - [External Properties](#external-properties)
+  - [External Properties](External_Properties)
 
-  - [Incomplete Specification of a Natural Profile Set](#incomplete-specification-of-a-natural-profile-set)
+  - [Incomplete Specification of a Natural Profile Set](Incomplete_Specification_of_a_Natural_Profile_Set)
 
 
 
- - [How can I tell which profiles are in effect during a build?](#how-can-i-tell-which-profiles-are-in-effect-during-a-build)
+ - [How can I tell which profiles are in effect during a build?](How_can_I_tell_which_profiles_are_in_effect_during_a_build.3F)
 
- - [Naming Conventions](#naming-conventions)
+ - [Naming Conventions](Naming_Conventions)
 
 
  Apache Maven goes to great lengths to ensure that builds are portable. Among other things, this means allowing build configuration inside the POM, avoiding **all** filesystem references (in inheritance, dependencies, and other places), and leaning much more heavily on the local repository to store the metadata needed to make this possible.
diff --git a/content/markdown/guides/introduction/introduction-to-the-lifecycle.md b/content/markdown/guides/introduction/introduction-to-the-lifecycle.md
index 8d2dbbf7..17bb85b0 100644
--- a/content/markdown/guides/introduction/introduction-to-the-lifecycle.md
+++ b/content/markdown/guides/introduction/introduction-to-the-lifecycle.md
@@ -36,7 +36,7 @@ under the License.
  
    - [Plugins](#plugins)
 
- - [Lifecycle Reference](#lifecycle-reference)
+ - [Lifecycle Reference](Lifecycle_Reference)
 
  - [Built-in Lifecycle Bindings](#built-in-lifecycle-bindings)
 
diff --git a/content/markdown/guides/introduction/introduction-to-the-pom.md b/content/markdown/guides/introduction/introduction-to-the-pom.md
index 9f6b3909..4554ee0d 100644
--- a/content/markdown/guides/introduction/introduction-to-the-pom.md
+++ b/content/markdown/guides/introduction/introduction-to-the-pom.md
@@ -27,37 +27,37 @@ under the License.
 
 
 
- - [What is a POM](./introduction-to-the-pom.html#what-is-a-pom)?
+ - [What is a POM](./introduction-to-the-pom.html#What_is_a_POM)?
 
- - [Super POM](./introduction-to-the-pom.html#super-pom)
+ - [Super POM](./introduction-to-the-pom.html#Super_POM)
 
- - [Minimal POM](./introduction-to-the-pom.html#minimal-pom)
+ - [Minimal POM](./introduction-to-the-pom.html#Minimal_POM)
 
- - [Project Inheritance](./introduction-to-the-pom.html#project-inheritance)
+ - [Project Inheritance](./introduction-to-the-pom.html#Project_Inheritance)
 
-  - [Example 1](./introduction-to-the-pom.html#example-1)
+  - [Example 1](./introduction-to-the-pom.html#Example_1)
 
-  - [Example 2](./introduction-to-the-pom.html#example-2)
+  - [Example 2](./introduction-to-the-pom.html#Example_2)
 
 
 
- - [Project Aggregation](./introduction-to-the-pom.html#project-aggregation)
+ - [Project Aggregation](./introduction-to-the-pom.html#Project_Aggregation)
 
-  - [Example 3](./introduction-to-the-pom.html#example-3)
+  - [Example 3](./introduction-to-the-pom.html#Example_3)
 
-  - [Example 4](./introduction-to-the-pom.html#example-4)
+  - [Example 4](./introduction-to-the-pom.html#Example_4)
 
 
 
- - [Project Inheritance vs Project Aggregation](./introduction-to-the-pom.html#project-inheritance-vs-project-aggregation)
+ - [Project Inheritance vs Project Aggregation](./introduction-to-the-pom.html#Project_Inheritance_vs_Project_Aggregation)
 
-  - [Example 5](./introduction-to-the-pom.html#example-5)
+  - [Example 5](./introduction-to-the-pom.html#Example_5)
 
 
 
- - [Project Interpolation and Variables](./introduction-to-the-pom.html#project-nterpolation)
+ - [Project Interpolation and Variables](./introduction-to-the-pom.html#Project_Interpolation)
 
-  - [Available Variables](./introduction-to-the-pom.html#available-variables)
+  - [Available Variables](./introduction-to-the-pom.html#Available_Variables)
 
 
 
@@ -123,7 +123,7 @@ under the License.
  A POM requires that its groupId, artifactId, and version be configured. These three values form the project's fully qualified artifact name. This is in the form of `<groupId>:<artifactId>:<version>`. As for the example above, its fully qualified artifact name is "com.mycompany.app:my-app:1".
 
 
- Also, as mentioned in the [first section](#hat-is-a-pom), if the configuration details are not specified, Maven will use their defaults. One of these default values is the packaging type. Every Maven project has a packaging type. If it is not specified in the POM, then the default value "jar" would be used.
+ Also, as mentioned in the [first section](What_is_a_POM), if the configuration details are not specified, Maven will use their defaults. One of these default values is the packaging type. Every Maven project has a packaging type. If it is not specified in the POM, then the default value "jar" would be used.
 
 
  Furthermore, you can see that in the minimal POM the _repositories_ were not specified. If you build your project using the minimal POM, it would inherit the _repositories_ configuration in the Super POM. Therefore when Maven sees the dependencies in the minimal POM, it would know that these dependencies will be downloaded from `https://repo.maven.apache.org/maven2` which was specified in the Super POM.
@@ -299,7 +299,7 @@ under the License.
 ### Project Aggregation
 
 
- Project Aggregation is similar to [Project Inheritance](#project-inheritance). But instead of specifying the parent POM from the module, it specifies the modules from the parent POM. By doing so, the parent project now knows its modules, and if a Maven command is invoked against the parent project, that Maven command will then be executed to the parent's modules as well. To do Project Aggregation, you must do the following:
+ Project Aggregation is similar to [Project Inheritance](Project_Inheritance). But instead of specifying the parent POM from the module, it specifies the modules from the parent POM. By doing so, the parent project now knows its modules, and if a Maven command is invoked against the parent project, that Maven command will then be executed to the parent's modules as well. To do Project Aggregation, you must do the following:
 
 
 
diff --git a/content/markdown/guides/mini/guide-assemblies.md b/content/markdown/guides/mini/guide-assemblies.md
index d9e824f5..edc291f4 100644
--- a/content/markdown/guides/mini/guide-assemblies.md
+++ b/content/markdown/guides/mini/guide-assemblies.md
@@ -113,7 +113,7 @@ under the License.
  You can use a manually defined assembly descriptor as mentioned before but it is simpler to use the [pre-defined assembly descriptor bin](/plugins/maven-assembly-plugin/descriptor-refs.html#bin) in such cases.
 
 
- How to use such pre-defined assembly descriptors is described in the [documentation of maven-assembly-plugin](/plugins/maven-assembly-plugin/usage.html#configuration).
+ How to use such pre-defined assembly descriptors is described in the [documentation of maven-assembly-plugin](/plugins/maven-assembly-plugin/usage.html#Configuration).
 
 
 
diff --git a/content/markdown/guides/mini/guide-configuring-plugins.md b/content/markdown/guides/mini/guide-configuring-plugins.md
index 10dd07cb..e4725dba 100644
--- a/content/markdown/guides/mini/guide-configuring-plugins.md
+++ b/content/markdown/guides/mini/guide-configuring-plugins.md
@@ -25,25 +25,25 @@ under the License.
 
 
 
- - [Introduction](#introduction)
+ - [Introduction](Introduction)
 
- - [Generic Configuration](#generic-configuration)
+ - [Generic Configuration](Generic_Configuration)
 
-  - [Help Goal](#help-goal)
+  - [Help Goal](Help_Goal)
 
-  - [Configuring Parameters](#configuring-parameters)
+  - [Configuring Parameters](Configuring_Parameters)
 
-   - [Mapping Value Objects](#mapping-value-objects)
+   - [Mapping Value Objects](Mapping_Value_Objects)
 
-   - [Mapping Complex Objects](#mapping-complex-objects)
+   - [Mapping Complex Objects](Mapping_Complex_Objects)
 
-   - [Mapping Collection Types](#mapping-collection-types)
+   - [Mapping Collection Types](Mapping_Collection_Types)
 
-    - [Mapping Collections and Arrays](#mapping-collections-and-arrays)
+    - [Mapping Collections and Arrays](Mapping_Collections_and_Arrays)
 
-    - [Mapping Maps](#mapping-maps)
+    - [Mapping Maps](Mapping_Maps)
 
-    - [Mapping Properties](#mapping-properties)
+    - [Mapping Properties](Mapping_Properties)
 
 
 
@@ -51,23 +51,23 @@ under the License.
 
 
 
- - [Configuring Build Plugins](#configuring-build-plugins)
+ - [Configuring Build Plugins](Configuring_Build_Plugins)
 
-  - [Using the `<executions>` Tag](#using-the-executions-tag)
+  - [Using the `<executions>` Tag](Using_the_.3Cexecutions.3E_Tag)
 
-  - [Using the `<dependencies>` Tag](#using-the-dependencies-tag)
+  - [Using the `<dependencies>` Tag](Using_the_.3Cdependencies.3E_Tag)
 
-  - [Using the `<inherited>` Tag In Build Plugins](#using-the-inherited-tag-in-build-plugins)
+  - [Using the `<inherited>` Tag In Build Plugins](Using_the_.3Cinherited.3E_Tag_In_Build_Plugins)
 
 
 
- - [Configuring Reporting Plugins](#configuring-reporting-plugins)
+ - [Configuring Reporting Plugins](Configuring_Reporting_Plugins)
 
-  - [Using the `<reporting>` Tag VS `<build>` Tag](#using-the-reporting-tag-vs-build-tag)
+  - [Using the `<reporting>` Tag VS `<build>` Tag](Using_the_.3Creporting.3E_Tag_VS_.3Cbuild.3E_Tag)
 
-  - [Using the `<reportSets>` Tag](#using-the-reportsets-tag)
+  - [Using the `<reportSets>` Tag](Using_the_.3CreportSets.3E_Tag)
 
-  - [Using the `<inherited>` Tag In Reporting Plugins](#using-the-inherited-tag-in-reporting-plugins)
+  - [Using the `<inherited>` Tag In Reporting Plugins](Using_the_.3Cinherited.3E_Tag_In_Reporting_Plugins)
 
 
 
diff --git a/content/markdown/guides/mini/guide-encryption.md b/content/markdown/guides/mini/guide-encryption.md
index b179a386..9046c2d6 100644
--- a/content/markdown/guides/mini/guide-encryption.md
+++ b/content/markdown/guides/mini/guide-encryption.md
@@ -25,15 +25,15 @@ under the License.
 
 
 
- 1 [Introduction](#introduction)
+ 1 [Introduction](Introduction)
 
- 1 [How to create a master password](#how-to-create-a-master-password)
+ 1 [How to create a master password](How_to_create_a_master_password)
 
- 1 [How to encrypt server passwords](#how-to-encrypt-server-passwords)
+ 1 [How to encrypt server passwords](How_to_encrypt_server_passwords)
 
- 1 [How to keep the master password on removable drive](#how-to-keep-the-master-password-on-removable-drive)
+ 1 [How to keep the master password on removable drive](How_to_keep_the_master_password_on_removable_drive)
 
- 1 [Tips](#tips)
+ 1 [Tips](Tips)
 
 
 ### Introduction
@@ -87,7 +87,7 @@ under the License.
 mvn --encrypt-master-password <password>
 ```
 
- _Note:_ Since Maven 3.2.1 the password argument should no longer be used (see [Tips](#tips) below for more information). Maven will prompt for the password. Earlier versions of Maven will not prompt for a password, so it must be typed on the command-line in plaintext.
+ _Note:_ Since Maven 3.2.1 the password argument should no longer be used (see [Tips](Tips) below for more information). Maven will prompt for the password. Earlier versions of Maven will not prompt for a password, so it must be typed on the command-line in plaintext.
 
 
  This command will produce an encrypted version of the password, something like
@@ -123,7 +123,7 @@ mvn --encrypt-master-password <password>
 mvn --encrypt-password <password>
 ```
 
- _Note:_Just like `--encrypt-master-password` the password argument should no longer be used since Maven 3.2.1 (see [Tips below for more information.](#tips)).
+ _Note:_Just like `--encrypt-master-password` the password argument should no longer be used since Maven 3.2.1 (see [Tips below for more information.](Tips)).
 
 
  This command produces an encrypted version of it, something like
diff --git a/content/markdown/guides/mini/guide-http-settings.md b/content/markdown/guides/mini/guide-http-settings.md
index 7f3d85fc..b786b1b9 100644
--- a/content/markdown/guides/mini/guide-http-settings.md
+++ b/content/markdown/guides/mini/guide-http-settings.md
@@ -25,49 +25,49 @@ under the License.
 
 
 
- - [Advanced Configuration of the Maven Resolver Transport](#advanced-configuration-of-the-maven-resolver-transport)
+ - [Advanced Configuration of the Maven Resolver Transport](Advanced_Configuration_of_the_Maven_Resolver_Transport)
 
-  - [Advanced configuration to Transports](#advanced-configuration-to-transports)
+  - [Advanced configuration to Transports](Advanced_configuration_to_Transports)
 
-   - [HTTP Headers](#http-headers)
+   - [HTTP Headers](HTTP_Headers)
 
-   - [Connection Timeouts](#connection-timeouts)
+   - [Connection Timeouts](Connection_Timeouts)
 
 
 
-  - [Advanced Configuration of the HttpClient HTTP Wagon](#advanced-configuration-of-the-httpclient-http-wagon)
+  - [Advanced Configuration of the HttpClient HTTP Wagon](Advanced_Configuration_of_the_HttpClient_HTTP_Wagon)
 
-   - [Introduction](#introduction)
+   - [Introduction](Introduction)
 
-   - [The Basics](#the-basics)
+   - [The Basics](The_Basics)
 
-   - [Configuring GET, HEAD, PUT, or All of the Above](#configuring-get-head-put-or-all-of-the-above)
+   - [Configuring GET, HEAD, PUT, or All of the Above](Configuring_GET.2C_HEAD.2C_PUT.2C_or_All_of_the_Above)
 
-   - [Taking Control of Your HTTP Headers](#taking-control-of-your-http-headers)
+   - [Taking Control of Your HTTP Headers](Taking_Control_of_Your_HTTP_Headers)
 
-   - [Fine-Tuning HttpClient Parameters](#fine-tuning-httpclient-parameters)
+   - [Fine-Tuning HttpClient Parameters](Fine-Tuning_HttpClient_Parameters)
 
-    - [Non-String Parameter Values](#non-string-parameter-values)
+    - [Non-String Parameter Values](Non-String_Parameter_Values)
 
-    - [Example: Using Preemptive Authentication](#example--using-preemptive-authentication)
+    - [Example: Using Preemptive Authentication](Example:_Using_Preemptive_Authentication)
 
-    - [Example: Lifting auth scope restriction for external authentication systems](#example--lifting-auth-scope-restriction-for-external-authentication-systems)
+    - [Example: Lifting auth scope restriction for external authentication systems](Example:_Lifting_auth_scope_restriction_for_external_authentication_systems)
 
-    - [Ignoring Cookies](#ignoring-cookies)
+    - [Ignoring Cookies](Ignoring_Cookies)
 
 
 
-   - [Support for General-Wagon Configuration Standards](#support-for-general-wagon-configuration-standards)
+   - [Support for General-Wagon Configuration Standards](Support_for_General-Wagon_Configuration_Standards)
 
-     - [HTTP Headers](#http-headers-1)
+    - [HTTP Headers](HTTP_Headers_1)
 
-     - [Connection Timeouts](#connection-timeouts-1)
+    - [Connection Timeouts](Connection_Timeouts_1)
 
-     - [Read time out](#read-time-out)
+    - [Read time out](Read_time_out)
 
 
 
-   - [Resources](#resources)
+   - [Resources](Resources)
 
 
 
diff --git a/content/markdown/guides/mini/guide-large-scale-centralized-deployments.md b/content/markdown/guides/mini/guide-large-scale-centralized-deployments.md
index 1c52b63a..235d162c 100644
--- a/content/markdown/guides/mini/guide-large-scale-centralized-deployments.md
+++ b/content/markdown/guides/mini/guide-large-scale-centralized-deployments.md
@@ -68,7 +68,7 @@ under the License.
 
  - a hosted repository for snapshots
 
- - a hosted repository that can contain both releases and snapshots (Only needed if some projects are still using Maven Deploy Plugin < 2.8. See [Managing Uploads to the Repository Manager](#managing-uploads-to-the-repository-manager) for more info.)
+ - a hosted repository that can contain both releases and snapshots (Only needed if some projects are still using Maven Deploy Plugin < 2.8. See [Managing Uploads to the Repository Manager](Managing_Uploads_to_the_Repository_Manager) for more info.)
 
 
  Separate hosted repositories are generally used for releases and snapshots due to the need for different artifact retention policies.
@@ -78,9 +78,9 @@ under the License.
 
 
 
- - [Download](#managing-downloads-from-the-repository-manager) artifacts from the virtual repository.
+ - [Download](Managing_Downloads_from_the_Repository_Manager) artifacts from the virtual repository.
 
- - [Upload](#managing-uploads-to-the-repository-manager) artifacts to one of the hosted repositories.
+ - [Upload](Managing_Uploads_to_the_Repository_Manager) artifacts to one of the hosted repositories.
 
 
 
@@ -228,10 +228,10 @@ under the License.
  - on developer machines
 
 
- Both locations should have the mirror settings mentioned in [Managing Downloads from the Repository Manager](#managing-downloads-from-the-repository-manager).
+ Both locations should have the mirror settings mentioned in [Managing Downloads from the Repository Manager](Managing_Downloads_from_the_Repository_Manager).
 
 
- Typically, only continuous integration servers should have the deployment repository settings mentioned in [Managing Uploads to the Repository Manager](#managing-uploads-to-the-repository-manager), because only continuous integration servers should be allowed to upload to the repository manager. Alternatively, if you want developers to be able to upload artifacts to the repository manager, then include the deployment repository properties in the `settings.xml` files used by developers.
+ Typically, only continuous integration servers should have the deployment repository settings mentioned in [Managing Uploads to the Repository Manager](Managing_Uploads_to_the_Repository_Manager), because only continuous integration servers should be allowed to upload to the repository manager. Alternatively, if you want developers to be able to upload artifacts to the repository manager, then include the deployment repository properties in the `settings.xml` files used by developers.
 
 
  How the `settings.xml` files are stored and updated is beyond the scope of this document. The general recommendation is to manage a few `settings.xml` files centrally, and then use automation to distribute them to continuous integration servers and developer machines.
diff --git a/content/markdown/guides/mini/guide-maven-classloading.md b/content/markdown/guides/mini/guide-maven-classloading.md
index 7d691edc..e4d7cd0a 100644
--- a/content/markdown/guides/mini/guide-maven-classloading.md
+++ b/content/markdown/guides/mini/guide-maven-classloading.md
@@ -27,23 +27,23 @@ under the License.
 
 
 
- - [Overview](#overview)
+ - [Overview](Overview)
 
- - [Platform Classloader](#platform-classloader)
+ - [Platform Classloader](Platform_Classloader)
 
- - [System Classloader](#system-classloader)
+ - [System Classloader](System_Classloader)
 
- - [Core Classloader](#core-classloader)
+ - [Core Classloader](Core_Classloader)
 
- - [API Classloader](#api-classloader)
+ - [API Classloader](API_Classloader)
 
- - [Build Extension Classloaders](#build-extension-classloaders)
+ - [Build Extension Classloaders](Build_Extension_Classloaders)
 
- - [Project Classloaders](#project-classloaders)
+ - [Project Classloaders](Project_Classloaders)
 
- - [Plugin Classloaders](#platform-classloader)
+ - [Plugin Classloaders](Plugin_Classloaders)
 
- - [Custom Classloaders](#custom-classloaders)
+ - [Custom Classloaders](Custom_Classloaders)
 
 
 ### Overview
diff --git a/content/markdown/guides/mini/guide-snippet-macro.md b/content/markdown/guides/mini/guide-snippet-macro.md
index b6616007..17d8297a 100644
--- a/content/markdown/guides/mini/guide-snippet-macro.md
+++ b/content/markdown/guides/mini/guide-snippet-macro.md
@@ -39,7 +39,7 @@ under the License.
  Following are examples of snippets in various source documents, as well as the corresponding macros in the APT documentation format.
 
 
- See the Doxia [Macros Guide](/doxia/macros/index.html#snippet-macro) for more information and examples.
+ See the Doxia [Macros Guide](/doxia/macros/index.html#Snippet_Macro) for more information and examples.
 
 
 ### Snippets in Sources
diff --git a/content/markdown/guides/mini/guide-using-extensions.md b/content/markdown/guides/mini/guide-using-extensions.md
index 8e499426..cacfd532 100644
--- a/content/markdown/guides/mini/guide-using-extensions.md
+++ b/content/markdown/guides/mini/guide-using-extensions.md
@@ -23,7 +23,7 @@ under the License.
 ## Using Extensions
 
 
- Extensions are a way to add classes to either the [Core Classloader](./guide-maven-classloading.html#core-classloader) (Core Extensions) or the [Project Classloader](./guide-maven-classloading.html#Project_Classloaders) (Build Extensions). This is necessary for adjusting Maven in a way that affects more than just one plug-in.
+ Extensions are a way to add classes to either the [Core Classloader](./guide-maven-classloading.html#Core_Classloader) (Core Extensions) or the [Project Classloader](./guide-maven-classloading.html#Project_Classloaders) (Build Extensions). This is necessary for adjusting Maven in a way that affects more than just one plug-in.
 
 
  The mechanism allows extensions to either replace default [Sisu components](https://www.eclipse.org/sisu/) with custom ones or add new components which are used at run time. In addition one could also expose additional packages from the Core Classloader.
@@ -54,7 +54,7 @@ under the License.
 
 
 
- - Registered via [`project-\>build-\>plugins-\>plugin`](../../pom.html#plugins) with element `extensions` being set to `true`. This is useful for regular plug-ins carrying some extensions.
+ - Registered via [`project-\>build-\>plugins-\>plugin`](../../pom.html#Plugins) with element `extensions` being set to `true`. This is useful for regular plug-ins carrying some extensions.
 
    Example:
 
@@ -82,7 +82,7 @@ under the License.
 ```
 
 
- - Registered as build extension in [`project-\>build-\>extensions-\>extension`](../../pom.html#extensions)
+ - Registered as build extension in [`project-\>build-\>extensions-\>extension`](../../pom.html#Extensions)
 
    Example:
 
diff --git a/content/markdown/issue-management.md b/content/markdown/issue-management.md
index 4b63265a..b804a819 100644
--- a/content/markdown/issue-management.md
+++ b/content/markdown/issue-management.md
@@ -22,7 +22,7 @@ Maven projects use [Jira](https://www.atlassian.com/software/jira) as issue trac
 
 ## Issue Management
 
-Maven is composed of nearly [100 parts](/scm.html#maven-sources-overview), each one having its own Jira project or component:
+Maven is composed of nearly [100 parts](/scm.html#Maven_Sources_Overview), each one having its own Jira project or component:
 **see the [Maven Jira issues overview](https://cwiki.apache.org/confluence/display/MAVEN/Maven+JIRA+issues+overview) to get a summary of open issues**.
 
 Issues, bugs, and feature requests should be submitted to the following
diff --git a/content/markdown/plugin-developers/common-bugs.md b/content/markdown/plugin-developers/common-bugs.md
index 7b5e64d4..63fb6a7b 100644
--- a/content/markdown/plugin-developers/common-bugs.md
+++ b/content/markdown/plugin-developers/common-bugs.md
@@ -28,23 +28,23 @@ under the License.
 
 
 
- - [Reading and Writing Text Files](#reading-and-writing-text-files)
+ - [Reading and Writing Text Files](Reading_and_Writing_Text_Files)
 
- - [Converting between URLs and Filesystem Paths](#converting-between-urls-and-filesystem-paths)
+ - [Converting between URLs and Filesystem Paths](Converting_between_URLs_and_Filesystem_Paths)
 
- - [Handling Strings Case-insensitively](#handling-strings-case-insensitively)
+ - [Handling Strings Case-insensitively](Handling_Strings_Case-insensitively)
 
- - [Creating Resource Bundle Families](#creating-resource-bundle-families)
+ - [Creating Resource Bundle Families](Creating_Resource_Bundle_Families)
 
- - [Using System Properties](#using-system-properties)
+ - [Using System Properties](Using_System_Properties)
 
- - [Using Shutdown Hooks](#using-shutdown-hooks)
+ - [Using Shutdown Hooks](Using_Shutdown_Hooks)
 
- - [Resolving Relative Paths](#resolving-relative-paths)
+ - [Resolving Relative Paths](Resolving_Relative_Paths)
 
- - [Determining the Output Directory for a Site Report](#determining-the-output-directory-for-a-site-report)
+ - [Determining the Output Directory for a Site Report](Determining_the_Output_Directory_for_a_Site_Report)
 
- - [Retrieving the Mojo Logger](#retrieving-the-mojo-logger)
+ - [Retrieving the Mojo Logger](Retrieving_the_Mojo_Logger)
 
 
 ### Reading and Writing Text Files
diff --git a/content/markdown/settings.md b/content/markdown/settings.md
index 9443ac47..1ff140e9 100644
--- a/content/markdown/settings.md
+++ b/content/markdown/settings.md
@@ -17,23 +17,23 @@ KIND, either express or implied.  See the License for the
 specific language governing permissions and limitations
 under the License.
 -->
-1.  [Introduction](#introduction)
-    1.  [Quick Overview](#quick-overview)
+1.  [Introduction](#Introduction)
+    1.  [Quick Overview](#Quick_Overview)
 
-2.  [Settings Details](#dettings-details)
-    1.  [Simple Values](#simple-values)
-    2.  [Plugin Groups](#plugin-groups)
-    3.  [Servers](#servers)
-        1.  [Password Encryption](#password-encryption)
+2.  [Settings Details](#Settings_Details)
+    1.  [Simple Values](#Simple_Values)
+    2.  [Plugin Groups](#Plugin_Groups)
+    3.  [Servers](#Servers)
+        1.  [Password Encryption](#Password_Encryption)
 
-    4.  [Mirrors](#mirrors)
-    5.  [Proxies](#proxies)
-    6.  [Profiles](#profiles)
-        1.  [Activation](#activation)
-        2.  [Repositories](#repositories)
-        3.  [Plugin Repositories](#plugin-repositories)
+    4.  [Mirrors](#Mirrors)
+    5.  [Proxies](#Proxies)
+    6.  [Profiles](#Profiles)
+        1.  [Activation](#Activation)
+        2.  [Repositories](#Repositories)
+        3.  [Plugin Repositories](#Plugin_Repositories)
 
-    7.  [Active Profiles](#active-profiles)
+    7.  [Active Profiles](#Active_Profiles)
 
 ## Introduction
 
@@ -95,7 +95,7 @@ cannot be used for interpolation.
 Half of the top-level `settings` elements are simple values,
 representing a range of values which describe elements of the build
 system that are active full-time.
-```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>${user.home}/.m2/repository</localRepository>
@@ -103,7 +103,7 @@ system that are active full-time.
       <offline>false</offline>
       ...
     </settings>
-```
+
 -   **localRepository**: This value is the path of this build system's
     local repository. The default value is
     `${user.home}/.m2/repository`. This element is especially useful for
@@ -214,7 +214,7 @@ page](./guides/mini/guide-encryption.html)
 -   **id**, **name**: The unique identifier and user-friendly name of
     this mirror. The `id` is used to differentiate between `mirror`
     elements and to pick the corresponding credentials from the
-    [`<servers>`](#servers) section when connecting to the mirror.
+    [`<servers>`](#Servers) section when connecting to the mirror.
 -   **url**: The base URL of this mirror. The build system will use this
     URL to connect to a repository rather than the original repository
     URL.