This is an automated email from the ASF dual-hosted git repository.
jhelou pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git
The following commit(s) were added to refs/heads/master by this push:
new bfc994cdf5 [JAMES-3187] makes customization into partials for each
server
bfc994cdf5 is described below
commit bfc994cdf5a9cf9d60a6377df4f8c02267b09fde
Author: Jean Helou <[email protected]>
AuthorDate: Thu Jan 29 21:18:43 2026 +0100
[JAMES-3187] makes customization into partials for each server
---
docs/antora.yml | 1 -
docs/modules/ROOT/pages/index.adoc | 4 ++--
docs/modules/concepts/pages/user/index.adoc | 2 +-
.../images/customization}/james-hexagons-extensions.png | Bin
docs/modules/servers/nav.adoc | 14 ++++++++++++--
.../servers/pages/distributed/customization/imap.adoc | 5 +++++
.../servers/pages/distributed/customization/index.adoc | 5 +++++
.../pages/distributed/customization/mail-processing.adoc | 5 +++++
.../distributed/customization/mailbox-listeners.adoc | 5 +++++
.../pages/distributed/customization/smtp-hooks.adoc | 5 +++++
.../pages/distributed/customization/webadmin-routes.adoc | 5 +++++
docs/modules/servers/pages/distributed/extending.adoc | 2 +-
docs/modules/servers/pages/distributed/index.adoc | 2 +-
docs/modules/servers/pages/distributed/objectives.adoc | 2 +-
.../servers/pages/extendable/architecture/index.adoc | 4 ++++
.../servers/pages/extendable/configure/domainlist.adoc | 6 ++++++
.../servers/pages/extendable/configure/mailets.adoc | 6 ++++++
.../servers/pages/extendable/configure/matchers.adoc | 7 +++++++
.../configure/remote-delivery-error-handling.adoc | 8 ++++++++
.../servers/pages/extendable/configure/smtp-hooks.adoc | 8 ++++++++
.../servers/pages/extendable/configure/webadmin.adoc | 8 ++++++++
.../servers/pages/extendable/customization/imap.adoc | 5 +++++
.../customization/index.adoc} | 3 ++-
.../pages/extendable/customization/mail-processing.adoc | 5 +++++
.../extendable/customization/mailbox-listeners.adoc | 5 +++++
.../pages/extendable/customization/smtp-hooks.adoc | 5 +++++
.../pages/extendable/customization/webadmin-routes.adoc | 5 +++++
docs/modules/servers/pages/extendable/extending.adoc | 2 +-
docs/modules/servers/pages/extendable/variables.adoc | 4 ++++
.../servers/pages/postgres/customization/imap.adoc | 5 +++++
.../{extending.adoc => customization/index.adoc} | 3 ++-
.../pages/postgres/customization/mail-processing.adoc | 5 +++++
.../pages/postgres/customization/mailbox-listeners.adoc | 5 +++++
.../servers/pages/postgres/customization/smtp-hooks.adoc | 5 +++++
.../pages/postgres/customization/webadmin-routes.adoc | 5 +++++
docs/modules/servers/pages/postgres/extending/index.adoc | 2 --
docs/modules/servers/partials/configure/extensions.adoc | 2 +-
docs/modules/servers/partials/configure/imap.adoc | 2 +-
.../servers/partials/configure/mailetcontainer.adoc | 2 +-
.../servers/partials/configure/mailrepositorystore.adoc | 2 +-
docs/modules/servers/partials/configure/webadmin.adoc | 2 +-
.../pages => servers/partials/customization}/imap.adoc | 5 +----
.../pages => servers/partials/customization}/index.adoc | 15 ++++++---------
.../partials/customization}/mail-processing.adoc | 3 ---
.../partials/customization}/mailbox-listeners.adoc | 5 +----
.../partials/customization}/smtp-hooks.adoc | 5 +----
.../partials/customization}/webadmin-routes.adoc | 5 +----
47 files changed, 169 insertions(+), 47 deletions(-)
diff --git a/docs/antora.yml b/docs/antora.yml
index de95ed3c01..7ce82b62be 100644
--- a/docs/antora.yml
+++ b/docs/antora.yml
@@ -5,6 +5,5 @@ prerelease: SNAPSHOT
nav:
- modules/concepts/nav.adoc
- modules/servers/nav.adoc
-- modules/customization/nav.adoc
- modules/development/nav.adoc
- modules/community/nav.adoc
diff --git a/docs/modules/ROOT/pages/index.adoc
b/docs/modules/ROOT/pages/index.adoc
index c59bc8966c..6997bbf763 100644
--- a/docs/modules/ROOT/pages/index.adoc
+++ b/docs/modules/ROOT/pages/index.adoc
@@ -16,8 +16,8 @@ This Reference Book is divided into the following Parts:
** We provide a few out-of-the-box servers that you can
choose from depending on your needs. Start here if you just
want to get up and running quickly with a working production-grade mail
server.
-* xref:james-project:customization:index.adoc[Customization]
-** Shows how you can customize any James server with the
+* Customization
+** Each server's documentation has a section which shows how you can
customize this James server with the
functionalities that you need.
Check out this section if you have special business or technical
needs and are interested in a custom solution.
diff --git a/docs/modules/concepts/pages/user/index.adoc
b/docs/modules/concepts/pages/user/index.adoc
index dbe63a24c3..82a3765dbc 100644
--- a/docs/modules/concepts/pages/user/index.adoc
+++ b/docs/modules/concepts/pages/user/index.adoc
@@ -51,7 +51,7 @@ Apache James offers Operators a range of servers for various
use cases, includin
An **Integrator** has some expertise with Java or a JVM-based language. Based
on this expertise the Integrator can perform more advanced server
configurations and may
-develop xref:customization:index.adoc[Extensions] to customize the behavior of
a James server.
+develop extensions to customize the behavior of a
xref:servers:index.adoc[James server].
An Integrator does **not** need to download the source code or compile James.
diff --git
a/docs/modules/customization/assets/images/james-hexagons-extensions.png
b/docs/modules/servers/assets/images/customization/james-hexagons-extensions.png
similarity index 100%
rename from
docs/modules/customization/assets/images/james-hexagons-extensions.png
rename to
docs/modules/servers/assets/images/customization/james-hexagons-extensions.png
diff --git a/docs/modules/servers/nav.adoc b/docs/modules/servers/nav.adoc
index ca2d047cb3..b0030e7870 100644
--- a/docs/modules/servers/nav.adoc
+++ b/docs/modules/servers/nav.adoc
@@ -74,7 +74,12 @@
**** xref:distributed/operate/cli.adoc[]
**** xref:distributed/operate/cassandra-migration.adoc[]
**** xref:distributed/operate/security.adoc[]
-*** xref:distributed/extending.adoc[]
+*** xref:distributed/customization/index.adoc[]
+**** xref:distributed/customization/imap.adoc[]
+**** xref:distributed/customization/mail-processing.adoc[]
+**** xref:distributed/customization/mailbox-listeners.adoc[]
+**** xref:distributed/customization/smtp-hooks.adoc[]
+**** xref:distributed/customization/webadmin-routes.adoc[]
*** xref:distributed/benchmark/index.adoc[Performance benchmark]
**** xref:distributed/benchmark/db-benchmark.adoc[]
**** xref:distributed/benchmark/james-benchmark.adoc[]
@@ -126,7 +131,12 @@
**** xref:postgres/operate/migrating.adoc[]
**** xref:postgres/operate/cli.adoc[]
**** xref:postgres/operate/security.adoc[]
-*** xref:postgres/extending/index.adoc[]
+*** xref:postgres/customization/index.adoc[]
+**** xref:postgres/customization/imap.adoc[]
+**** xref:postgres/customization/mail-processing.adoc[]
+**** xref:postgres/customization/mailbox-listeners.adoc[]
+**** xref:postgres/customization/smtp-hooks.adoc[]
+**** xref:postgres/customization/webadmin-routes.adoc[]
*** xref:postgres/benchmark/index.adoc[]
**** xref:postgres/benchmark/db-benchmark.adoc[]
**** xref:postgres/benchmark/james-benchmark.adoc[]
diff --git a/docs/modules/servers/pages/distributed/customization/imap.adoc
b/docs/modules/servers/pages/distributed/customization/imap.adoc
new file mode 100644
index 0000000000..50438bd34f
--- /dev/null
+++ b/docs/modules/servers/pages/distributed/customization/imap.adoc
@@ -0,0 +1,5 @@
+= Custom IMAP processing
+:navtitle: Custom IMAP processing
+:pages-path: distributed
+
+include::partial$customization/imap.adoc[]
\ No newline at end of file
diff --git a/docs/modules/servers/pages/distributed/customization/index.adoc
b/docs/modules/servers/pages/distributed/customization/index.adoc
new file mode 100644
index 0000000000..804a8070ac
--- /dev/null
+++ b/docs/modules/servers/pages/distributed/customization/index.adoc
@@ -0,0 +1,5 @@
+= Distributed James Mail Server — Extending behaviour
+:navtitle: Extending behaviour
+:pages-path: distributed
+
+include::partial$customization/index.adoc[]
diff --git
a/docs/modules/servers/pages/distributed/customization/mail-processing.adoc
b/docs/modules/servers/pages/distributed/customization/mail-processing.adoc
new file mode 100644
index 0000000000..caf28be5fc
--- /dev/null
+++ b/docs/modules/servers/pages/distributed/customization/mail-processing.adoc
@@ -0,0 +1,5 @@
+= Custom mail processing components
+:navtitle: Custom mail processing components
+:pages-path: distributed
+
+include::partial$customization/mail-processing.adoc[]
\ No newline at end of file
diff --git
a/docs/modules/servers/pages/distributed/customization/mailbox-listeners.adoc
b/docs/modules/servers/pages/distributed/customization/mailbox-listeners.adoc
new file mode 100644
index 0000000000..de3d8ffa40
--- /dev/null
+++
b/docs/modules/servers/pages/distributed/customization/mailbox-listeners.adoc
@@ -0,0 +1,5 @@
+= Custom Mailbox Listeners
+:navtitle: Custom Mailbox Listeners
+:pages-path: distributed
+
+include::partial$customization/mailbox-listeners.adoc[]
\ No newline at end of file
diff --git
a/docs/modules/servers/pages/distributed/customization/smtp-hooks.adoc
b/docs/modules/servers/pages/distributed/customization/smtp-hooks.adoc
new file mode 100644
index 0000000000..5b0374475c
--- /dev/null
+++ b/docs/modules/servers/pages/distributed/customization/smtp-hooks.adoc
@@ -0,0 +1,5 @@
+= Custom SMTP hooks
+:navtitle: Custom SMTP hooks
+:pages-path: distributed
+
+include::partial$customization/smtp-hooks.adoc[]
\ No newline at end of file
diff --git
a/docs/modules/servers/pages/distributed/customization/webadmin-routes.adoc
b/docs/modules/servers/pages/distributed/customization/webadmin-routes.adoc
new file mode 100644
index 0000000000..574e0979ba
--- /dev/null
+++ b/docs/modules/servers/pages/distributed/customization/webadmin-routes.adoc
@@ -0,0 +1,5 @@
+= Custom WebAdmin routes
+:navtitle: Custom WebAdmin routes
+:pages-path: distributed
+
+include::partial$customization/webadmin-routes.adoc[]
\ No newline at end of file
diff --git a/docs/modules/servers/pages/distributed/extending.adoc
b/docs/modules/servers/pages/distributed/extending.adoc
index bf94fc0498..abfb68bc34 100644
--- a/docs/modules/servers/pages/distributed/extending.adoc
+++ b/docs/modules/servers/pages/distributed/extending.adoc
@@ -1,4 +1,4 @@
= Distributed James Server — Extending behaviour
:navtitle: Extending behaviour
-This section can be read xref:customization:index.adoc[this page].
+This section can be read xref:distributed/customization/index.adoc[this page].
diff --git a/docs/modules/servers/pages/distributed/index.adoc
b/docs/modules/servers/pages/distributed/index.adoc
index 29607568cf..ec26c1dfd1 100644
--- a/docs/modules/servers/pages/distributed/index.adoc
+++ b/docs/modules/servers/pages/distributed/index.adoc
@@ -22,5 +22,5 @@ In this section of the documentation, we will introduce you
to:
* xref:distributed/run/index.adoc[Run the Distributed Server]
* xref:distributed/configure/index.adoc[Configure the Distributed Server]
* xref:distributed/operate/index.adoc[Operation of the Distributed Server]
-* xref:customization:index.adoc[How to extend the server]
+* xref:distributed/customization/index.adoc[How to extend the server]
diff --git a/docs/modules/servers/pages/distributed/objectives.adoc
b/docs/modules/servers/pages/distributed/objectives.adoc
index 134f5e0a60..db6011a33e 100644
--- a/docs/modules/servers/pages/distributed/objectives.adoc
+++ b/docs/modules/servers/pages/distributed/objectives.adoc
@@ -27,5 +27,5 @@ databases.
Furthermore, this server is intended to be easily customisable so that it can
easily be adapted to ones needs.
* Several packaged extensions can be
xref:distributed/configure/index.adoc#_for_extensions[configured]
-* It is easy to write and load xref:customization:index.adoc[your own
extensions]
+* It is easy to write and load xref:distributed/customization/index.adoc[your
own extensions]
diff --git a/docs/modules/servers/pages/extendable/architecture/index.adoc
b/docs/modules/servers/pages/extendable/architecture/index.adoc
new file mode 100644
index 0000000000..4b2efdf5a3
--- /dev/null
+++ b/docs/modules/servers/pages/extendable/architecture/index.adoc
@@ -0,0 +1,4 @@
+= Extendable James Server — Architecture
+:navtitle: Architecture
+
+TODO
\ No newline at end of file
diff --git a/docs/modules/servers/pages/extendable/configure/domainlist.adoc
b/docs/modules/servers/pages/extendable/configure/domainlist.adoc
new file mode 100644
index 0000000000..cec7712972
--- /dev/null
+++ b/docs/modules/servers/pages/extendable/configure/domainlist.adoc
@@ -0,0 +1,6 @@
+= Extendable James Server — domainlist.xml
+:navtitle: domainlist.xml
+
+:sample-configuration-prefix-url:
https://github.com/apache/james-project/blob/postgresql/server/apps/postgres-app/sample-configuration
+
+include::partial$configure/domainlist.adoc[]
\ No newline at end of file
diff --git a/docs/modules/servers/pages/extendable/configure/mailets.adoc
b/docs/modules/servers/pages/extendable/configure/mailets.adoc
new file mode 100644
index 0000000000..8ffc71fa01
--- /dev/null
+++ b/docs/modules/servers/pages/extendable/configure/mailets.adoc
@@ -0,0 +1,6 @@
+= Extendable James Server — Mailets
+:navtitle: Mailets
+
+:sample-configuration-prefix-url:
https://github.com/apache/james-project/blob/postgresql/server/apps/postgres-app/sample-configuration
+:server-name: Extendable James server
+include::partial$configure/mailets.adoc[]
\ No newline at end of file
diff --git a/docs/modules/servers/pages/extendable/configure/matchers.adoc
b/docs/modules/servers/pages/extendable/configure/matchers.adoc
new file mode 100644
index 0000000000..d324a41250
--- /dev/null
+++ b/docs/modules/servers/pages/extendable/configure/matchers.adoc
@@ -0,0 +1,7 @@
+= Extendable James Server — Matchers
+:navtitle: Matchers
+
+:sample-configuration-prefix-url:
https://github.com/apache/james-project/blob/postgresql/server/apps/postgres-app/sample-configuration
+:pages-path: extendable
+:server-name: Extendable James server
+include::partial$configure/matchers.adoc[]
\ No newline at end of file
diff --git
a/docs/modules/servers/pages/extendable/configure/remote-delivery-error-handling.adoc
b/docs/modules/servers/pages/extendable/configure/remote-delivery-error-handling.adoc
new file mode 100644
index 0000000000..8ef8132481
--- /dev/null
+++
b/docs/modules/servers/pages/extendable/configure/remote-delivery-error-handling.adoc
@@ -0,0 +1,8 @@
+= Extendable James Server — About RemoteDelivery error handling
+:navtitle: About RemoteDelivery error handling
+
+:sample-configuration-prefix-url:
https://github.com/apache/james-project/blob/postgresql/server/apps/postgres-app/sample-configuration
+:pages-path: postgres
+:server-name: Postgresql James server
+:mailet-repository-path-prefix: postgres
+include::partial$configure/remote-delivery-error-handling.adoc[]
\ No newline at end of file
diff --git a/docs/modules/servers/pages/extendable/configure/smtp-hooks.adoc
b/docs/modules/servers/pages/extendable/configure/smtp-hooks.adoc
new file mode 100644
index 0000000000..5988be28cf
--- /dev/null
+++ b/docs/modules/servers/pages/extendable/configure/smtp-hooks.adoc
@@ -0,0 +1,8 @@
+= Extendable James Server — SMTP Hooks
+:navtitle: SMTP Hooks
+
+:sample-configuration-prefix-url:
https://github.com/apache/james-project/blob/postgresql/server/apps/postgres-app/sample-configuration
+:pages-path: extendable
+:server-name: Extendable James server
+
+include::partial$configure/smtp-hooks.adoc[]
\ No newline at end of file
diff --git a/docs/modules/servers/pages/extendable/configure/webadmin.adoc
b/docs/modules/servers/pages/extendable/configure/webadmin.adoc
new file mode 100644
index 0000000000..7e555607a2
--- /dev/null
+++ b/docs/modules/servers/pages/extendable/configure/webadmin.adoc
@@ -0,0 +1,8 @@
+= Extendable James Server — webadmin.properties
+:navtitle: webadmin.properties
+
+:sample-configuration-prefix-url:
https://github.com/apache/james-project/blob/postgresql/server/apps/postgres-app/sample-configuration
+:pages-path: extendable
+:server-name: Extendable James server
+
+include::partial$configure/webadmin.adoc[]
\ No newline at end of file
diff --git a/docs/modules/servers/pages/extendable/customization/imap.adoc
b/docs/modules/servers/pages/extendable/customization/imap.adoc
new file mode 100644
index 0000000000..387aba0a88
--- /dev/null
+++ b/docs/modules/servers/pages/extendable/customization/imap.adoc
@@ -0,0 +1,5 @@
+= Custom IMAP processing
+:navtitle: Custom IMAP processing
+:pages-path: extendable
+
+include::partial$customization/imap.adoc[]
\ No newline at end of file
diff --git a/docs/modules/servers/pages/postgres/extending.adoc
b/docs/modules/servers/pages/extendable/customization/index.adoc
similarity index 56%
copy from docs/modules/servers/pages/postgres/extending.adoc
copy to docs/modules/servers/pages/extendable/customization/index.adoc
index 96f10693b7..c8c190e188 100644
--- a/docs/modules/servers/pages/postgres/extending.adoc
+++ b/docs/modules/servers/pages/extendable/customization/index.adoc
@@ -1,4 +1,5 @@
= Postgres James Mail Server — Extending behaviour
:navtitle: Extending behaviour
+:pages-path: extendable
-This section can be read xref:customization:index.adoc[this page].
+include::partial$customization/index.adoc[]
diff --git
a/docs/modules/servers/pages/extendable/customization/mail-processing.adoc
b/docs/modules/servers/pages/extendable/customization/mail-processing.adoc
new file mode 100644
index 0000000000..85dea6e1fd
--- /dev/null
+++ b/docs/modules/servers/pages/extendable/customization/mail-processing.adoc
@@ -0,0 +1,5 @@
+= Custom mail processing components
+:navtitle: Custom mail processing components
+:pages-path: extendable
+
+include::partial$customization/mail-processing.adoc[]
\ No newline at end of file
diff --git
a/docs/modules/servers/pages/extendable/customization/mailbox-listeners.adoc
b/docs/modules/servers/pages/extendable/customization/mailbox-listeners.adoc
new file mode 100644
index 0000000000..9d4cb62738
--- /dev/null
+++ b/docs/modules/servers/pages/extendable/customization/mailbox-listeners.adoc
@@ -0,0 +1,5 @@
+= Custom Mailbox Listeners
+:navtitle: Custom Mailbox Listeners
+:pages-path: extendable
+
+include::partial$customization/mailbox-listeners.adoc[]
\ No newline at end of file
diff --git
a/docs/modules/servers/pages/extendable/customization/smtp-hooks.adoc
b/docs/modules/servers/pages/extendable/customization/smtp-hooks.adoc
new file mode 100644
index 0000000000..1b84e6e9ba
--- /dev/null
+++ b/docs/modules/servers/pages/extendable/customization/smtp-hooks.adoc
@@ -0,0 +1,5 @@
+= Custom SMTP hooks
+:navtitle: Custom SMTP hooks
+:pages-path: extendable
+
+include::partial$customization/smtp-hooks.adoc[]
\ No newline at end of file
diff --git
a/docs/modules/servers/pages/extendable/customization/webadmin-routes.adoc
b/docs/modules/servers/pages/extendable/customization/webadmin-routes.adoc
new file mode 100644
index 0000000000..94ea4c3239
--- /dev/null
+++ b/docs/modules/servers/pages/extendable/customization/webadmin-routes.adoc
@@ -0,0 +1,5 @@
+= Custom WebAdmin routes
+:navtitle: Custom WebAdmin routes
+:pages-path: extendable
+
+include::partial$customization/webadmin-routes.adoc[]
\ No newline at end of file
diff --git a/docs/modules/servers/pages/extendable/extending.adoc
b/docs/modules/servers/pages/extendable/extending.adoc
index 60665a5298..1a49d1adbf 100644
--- a/docs/modules/servers/pages/extendable/extending.adoc
+++ b/docs/modules/servers/pages/extendable/extending.adoc
@@ -1,4 +1,4 @@
= Extendable James Mail Server — Extending behaviour
:navtitle: Extending behaviour
-This section can be read xref:customization:index.adoc[this page].
+This section can be read xref:extendable/customization/index.adoc[this page].
diff --git a/docs/modules/servers/pages/extendable/variables.adoc
b/docs/modules/servers/pages/extendable/variables.adoc
new file mode 100644
index 0000000000..c768ed2454
--- /dev/null
+++ b/docs/modules/servers/pages/extendable/variables.adoc
@@ -0,0 +1,4 @@
+:sample-configuration-prefix-url:
https://github.com/apache/james-project/blob/postgresql/server/apps/postgres-app/sample-configuration
+:pages-path: postgres
+:server-name: Postgresql James server
+:mailet-repository-path-prefix: postgres
\ No newline at end of file
diff --git a/docs/modules/servers/pages/postgres/customization/imap.adoc
b/docs/modules/servers/pages/postgres/customization/imap.adoc
new file mode 100644
index 0000000000..00f1c9dc1c
--- /dev/null
+++ b/docs/modules/servers/pages/postgres/customization/imap.adoc
@@ -0,0 +1,5 @@
+= Custom IMAP processing
+:navtitle: Custom IMAP processing
+:pages-path: postgres
+
+include::partial$customization/imap.adoc[]
\ No newline at end of file
diff --git a/docs/modules/servers/pages/postgres/extending.adoc
b/docs/modules/servers/pages/postgres/customization/index.adoc
similarity index 57%
rename from docs/modules/servers/pages/postgres/extending.adoc
rename to docs/modules/servers/pages/postgres/customization/index.adoc
index 96f10693b7..8a7c90256c 100644
--- a/docs/modules/servers/pages/postgres/extending.adoc
+++ b/docs/modules/servers/pages/postgres/customization/index.adoc
@@ -1,4 +1,5 @@
= Postgres James Mail Server — Extending behaviour
:navtitle: Extending behaviour
+:pages-path: postgres
-This section can be read xref:customization:index.adoc[this page].
+include::partial$customization/index.adoc[]
diff --git
a/docs/modules/servers/pages/postgres/customization/mail-processing.adoc
b/docs/modules/servers/pages/postgres/customization/mail-processing.adoc
new file mode 100644
index 0000000000..690d84540f
--- /dev/null
+++ b/docs/modules/servers/pages/postgres/customization/mail-processing.adoc
@@ -0,0 +1,5 @@
+= Custom mail processing components
+:navtitle: Custom mail processing components
+:pages-path: postgres
+
+include::partial$customization/mail-processing.adoc[]
\ No newline at end of file
diff --git
a/docs/modules/servers/pages/postgres/customization/mailbox-listeners.adoc
b/docs/modules/servers/pages/postgres/customization/mailbox-listeners.adoc
new file mode 100644
index 0000000000..f55fd11bba
--- /dev/null
+++ b/docs/modules/servers/pages/postgres/customization/mailbox-listeners.adoc
@@ -0,0 +1,5 @@
+= Custom Mailbox Listeners
+:navtitle: Custom Mailbox Listeners
+:pages-path: postgres
+
+include::partial$customization/mailbox-listeners.adoc[]
\ No newline at end of file
diff --git a/docs/modules/servers/pages/postgres/customization/smtp-hooks.adoc
b/docs/modules/servers/pages/postgres/customization/smtp-hooks.adoc
new file mode 100644
index 0000000000..529dcb8ca5
--- /dev/null
+++ b/docs/modules/servers/pages/postgres/customization/smtp-hooks.adoc
@@ -0,0 +1,5 @@
+= Custom SMTP hooks
+:navtitle: Custom SMTP hooks
+:pages-path: postgres
+
+include::partial$customization/smtp-hooks.adoc[]
\ No newline at end of file
diff --git
a/docs/modules/servers/pages/postgres/customization/webadmin-routes.adoc
b/docs/modules/servers/pages/postgres/customization/webadmin-routes.adoc
new file mode 100644
index 0000000000..9d00a1bf91
--- /dev/null
+++ b/docs/modules/servers/pages/postgres/customization/webadmin-routes.adoc
@@ -0,0 +1,5 @@
+= Custom WebAdmin routes
+:navtitle: Custom WebAdmin routes
+:pages-path: postgres
+
+include::partial$customization/webadmin-routes.adoc[]
\ No newline at end of file
diff --git a/docs/modules/servers/pages/postgres/extending/index.adoc
b/docs/modules/servers/pages/postgres/extending/index.adoc
deleted file mode 100644
index c95b2919ad..0000000000
--- a/docs/modules/servers/pages/postgres/extending/index.adoc
+++ /dev/null
@@ -1,2 +0,0 @@
-= Distributed James Postgres Server — Extending server behavior
-:navtitle: Extending server behavior
\ No newline at end of file
diff --git a/docs/modules/servers/partials/configure/extensions.adoc
b/docs/modules/servers/partials/configure/extensions.adoc
index e26adc69ee..5dfc99aa54 100644
--- a/docs/modules/servers/partials/configure/extensions.adoc
+++ b/docs/modules/servers/partials/configure/extensions.adoc
@@ -57,4 +57,4 @@ Recording it in extensions.properties :
guice.extension.tasks=com.project.RspamdTaskExtensionModule
....
-Read
xref:customization:index.adoc#_defining_custom_injections_for_your_extensions[this
page] for more details.
\ No newline at end of file
+Read
xref:{pages-path}/customization/index.adoc#_defining_custom_injections_for_your_extensions[this
page] for more details.
\ No newline at end of file
diff --git a/docs/modules/servers/partials/configure/imap.adoc
b/docs/modules/servers/partials/configure/imap.adoc
index 6654158762..b482fc6d59 100644
--- a/docs/modules/servers/partials/configure/imap.adoc
+++ b/docs/modules/servers/partials/configure/imap.adoc
@@ -249,7 +249,7 @@ they are executed.
== Extending IMAP
-IMAP decoders, processors and encoder can be customized.
xref:customization:imap.adoc[Read more].
+IMAP decoders, processors and encoder can be customized.
xref:{pages-path}/customization/imap.adoc[Read more].
Check this
link:https://github.com/apache/james-project/tree/master/examples/custom-imap[example].
diff --git a/docs/modules/servers/partials/configure/mailetcontainer.adoc
b/docs/modules/servers/partials/configure/mailetcontainer.adoc
index ee83804ec1..ea47d8852d 100644
--- a/docs/modules/servers/partials/configure/mailetcontainer.adoc
+++ b/docs/modules/servers/partials/configure/mailetcontainer.adoc
@@ -7,7 +7,7 @@ xref:{pages-path}/architecture/index.adoc#_mail_processing[the
mailet container
Apache James Server includes a number of
xref:{pages-path}/configure/mailets.adoc[Packaged Mailets] and
xref:{pages-path}/configure/matchers.adoc[Packaged Matchers].
-Furthermore, you can write and use with James
xref:customization:mail-processing.adoc[your own mailet and matchers].
+Furthermore, you can write and use with James
xref:{pages-path}/customization/mail-processing.adoc[your own mailet and
matchers].
Consult this
link:{sample-configuration-prefix-url}/mailetcontainer.xml[example]
to get some examples and hints.
diff --git a/docs/modules/servers/partials/configure/mailrepositorystore.adoc
b/docs/modules/servers/partials/configure/mailrepositorystore.adoc
index 2f3589df67..7e87f9e713 100644
--- a/docs/modules/servers/partials/configure/mailrepositorystore.adoc
+++ b/docs/modules/servers/partials/configure/mailrepositorystore.adoc
@@ -8,7 +8,7 @@ For instance in the url
`{mailet-repository-path-prefix}://var/mail/error/` `{ma
The *mailrepositorystore.xml* file allows registration of available protocols,
and their binding to actual MailRepository
implementation. Note that extension developers can write their own
MailRepository implementations, load them via the
-`extensions-jars` mechanism as documented in
xref:customization:index.adoc['writing your own extensions'], and finally
+`extensions-jars` mechanism as documented in
xref:{pages-path}/customization/index.adoc['writing your own extensions'], and
finally
associated to a protocol in *mailrepositorystore.xml* for a usage in
*mailetcontainer.xml*.
== Configuration
diff --git a/docs/modules/servers/partials/configure/webadmin.adoc
b/docs/modules/servers/partials/configure/webadmin.adoc
index dc429c142a..819691de2d 100644
--- a/docs/modules/servers/partials/configure/webadmin.adoc
+++ b/docs/modules/servers/partials/configure/webadmin.adoc
@@ -88,7 +88,7 @@ Defaults to the `jwt.publickeypem.url` value of
`jmap.properties` file if unspec
| extensions.routes
| List of Routes specified as fully qualified class name that should be loaded
in addition to your product routes list. Routes
needs to be on the classpath or in the ./extensions-jars folder. Read mode
about
-xref:customization:webadmin-routes.adoc[creating you own webadmin routes].
+xref:{pages-path}/customization/webadmin-routes.adoc[creating you own webadmin
routes].
| maxThreadCount
| Maximum threads used by the underlying Jetty server. Optional.
diff --git a/docs/modules/customization/pages/imap.adoc
b/docs/modules/servers/partials/customization/imap.adoc
similarity index 90%
rename from docs/modules/customization/pages/imap.adoc
rename to docs/modules/servers/partials/customization/imap.adoc
index d1fca65070..30633384c5 100644
--- a/docs/modules/customization/pages/imap.adoc
+++ b/docs/modules/servers/partials/customization/imap.adoc
@@ -1,6 +1,3 @@
-= Custom IMAP processing
-:navtitle: Custom IMAP processing
-
James allows defining your own handler packages.
An Imap package is a simple class that bundles IMAP processing components:
@@ -23,7 +20,7 @@ Custom configuration can be obtained through
`ImapConfiguration` class via the `
A full working example is available
link:https://github.com/apache/james-project/tree/master/examples/custom-imap[here].
-See this page for xref:imap.adoc#_extending_imap[more details on configuring
IMAP extensions].
+See this page for xref:{pages-path}/configure/imap.adoc#_extending_imap[more
details on configuring IMAP extensions].
== IMAP additional Connection Checks
diff --git a/docs/modules/customization/pages/index.adoc
b/docs/modules/servers/partials/customization/index.adoc
similarity index 91%
rename from docs/modules/customization/pages/index.adoc
rename to docs/modules/servers/partials/customization/index.adoc
index ba0e77989e..e5c45d79c3 100644
--- a/docs/modules/customization/pages/index.adoc
+++ b/docs/modules/servers/partials/customization/index.adoc
@@ -1,28 +1,25 @@
-= Extending server behavior
-:navtitle: Extending server behavior
-
== Available extension mechanisms
-image::james-hexagons-extensions.png[Extension mechanisms for the James Server]
+image::customization/james-hexagons-extensions.png[Extension mechanisms for
the James Server]
The James Server exposes several interfaces allowing the user to write custom
extensions in
order to extend the James Server behavior.
Writing *Mailets* and *Matchers* allows one to supply custom components for the
-xref:mail-processing.adoc[Mail Processing] and
+xref:{pages-path}/customization/mail-processing.adoc[Mail Processing] and
enables to take decisions, and implement your business logic at the transport
level.
-Writing xref:mailbox-listeners.adoc[Mailbox listeners] enables to
+Writing xref:{pages-path}/customization/mailbox-listeners.adoc[Mailbox
listeners] enables to
react to your user interaction with their mailbox. This powerful tool allows
build advanced features
for mail delivery servers.
-Writing xref:smtp-hooks.adoc[SMTP hookd] enables to
+Writing xref:{pages-path}/customization/smtp-hooks.adoc[SMTP hookd] enables to
add features to your SMTP server.
-Writing xref:webadmin-routes.adoc[WebAdmin routes] enables to
+Writing xref:{pages-path}/customization/webadmin-routes.adoc[WebAdmin routes]
enables to
add features to the WebAdmin REST API.
-Writing xref:imap.adoc[IMAP extensions].
+Writing xref:{pages-path}/customization/imap.adoc[IMAP extensions].
The
link:https://github.com/apache/james-project/tree/master/examples[examples] are
also a good reference.
diff --git a/docs/modules/customization/pages/mail-processing.adoc
b/docs/modules/servers/partials/customization/mail-processing.adoc
similarity index 98%
rename from docs/modules/customization/pages/mail-processing.adoc
rename to docs/modules/servers/partials/customization/mail-processing.adoc
index 0dd0b76340..ff1e4d92b4 100644
--- a/docs/modules/customization/pages/mail-processing.adoc
+++ b/docs/modules/servers/partials/customization/mail-processing.adoc
@@ -1,6 +1,3 @@
-= Custom mail processing components
-:navtitle: Custom mail processing components
-
When none of the matchers and mailets available in James allows us to
implement what we want, extension
developers will have to write our own mailet and matcher in a separated maven
project depending on James
Mailet API.
diff --git a/docs/modules/customization/pages/mailbox-listeners.adoc
b/docs/modules/servers/partials/customization/mailbox-listeners.adoc
similarity index 91%
rename from docs/modules/customization/pages/mailbox-listeners.adoc
rename to docs/modules/servers/partials/customization/mailbox-listeners.adoc
index e23e73e207..cbee01f21a 100644
--- a/docs/modules/customization/pages/mailbox-listeners.adoc
+++ b/docs/modules/servers/partials/customization/mailbox-listeners.adoc
@@ -1,6 +1,3 @@
-= Custom Mailbox Listeners
-:navtitle: Custom Mailbox Listeners
-
== Writing additional listener
An extension writer can write new additional mailbox listeners.
@@ -38,7 +35,7 @@ handled events and can save some IOs.
Your custom additional listener needs to be in the *extensions-jars* folder.
-You need to register its fully qualified class name in
xref:listeners.adoc[listeners.xml]
+You need to register its fully qualified class name in
xref:{pages-path}/customization/[listeners.xml]
== Events
diff --git a/docs/modules/customization/pages/smtp-hooks.adoc
b/docs/modules/servers/partials/customization/smtp-hooks.adoc
similarity index 93%
rename from docs/modules/customization/pages/smtp-hooks.adoc
rename to docs/modules/servers/partials/customization/smtp-hooks.adoc
index e66ab3e56e..8b27377659 100644
--- a/docs/modules/customization/pages/smtp-hooks.adoc
+++ b/docs/modules/servers/partials/customization/smtp-hooks.adoc
@@ -1,6 +1,3 @@
-= Custom SMTP hooks
-:navtitle: Custom SMTP hooks
-
SMTP hooks enable extending capabilities of the SMTP server and are run
synchronously upon email reception, before the email is
enqueued in the MailQueue, and before any mail processing takes place.
@@ -53,7 +50,7 @@ The following interfaces allows interacting with the
following commands:
== Custom hook registration
-Register you hooks using xref:smtp.adoc[*smtpserver.xml*] handlerchain
property.
+Register you hooks using
xref:{pages-path}/configure/smtp.adoc[*smtpserver.xml*] handlerchain property.
== Writing additional SMTP commands
diff --git a/docs/modules/customization/pages/webadmin-routes.adoc
b/docs/modules/servers/partials/customization/webadmin-routes.adoc
similarity index 84%
rename from docs/modules/customization/pages/webadmin-routes.adoc
rename to docs/modules/servers/partials/customization/webadmin-routes.adoc
index e48c659008..057100a71d 100644
--- a/docs/modules/customization/pages/webadmin-routes.adoc
+++ b/docs/modules/servers/partials/customization/webadmin-routes.adoc
@@ -1,6 +1,3 @@
-= Custom WebAdmin routes
-:navtitle: Custom WebAdmin routes
-
== Writing custom WebAdmin routes
An extension writer can write additional WebAdmin routes, effectively exposed
over the WebAdmin API.
@@ -35,5 +32,5 @@ public interface Routes {
Your custom WebAdmin routes needs to be in the *extensions-jars* folder.
-You need to register its fully qualified class name in
xref:webadmin.adoc[webadmin.properties]
+You need to register its fully qualified class name in
xref:{pages-path}/configure/webadmin.adoc[webadmin.properties]
using the *extensions.routes* property.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
