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 e53e1f2c545fc44a68921bc159965771d4a370aa Author: Sylwester Lachiewicz <[email protected]> AuthorDate: Mon Nov 2 07:02:35 2026 +0000 Rework the home page as cards and convert it to Markdown Card titles are paragraphs, not headings: Doxia turns every heading into a section, which would break out of the card markup. The "How to Get Support" and "Apache Software Foundation" headings keep their anchors. --- content/markdown/index.md.vm | 116 +++++++++++++++++++++++++++++++++ content/resources/css/site.css | 141 +++++++++++++++++++++++++++++++++++++---- content/xdoc/index.xml.vm | 137 --------------------------------------- 3 files changed, 246 insertions(+), 148 deletions(-) diff --git a/content/markdown/index.md.vm b/content/markdown/index.md.vm new file mode 100644 index 00000000..27e3553f --- /dev/null +++ b/content/markdown/index.md.vm @@ -0,0 +1,116 @@ +--- +title: Welcome to Apache Maven +author: + - Brett Porter + - Jason van Zyl + - Olivier Lamy +--- + +<!-- + +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, +software distributed under the License is distributed on an +"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +KIND, either express or implied. See the License for the +specific language governing permissions and limitations +under the License. + +--> + +# Welcome to Apache Maven + +<div class="mh-hero"> + <p class="mh-lead">Apache Maven builds, tests and documents Java projects from a single project object model (POM).</p> + <p class="mh-actions"> + <a class="mh-btn mh-btn-primary" href="download.html">Download Maven ${currentStableVersion}</a> + <a class="mh-btn" href="guides/getting-started/maven-in-five-minutes.html">Maven in 5 minutes</a> + <a class="mh-btn" href="what-is-maven.html">What is Maven?</a> + </p> +</div> + +<div class="mh-callout"> + <p><strong>Maven 4 (${current4xVersion})</strong> is on its way. Read <a href="whatsnewinmaven4.html">what's new</a>, <a href="guides/mini/guide-migration-to-mvn4.html">migrate a project</a>, or let the <a href="tools/mvnup.html">Maven Upgrade Tool</a> do the heavy lifting.</p> +</div> + +#[[##]]# Use + +<div class="mh-grid"> + <div class="mh-card"> + <p class="mh-card-title"><a href="run.html">Build a project</a></p> + <p><a href="download.html">Download</a>, <a href="install.html">install</a>, <a href="configure.html">configure</a> and <a href="run.html">run</a> Maven.</p> + </div> + <div class="mh-card"> + <p class="mh-card-title"><a href="plugins/index.html">Plugins</a></p> + <p>The plugins that do the actual work: compile, test, package, deploy and more.</p> + </div> + <div class="mh-card"> + <p class="mh-card-title"><a href="extensions/index.html">Extensions</a></p> + <p>Hook into the build itself: build caches, wagons, custom lifecycle behaviour.</p> + </div> + <div class="mh-card"> + <p class="mh-card-title"><a href="tools/index.html">Tools</a></p> + <p>Maven Daemon, Maven Wrapper, Maven Shell and the Maven Upgrade Tool.</p> + </div> +</div> + +#[[##]]# Extend + +<div class="mh-grid"> + <div class="mh-card"> + <p class="mh-card-title"><a href="plugin-developers/index.html">Write a plugin</a></p> + <p>Package your own build logic as a reusable Maven plugin.</p> + </div> + <div class="mh-card"> + <p class="mh-card-title"><a href="repository/index.html">Publish to Central</a></p> + <p>Get your project and its metadata into the Maven Central Repository, whichever build tool you use.</p> + </div> +</div> + +#[[##]]# Contribute + +<div class="mh-grid"> + <div class="mh-card"> + <p class="mh-card-title"><a href="guides/development/guide-helping.html">Help Maven</a></p> + <p>Answer questions, improve these docs, triage issues. No commit rights needed.</p> + </div> + <div class="mh-card"> + <p class="mh-card-title"><a href="developers/index.html">Develop Maven</a></p> + <p>Conventions, release process and how to work on Maven core and its plugins.</p> + </div> +</div> + +<p class="mh-note">Looking for something specific? The <a href="guides/index.html">documentation index</a> lists every guide, reference page and cookbook example.</p> + +#[[##]]# How to Get Support + +<div class="mh-grid mh-grid-compact"> + <div class="mh-card"> + <p class="mh-card-title">Search first</p> + <p>The <a href="issue-management.html">issue tracker</a>, the <a href="mailing-lists.html">mailing list archives</a> and the <a href="https://cwiki.apache.org/confluence/display/MAVEN">wiki</a> often already have the answer.</p> + </div> + <div class="mh-card"> + <p class="mh-card-title"><a href="mailing-lists.html">Ask on users@</a></p> + <p>The Maven Users mailing list is the main support channel, answered by users and developers alike and archived for the next person.</p> + </div> + <div class="mh-card"> + <p class="mh-card-title"><a href="community.html">Chat on Slack</a></p> + <p>Reach the Maven developers directly in the ASF Slack workspace.</p> + </div> +</div> + +#[[##]]# Apache Software Foundation + +<div class="mh-asf"> + <a href="https://www.apache.org/events/current-event.html"><img src="https://www.apache.org/events/current-event-234x60.png" alt="Apache Events"/></a> + <p>Maven is a project of the <a href="https://www.apache.org/">Apache Software Foundation</a>. Thanks to the <a href="https://www.apache.org/foundation/thanks.html">sponsors</a> who keep it running (<a href="https://www.apache.org/foundation/sponsorship.html">become one</a>). Meet the Maven team at <a href="https://www.apache.org/events/current-event.html">Apache events</a>; ask on the users@ list who is going.</p> +</div> diff --git a/content/resources/css/site.css b/content/resources/css/site.css index 3cdc8665..fc863303 100644 --- a/content/resources/css/site.css +++ b/content/resources/css/site.css @@ -63,24 +63,143 @@ body ul { background-color: #f9f9f9; } -.home-section-heading, -.home-section-links { +/* ---- Home page (index.md.vm) ---- + Plain CSS grid so the layout does not depend on the skin's Bootstrap version. */ + +.mh-hero { + margin: 0.5em 0 1.5em; +} + +.mh-lead { + font-size: 1.35em; + line-height: 1.45; + max-width: 36em; + color: #333; +} + +.mh-actions { + display: flex; + flex-wrap: wrap; + gap: 0.5em; + margin-top: 1em; +} + +a.mh-btn, +a.mh-btn:visited { + display: inline-block; + padding: 0.55em 1.1em; + border: 1px solid #c5c5c5; + border-radius: 4px; + background: #fff; + color: #333; + font-weight: 600; + text-decoration: none; +} + +a.mh-btn:hover, +a.mh-btn:focus { + border-color: #0088cc; + color: #0088cc; + text-decoration: none; +} + +a.mh-btn-primary, +a.mh-btn-primary:visited { + background: #006da3; + border-color: #005a87; + color: #fff; +} + +a.mh-btn-primary:hover, +a.mh-btn-primary:focus { + background: #005a87; + color: #fff; +} + +.mh-callout { + border-left: 4px solid #d6573a; /* Maven feather orange */ + background: #fdf3ef; + padding: 0.75em 1em; + margin: 0 0 2em; +} + +.mh-callout p { + margin: 0; +} + +h2.mh-group { + font-size: 1.1em; + text-transform: uppercase; + letter-spacing: 0.08em; + color: #777; + border-bottom: 1px solid #e5e5e5; + padding-bottom: 0.3em; + margin: 1.8em 0 0.9em; +} + +.mh-grid { + display: grid; + grid-template-columns: repeat(auto-fill, minmax(14em, 1fr)); + gap: 1em; +} + +.mh-card { + border: 1px solid #e5e5e5; + border-radius: 6px; + padding: 0.9em 1em; + background: #fff; + transition: border-color 0.15s, box-shadow 0.15s; +} + +.mh-card:hover { + border-color: #0088cc; + box-shadow: 0 2px 8px rgba(0, 0, 0, 0.06); +} + +.mh-card-title { + font-size: 1.1em; font-weight: bold; - white-space: nowrap; + margin: 0 0 0.35em; + line-height: 1.3; } -.home-section-heading { - font-size: 1.75em; +.mh-card p:not(.mh-card-title) { + margin: 0; + color: #555; +} + +.mh-grid-compact .mh-card { + background: #fafafa; +} + +.mh-note { + margin-top: 1.5em; + color: #555; } -.home-section-links { - font-size: 1.25em; +.mh-asf { + display: flex; + flex-wrap: wrap; + align-items: center; + gap: 1em; + margin-top: 2.5em; + padding-top: 1em; + border-top: 1px solid #e5e5e5; + color: #666; + font-size: 0.95em; +} + +.mh-asf p { + flex: 1 1 20em; + margin: 0; } -/* on a phone the headings wrap instead of running past the edge of the screen */ @media (max-width: 767px) { - .home-section-heading, - .home-section-links { - white-space: normal; + .mh-lead { + font-size: 1.15em; + } + .mh-actions a.mh-btn { + flex: 1 1 100%; + text-align: center; } } diff --git a/content/xdoc/index.xml.vm b/content/xdoc/index.xml.vm deleted file mode 100644 index cb373755..00000000 --- a/content/xdoc/index.xml.vm +++ /dev/null @@ -1,137 +0,0 @@ -<?xml version="1.0"?> -<!-- - -Licensed to the Apache Software Foundation (ASF) under one -or more contributor license agreements. See the NOTICE file -distributed with this work for additional information -regarding copyright ownership. The ASF licenses this file -to you under the Apache License, Version 2.0 (the -"License"); you may not use this file except in compliance -with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - -Unless required by applicable law or agreed to in writing, -software distributed under the License is distributed on an -"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY -KIND, either express or implied. See the License for the -specific language governing permissions and limitations -under the License. - ---> -<document> - <properties> - <title>Welcome to Apache Maven</title> - <author email="[email protected]">Brett Porter</author> - <author email="[email protected]">Jason van Zyl</author> - <author email="[email protected]">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> - This site is separated into the following sections: - </p> - <table> - <tr> - <th class="home-section-heading" rowspan="3">Use</th> - <th class="home-section-links"> - <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 class="home-section-links"> - <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 class="home-section-heading" rowspan="2">Extend</th> - <th class="home-section-links"><a href="plugin-developers/index.html">Write Maven Plugins</a></th> - <th class="home-section-links"><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 class="home-section-heading" rowspan="2">Contribute</th> - <th class="home-section-links"><a href="guides/development/guide-helping.html">Help Maven</a></th> - <th class="home-section-links"><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>
