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 2026/08/09 23:18:55 UTC
(maven-site) branch agent/xdoc-homepage-to-markdown created (now bba9a997)
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a change to branch agent/xdoc-homepage-to-markdown
in repository https://gitbox.apache.org/repos/asf/maven-site.git
at bba9a997 Convert the home page from xdoc to Markdown
This branch includes the following new commits:
new 2317ac0c Rename the home page ahead of converting it
new bba9a997 Convert the home page from xdoc to Markdown
The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
(maven-site) 02/02: Convert the home page from xdoc to Markdown
Posted by sl...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a commit to branch agent/xdoc-homepage-to-markdown
in repository https://gitbox.apache.org/repos/asf/maven-site.git
commit bba9a997e3cac7ec8708a03eae3ff95fe37c0874
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Mon Aug 10 01:16:25 2026 +0200
Convert the home page from xdoc to Markdown
The page used no Velocity at all, so it drops the .vm suffix and becomes
content/markdown/index.md. It still renders to index.html.
The three-by-three layout table is carried over as inline HTML: it leans
on rowspan and on inline styles for the heading cells, neither of which a
Markdown table can express. Doxia parses the block back into the same
table events the xdoc parser produced and re-emits it with the same
attributes, so the layout is untouched.
The Apache Events banner has to sit on the same line as the sentence that
follows it. On a line of its own the anchor tag opens a raw HTML block,
which then swallows the rest of the paragraph and leaves two Markdown
links unparsed on the page.
Verified by rendering the site before and after. All three anchor ids on
the page -- Welcome_to_Apache_Maven, How_to_Get_Support and
Apache_Software_Foundation -- are unchanged, as are the title, the author
metadata, the visible text and every link target. So is every one of the
other 264 pages of the site. The generated markup differs only in
whitespace, in a <tbody> that Doxia now emits around the table, and in two
pairs of quotation marks that Markdown renders curly.
Generated-by: Claude Opus 5 (1M context)
---
content/markdown/index.md | 221 +++++++++++++++++++++-------------------------
1 file changed, 102 insertions(+), 119 deletions(-)
diff --git a/content/markdown/index.md b/content/markdown/index.md
index d60e3e47..79b4555f 100644
--- a/content/markdown/index.md
+++ b/content/markdown/index.md
@@ -1,4 +1,11 @@
-<?xml version="1.0"?>
+---
+title: Welcome to Apache Maven
+author:
+ - Brett Porter
+ - Jason van Zyl
+ - Olivier Lamy
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
@@ -19,121 +26,97 @@ specific language governing permissions and limitations
under the License.
-->
-<document>
- <properties>
- <title>Welcome to Apache Maven</title>
- <author email="brett@apache.org">Brett Porter</author>
- <author email="jason@takari.io">Jason van Zyl</author>
- <author email="olamy@apache.org">Olivier Lamy</author>
- </properties>
- <body>
-
- <section name="Welcome to Apache Maven">
- <p>
- Apache Maven is a build tool for Java projects. Using a project object model
- (POM), Maven manages a project's compilation, testing, and documentation.
- </p>
- <p>
- You can find more information in the "About Maven"
- section of the sidebar. This includes an in-depth description of <a href="what-is-maven.html">what Maven is</a> and a list of some of its main features.
- </p>
- <p>
- <!-- TODO: this could be the big button type thing instead of a list of links -->
- This site is separated into the following sections:
- </p>
- <!-- TODO: use CSS -->
- <table>
- <tr>
- <th style="white-space:nowrap; font-weight: bold; font-size: 1.75em" rowspan="3">Use</th>
- <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em">
- <a href="download.html">Download</a>, <a href="install.html">Install</a>, <a href="configure.html">Configure</a>, <a href="run.html">Run</a> Maven
- </th>
- <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em">
- <a href="plugins/index.html">Maven Plugins</a> and <a href="extensions/index.html">Maven Extensions</a>
- </th>
- </tr>
- <tr>
- <td>Information for those needing to build a project that uses Maven</td>
- <td>
- Lists of plugins and extensions to help with your builds.
- </td>
- </tr>
- <tr>
- <td><b>Maven 4</b>: Learn <a href="whatsnewinmaven4.html">what's new</a> and <a href="/guides/mini/guide-migration-to-mvn4.html">how to migrate a project</a> to Maven 4. The <a href="/tools/mvnup.html">Maven Upgrade Tool</a> provides upgrade support.</td>
- <td>
- Upcoming: How to migrate plugins to the new Maven 4 API?
- </td>
- </tr>
- <tr>
- <th style="white-space:nowrap; font-weight: bold; font-size: 1.75em" rowspan="2">Extend</th>
- <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em"><a href="plugin-developers/index.html">Write Maven Plugins</a></th>
- <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em"><a href="repository/index.html">Improve the Maven Central Repository</a></th>
- </tr>
- <tr>
- <td>
- Information for developers writing Maven plugins.
- </td>
- <td>
- Information for those who may or may not use Maven, but are interested in getting project metadata into the
- <a href="repository/index.html">central repository</a>.
- </td>
- </tr>
- <tr>
- <th style="white-space:nowrap; font-weight: bold; font-size: 1.75em" rowspan="2">Contribute</th>
- <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em"><a href="guides/development/guide-helping.html">Help Maven</a></th>
- <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em"><a href="developers/index.html">Develop Maven</a></th>
- </tr>
- <tr>
- <td>
- Information if you'd like to get involved. Maven is an open source community and welcomes contributions.
- </td>
- <td>
- Information for those who are currently Maven developers, or who are interested
- in contributing to the Maven project itself.
- </td>
- </tr>
- </table>
- <p>
- Each guide is divided into a number of trails to get you started on a particular topic, and includes a
- reference area and a "cookbook" of common examples.
- </p>
- <p>
- You can access the guides at any time from the left navigation.
- If you are looking for a quick reference, you can use the <a href="guides/index.html">documentation index</a>.
- </p>
-
- <h3>How to Get Support</h3>
- <p>
- Support for Maven is available in a variety of different forms.
- </p>
- <p>
- To get started, search the documentation,
- <a href="issue-management.html">issue management system</a>, the <a href="https://cwiki.apache.org/confluence/display/MAVEN">wiki</a>,
- or the <a href="mailing-lists.html">mailing list archives</a> to
- see if the problem has been solved or reported before.
- </p>
- <p>
- If the problem has not been reported before, the recommended way to get help is to
- subscribe to the <a href="mailing-lists.html">Maven Users Mailing list</a>. Many other users and Maven developers
- will answer your questions there, and the answer will be archived for others in the future.
- </p>
- <p>
- You can also reach the Maven developers on <a href="community.html">Slack</a>.
- </p>
-
- <h3>Apache Software Foundation</h3>
- <p>
- Maven is a part of the Apache Software Foundation. We'd like to <a href="https://www.apache.org/foundation/thanks.html">thank
- the sponsors</a> that provide financial assistance to the foundation. For more information on how you can support the
- foundation, see the <a href="https://www.apache.org/foundation/sponsorship.html">sponsorship</a> page.
- </p>
- <p>
- <a href="https://www.apache.org/events/current-event.html">
- <img src="https://www.apache.org/events/current-event-234x60.png" alt="Apache Events" style="float: left"/>
- </a>
- You can also attend <a href="https://www.apache.org/events/current-event.html">Apache Events</a>. Ask on the <a href="mailing-lists.html">Maven User mailing list</a>
- if Maven team members will be there. It can be a great opportunity to meet them.
- </p>
- </section>
- </body>
-</document>
+
+# Welcome to Apache Maven
+
+Apache Maven is a build tool for Java projects. Using a project object model
+(POM), Maven manages a project's compilation, testing, and documentation.
+
+You can find more information in the "About Maven"
+section of the sidebar. This includes an in-depth description of [what Maven is](what-is-maven.html) and a list of some of its main features.
+
+<!-- TODO: this could be the big button type thing instead of a list of links -->
+This site is separated into the following sections:
+
+<!-- TODO: use CSS -->
+<table>
+ <tr>
+ <th style="white-space:nowrap; font-weight: bold; font-size: 1.75em" rowspan="3">Use</th>
+ <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em">
+ <a href="download.html">Download</a>, <a href="install.html">Install</a>, <a href="configure.html">Configure</a>, <a href="run.html">Run</a> Maven
+ </th>
+ <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em">
+ <a href="plugins/index.html">Maven Plugins</a> and <a href="extensions/index.html">Maven Extensions</a>
+ </th>
+ </tr>
+ <tr>
+ <td>Information for those needing to build a project that uses Maven</td>
+ <td>
+ Lists of plugins and extensions to help with your builds.
+ </td>
+ </tr>
+ <tr>
+ <td><b>Maven 4</b>: Learn <a href="whatsnewinmaven4.html">what's new</a> and <a href="/guides/mini/guide-migration-to-mvn4.html">how to migrate a project</a> to Maven 4. The <a href="/tools/mvnup.html">Maven Upgrade Tool</a> provides upgrade support.</td>
+ <td>
+ Upcoming: How to migrate plugins to the new Maven 4 API?
+ </td>
+ </tr>
+ <tr>
+ <th style="white-space:nowrap; font-weight: bold; font-size: 1.75em" rowspan="2">Extend</th>
+ <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em"><a href="plugin-developers/index.html">Write Maven Plugins</a></th>
+ <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em"><a href="repository/index.html">Improve the Maven Central Repository</a></th>
+ </tr>
+ <tr>
+ <td>
+ Information for developers writing Maven plugins.
+ </td>
+ <td>
+ Information for those who may or may not use Maven, but are interested in getting project metadata into the
+ <a href="repository/index.html">central repository</a>.
+ </td>
+ </tr>
+ <tr>
+ <th style="white-space:nowrap; font-weight: bold; font-size: 1.75em" rowspan="2">Contribute</th>
+ <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em"><a href="guides/development/guide-helping.html">Help Maven</a></th>
+ <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em"><a href="developers/index.html">Develop Maven</a></th>
+ </tr>
+ <tr>
+ <td>
+ Information if you'd like to get involved. Maven is an open source community and welcomes contributions.
+ </td>
+ <td>
+ Information for those who are currently Maven developers, or who are interested
+ in contributing to the Maven project itself.
+ </td>
+ </tr>
+</table>
+
+Each guide is divided into a number of trails to get you started on a particular topic, and includes a
+reference area and a "cookbook" of common examples.
+
+You can access the guides at any time from the left navigation.
+If you are looking for a quick reference, you can use the [documentation index](guides/index.html).
+
+### How to Get Support
+
+Support for Maven is available in a variety of different forms.
+
+To get started, search the documentation,
+[issue management system](issue-management.html), the [wiki](https://cwiki.apache.org/confluence/display/MAVEN),
+or the [mailing list archives](mailing-lists.html) to
+see if the problem has been solved or reported before.
+
+If the problem has not been reported before, the recommended way to get help is to
+subscribe to the [Maven Users Mailing list](mailing-lists.html). Many other users and Maven developers
+will answer your questions there, and the answer will be archived for others in the future.
+
+You can also reach the Maven developers on [Slack](community.html).
+
+### Apache Software Foundation
+
+Maven is a part of the Apache Software Foundation. We'd like to [thank
+the sponsors](https://www.apache.org/foundation/thanks.html) that provide financial assistance to the foundation. For more information on how you can support the
+foundation, see the [sponsorship](https://www.apache.org/foundation/sponsorship.html) page.
+
+<a href="https://www.apache.org/events/current-event.html"> <img src="https://www.apache.org/events/current-event-234x60.png" alt="Apache Events" style="float: left"/> </a> You can also attend [Apache Events](https://www.apache.org/events/current-event.html). Ask on the [Maven User mailing list](mailing-lists.html)
+if Maven team members will be there. It can be a great opportunity to meet them.
(maven-site) 01/02: Rename the home page ahead of converting it
Posted by sl...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a commit to branch agent/xdoc-homepage-to-markdown
in repository https://gitbox.apache.org/repos/asf/maven-site.git
commit 2317ac0c54933bc00fdbf111c53cabfdd48b8da3
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Mon Aug 10 01:16:25 2026 +0200
Rename the home page ahead of converting it
Git's rename detection is similarity-based, so a rename and a rewrite in
one commit is recorded as a delete plus an add and git log --follow stops
there. Please merge or rebase rather than squash.
Generated-by: Claude Opus 5 (1M context)
---
content/{xdoc/index.xml.vm => markdown/index.md} | 0
1 file changed, 0 insertions(+), 0 deletions(-)
diff --git a/content/xdoc/index.xml.vm b/content/markdown/index.md
similarity index 100%
rename from content/xdoc/index.xml.vm
rename to content/markdown/index.md