This is an automated email from the ASF dual-hosted git repository. chibenwa pushed a commit to branch staging in repository https://gitbox.apache.org/repos/asf/james-site.git
commit 2e06e3df514dca8b65a29c3722c478c0cabb4427 Author: Benoit TELLIER <[email protected]> AuthorDate: Thu Aug 27 11:45:36 2026 +0700 Rearrange site page: default landing page, relocate pages --- doc-sites/antora-playbook-local.yml | 3 + doc-sites/ui-overrides/partials/header-content.hbs | 3 +- docs/antora.yml | 1 + docs/modules/ROOT/nav.adoc | 2 +- .../ROOT/pages/{index.adoc => community.adoc} | 0 docs/modules/ROOT/pages/homepage.adoc | 77 +++++++++++++++++++++- 6 files changed, 82 insertions(+), 4 deletions(-) diff --git a/doc-sites/antora-playbook-local.yml b/doc-sites/antora-playbook-local.yml index 0d0bbea00..fadf63b6c 100644 --- a/doc-sites/antora-playbook-local.yml +++ b/doc-sites/antora-playbook-local.yml @@ -11,6 +11,9 @@ content: - url: ./../../james-project branches: HEAD start_path: docs + - url: ./../../james-project + branches: HEAD + start_path: server/apps/distributed-app/docs - url: ./../../james-mime4j branches: HEAD start_path: docs diff --git a/doc-sites/ui-overrides/partials/header-content.hbs b/doc-sites/ui-overrides/partials/header-content.hbs index 186c0382f..6e4fd84bf 100644 --- a/doc-sites/ui-overrides/partials/header-content.hbs +++ b/doc-sites/ui-overrides/partials/header-content.hbs @@ -28,8 +28,9 @@ </div> </div> <div class="navbar-item has-dropdown is-hoverable"> - {{#with site.components.[james-site]}}<a class="navbar-link" href="{{{relativize latest.url}}}">Community</a>{{else}}<a class="navbar-link" href="#">Community</a>{{/with}} + <a class="navbar-link" href="{{{siteRootPath}}}/james-site/latest/community.html">Community</a> <div class="navbar-dropdown"> + <a class="navbar-item" href="{{{siteRootPath}}}/james-site/latest/community.html">Join the community</a> <a class="navbar-item" href="{{{siteRootPath}}}/james-site/latest/mailing-lists.html">Mailing lists</a> <a class="navbar-item" href="{{{siteRootPath}}}/james-site/latest/contributing.html">Contributing</a> <a class="navbar-item" href="https://gitter.im/apache/james-project";><svg version="1.1" xmlns="http://www.w3.org/2000/svg"; xmlns:xlink="http://www.w3.org/1999/xlink"; viewBox="0 0 32 32" class="logo-gitter-sign" data-v-44ebcb1a=""><rect x="15" y="5" width="2" height="10"></rect> <rect x="10" y="5" width="2" height="20"></rect> <rect x="5" y="5" width="2" height="20"></rect> <rect width="2" height="15"></rect></svg> Gitter</a> diff --git a/docs/antora.yml b/docs/antora.yml index 8698c95b4..17ab464ad 100644 --- a/docs/antora.yml +++ b/docs/antora.yml @@ -2,5 +2,6 @@ name: james-site title: Apache James Site version: 'latest' prerelease: true +start_page: ROOT:homepage.adoc nav: - modules/ROOT/nav.adoc diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc index 682c37f61..2209a5051 100644 --- a/docs/modules/ROOT/nav.adoc +++ b/docs/modules/ROOT/nav.adoc @@ -1,5 +1,5 @@ * xref:homepage.adoc[] -* xref:index.adoc[] +* xref:community.adoc[] ** xref:mailing-lists.adoc[] ** xref:contributing.adoc[] ** xref:guidelines.adoc[] diff --git a/docs/modules/ROOT/pages/index.adoc b/docs/modules/ROOT/pages/community.adoc similarity index 100% rename from docs/modules/ROOT/pages/index.adoc rename to docs/modules/ROOT/pages/community.adoc diff --git a/docs/modules/ROOT/pages/homepage.adoc b/docs/modules/ROOT/pages/homepage.adoc index b8c5a272a..7e886fc69 100644 --- a/docs/modules/ROOT/pages/homepage.adoc +++ b/docs/modules/ROOT/pages/homepage.adoc @@ -1,4 +1,77 @@ -= Welcome to Apache James Project += Apache James +:navtitle: Home +*Emails at the heart of your business logic.* -This is a work in progress. +Apache James, a.k.a. *Java Apache Mail Enterprise Server*, is a modular, 100% JVM (Java and Scala) +email server and a set of email related libraries. It provides a complete, stable, secure and +extendable mail server, and lets you assemble the components you need to build the email solution +your business requires. + +James is not only a server you deploy: it is also a *toolkit*. Its Mailet container lets you filter, +route and transform emails with your own business logic, and its libraries can be reused +independently in any JVM application. + +== The James server + +The James server implements the standard email protocols - *SMTP*, *LMTP*, *POP3*, *IMAP*, +*ManageSieve* and *JMAP* - on top of pluggable storage APIs (mailbox, search, users) with +implementations backed by Cassandra, PostgreSQL, OpenSearch, JPA databases or the file system. +It can be operated through JMX, a REST administration API and a command line client. + +James can act as a Mail Transfer Agent (MTA) over SMTP, as a Mail Delivery Agent (MDA) exposing +IMAP and JMAP to your users, or as both. + +* xref:james-project::index.adoc[*James server documentation*] - installation, configuration, +concepts, customization and development guides. +* xref:james-distributed-app::index.adoc[*Distributed server*] - the horizontally scalable +flavour of James, backed by Cassandra, OpenSearch and object storage. +* xref:download.adoc[Download] the latest release, or start from the Docker images. + +== Email libraries + +The James project also maintains a set of standalone libraries, each solving one email problem well: + +[cols="1,3,1"] +|=== +|Project |Description |Documentation + +|*Mime4J* +|A parser and a builder for e-mail message streams, in plain RFC-822 and MIME formats. +|xref:mime4j::index.adoc[Read the docs] + +|*jSieve* +|An implementation of the Sieve mail filtering language (RFC 5228) and its extensions. +|xref:jsieve::index.adoc[Read the docs] + +|*jSPF* +|An implementation of the Sender Policy Framework (RFC 7208), to check that a sender is allowed +to send mail for a domain. +|xref:jspf::index.adoc[Read the docs] + +|*jDKIM* +|An implementation of DomainKeys Identified Mail (RFC 6376), to sign and verify emails. +|xref:jdkim::index.adoc[Read the docs] + +|*HUPA* +|A rich IMAP-based webmail application written in GWT. +|https://james.apache.org/hupa/index.html[Read the docs] +|=== + +== Getting started + +. xref:download.adoc[Download] an official binary release, or pull one of the Docker images. +. Follow the xref:james-project::index.adoc[server documentation] to configure your domains, +users and protocols. +. Need a hand? Reach out to the xref:community.adoc[community], or have a look at the +xref:support.adoc[companies providing professional support]. + +== Join the community + +Apache James is an Open Source, all-volunteer project of the +https://www.apache.org/[Apache Software Foundation]. It draws its strength from its community of +developers and users, and *all are welcome*. + +Have a look at xref:community.adoc[how to join the community], subscribe to the +xref:mailing-lists.adoc[mailing lists], and read the xref:contributing.adoc[contributing guide] +to submit your first patch. We also describe the xref:persona.adoc[people we build James for]. --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
