This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/sling-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 3abdb3ae9 Automatic website deployment from
https://ci-builds.apache.org/job/Sling/job/modules/job/sling-site/job/master/1009/
3abdb3ae9 is described below
commit 3abdb3ae9644d2486b1299d4aa662ef685b2bdd8
Author: jenkins <[email protected]>
AuthorDate: Fri Jan 31 12:11:15 2025 +0000
Automatic website deployment from
https://ci-builds.apache.org/job/Sling/job/modules/job/sling-site/job/master/1009/
---
.../mappings-for-resource-resolution.html | 11 ++++++-----
pagefind/fragment/en_91cfc62.pf_fragment | Bin 0 -> 8364 bytes
pagefind/fragment/en_b640a44.pf_fragment | Bin 8336 -> 0 bytes
pagefind/index/en_17a03d9.pf_index | Bin 40202 -> 0 bytes
pagefind/index/en_1bc7bb5.pf_index | Bin 39260 -> 0 bytes
pagefind/index/en_1f9b49d.pf_index | Bin 38435 -> 0 bytes
pagefind/index/en_258f182.pf_index | Bin 40067 -> 0 bytes
pagefind/index/en_25a6d48.pf_index | Bin 42156 -> 0 bytes
pagefind/index/en_27bb639.pf_index | Bin 38893 -> 0 bytes
pagefind/index/en_297d154.pf_index | Bin 0 -> 40093 bytes
pagefind/index/en_2e77bfd.pf_index | Bin 40159 -> 0 bytes
pagefind/index/en_31f2c2f.pf_index | Bin 40369 -> 0 bytes
pagefind/index/en_3b9cae4.pf_index | Bin 0 -> 42149 bytes
pagefind/index/en_3ee9cbc.pf_index | Bin 40270 -> 0 bytes
pagefind/index/en_4a7ec25.pf_index | Bin 0 -> 45233 bytes
pagefind/index/en_79a178e.pf_index | Bin 0 -> 41865 bytes
pagefind/index/en_7edf535.pf_index | Bin 0 -> 40398 bytes
pagefind/index/en_7f1ee42.pf_index | Bin 42499 -> 0 bytes
pagefind/index/en_845ebb2.pf_index | Bin 0 -> 37446 bytes
pagefind/index/en_84d7a65.pf_index | Bin 37435 -> 0 bytes
pagefind/index/en_8dea22e.pf_index | Bin 35531 -> 0 bytes
pagefind/index/en_a835a44.pf_index | Bin 38991 -> 0 bytes
pagefind/index/en_a967ad4.pf_index | Bin 0 -> 39232 bytes
pagefind/index/en_b0445fb.pf_index | Bin 0 -> 34771 bytes
pagefind/index/en_b49d55f.pf_index | Bin 0 -> 35533 bytes
pagefind/index/en_b6d7355.pf_index | Bin 0 -> 38410 bytes
pagefind/index/en_c2f4f1c.pf_index | Bin 45223 -> 0 bytes
pagefind/index/en_c3274a7.pf_index | Bin 0 -> 42492 bytes
pagefind/index/en_c8dbca5.pf_index | Bin 34758 -> 0 bytes
pagefind/index/en_cbd35b5.pf_index | Bin 0 -> 40192 bytes
pagefind/index/en_ce597d8.pf_index | Bin 0 -> 38453 bytes
pagefind/index/en_cfb67c4.pf_index | Bin 41858 -> 0 bytes
pagefind/index/en_d1b4390.pf_index | Bin 38459 -> 0 bytes
pagefind/index/en_df4e586.pf_index | Bin 0 -> 38917 bytes
pagefind/index/en_e07f657.pf_index | Bin 0 -> 38998 bytes
pagefind/index/en_e83d703.pf_index | Bin 0 -> 40164 bytes
pagefind/index/en_e96f3f1.pf_index | Bin 0 -> 40277 bytes
pagefind/index/en_eed5baa.pf_index | Bin 39212 -> 0 bytes
pagefind/index/en_f823e3f.pf_index | Bin 0 -> 39203 bytes
pagefind/pagefind-entry.json | 2 +-
pagefind/pagefind.en_be1c834885.pf_meta | Bin 0 -> 1832 bytes
pagefind/pagefind.en_c4516cfc41.pf_meta | Bin 1833 -> 0 bytes
sitemap.xml | 4 ++--
43 files changed, 9 insertions(+), 8 deletions(-)
diff --git
a/documentation/the-sling-engine/mappings-for-resource-resolution.html
b/documentation/the-sling-engine/mappings-for-resource-resolution.html
index 1386e831d..2bcb1853d 100644
--- a/documentation/the-sling-engine/mappings-for-resource-resolution.html
+++ b/documentation/the-sling-engine/mappings-for-resource-resolution.html
@@ -350,10 +350,11 @@ for (String segment: segments) {
<p>The String Interpolation works with any part of the etc-map tree.</p>
<h2><a href="#alias-configurations" id="alias-configurations">Alias
Configurations</a></h2>
<p>The property <code>sling:alias</code> may be set on any resource to
indicate an alias name for the resource. For example the resource
<code>/content/visitors</code> may have the <code>sling:alias</code> property
set to <code>besucher</code> allowing the resource to be addressed in an URL as
<code>/content/besucher</code> as well as the original path
<code>/content/visitors</code>. The property <code>sling:alias</code> may have
multiple values. The first value is used for outgoing mapp [...]
+<p>Aliases are roughly similar to POSIX hard links, restricted to simple names
(no paths).</p>
<p>The following characters are not allowed in <code>sling:alias</code>
values: <code>/?#</code>. Using any of those characters somewhere in the value
makes Sling disregard the alias mapping. In addition the aliases
<code>.</code>, <code>..</code> and the empty string are invalid. Invalid
aliases are logged with WARN level.</p>
<h3><a href="#impact-of-alias-handling" id="impact-of-alias-handling">Impact
of Alias Handling</a></h3>
<p>In general, the number of aliases have a direct impact on the performance
of the resource resolution - as basically all possible permutations of paths
for a resource have to be tested against the incoming request path. By default
a cache is used to speed up handling aliases during resolving resources. It is
highly recommended to have this cache enabled to avoid slowing down request
performance. However, the cache might have an impact on startup time and on the
alias update time if the [...]
-<p>The cache can be disabled by setting the property
<code>resource.resolver.optimize.alias.resolution</code> of the OSGi
configuration
<code>org.apache.sling.jcr.resource.internal.JcrResourceResolverFactoryImpl</code>
to <code>false</code>.</p>
+<p>The cache can be disabled by setting the property
<code>resource.resolver.optimize.alias.resolution</code> of the OSGi
configuration
<code>org.apache.sling.jcr.resource.internal.JcrResourceResolverFactoryImpl</code>
to <code>false</code>. Note that this is not recommended because of the
aforementioned performance issues and also minor differences in behavior (see
<a
href="https://issues.apache.org/jira/browse/SLING-12025";>SLING-12025</a>).</p>
<h3><a href="#limitation-of-slingalias-for-principal-with-a-limited-access"
id="limitation-of-slingalias-for-principal-with-a-limited-access">Limitation of
<code>sling:alias</code> for Principal with a limited access</a></h3>
<p>Assuming there is</p>
<ul>
@@ -366,13 +367,13 @@ for (String segment: segments) {
<p>While an alias can provide a variation for a resource name, a vanity path
can provide an alternative path for a resource. The following properties can be
set on a resource:</p>
<ul>
<li><code>sling:vanityPath</code> – This property when set on any resource
defines an alternative path to address the resource.</li>
-<li><code>sling:redirect</code> – This boolean property when set to
<code>true</code> on a resource with a vanity path causes a redirect response
to be sent to the client, which causes the client to send in a new request with
the modified location. The value of the <code>sling:vanityPath</code> property
is applied to the actual request and sent back as the value of the
<code>Location</code> response header field.</li>
+<li><code>sling:redirect</code> – This boolean property when set to
<code>true</code> on a resource with a vanity path causes an HTTP redirect
response to be sent to the client, which causes the client to send in a new
request with the modified location. The value of the
<code>sling:vanityPath</code> property is applied to the actual request and
sent back as the value of the <code>Location</code> response header field.</li>
<li><code>sling:redirectStatus</code> – This property defines the HTTP status
code sent to the client with the <code>sling:redirect</code> response. If this
property is not set, it defaults to 302 (Found). Other status codes supported
are 300 (Multiple Choices), 301 (Moved Permanently), 303 (See Other), 307
(Temporary Redirect), and 308 (Permanent Redirect).</li>
<li><code>sling:vanityOrder</code> – It might happen that several resources in
the resource tree specify the same vanity path. In that case the one with the
highest order is used. This property can be used to set such an order.</li>
</ul>
+<p>Vanity Paths are similar to symbolic links in POSIX systems.</p>
<h3><a href="#rebuilding-the-vanity-bloom-filter"
id="rebuilding-the-vanity-bloom-filter">Rebuilding The Vanity Bloom
Filter</a></h3>
-<p><a href="https://issues.apache.org/jira/browse/SLING-4216";>SLING-4216</a>
introduced the usage of a bloom filter in order to resolve long startup time
with many vanityPath entries. The bloom filter is handled automatically by the
Sling framework. In some cases though, as changing the maximum number of vanity
bloom filter bytes, a rebuild of the vanity bloom filter is needed.</p>
-<p>In order to rebuild vanity bloom filter you need to stop and restart Apache
Sling (this might take few minutes, depending on how many vanity path entries
are present)</p>
+<p><a href="https://issues.apache.org/jira/browse/SLING-4216";>SLING-4216</a>
introduced the usage of a bloom filter in order to resolve long startup time
with many vanityPath entries. The bloom filter is handled automatically by the
Sling framework.</p>
<h2><a href="#interactions-between-mappings-and-authentication-requirements"
id="interactions-between-mappings-and-authentication-requirements">Interactions
between mappings and authentication requirements</a></h2>
<p>The <a href="/documentation/the-sling-engine/authentication.html">Sling
authentication</a> mechanism works by registering authentication requirements
for paths which are protected. Normally these authentication requirements
transparently apply to child resources as well due to the hierarchical nature
of the paths used.</p>
<p>Additional mappings complicate the situation, therefore additional
authentication requirements are automatically registered by Sling. For
instance, assuming the following repository structure:</p>
@@ -422,7 +423,7 @@ for (String segment: segments) {
content/documentation/the-sling-engine/mappings-for-resource-resolution.md
</a>
</div> <div class="revisionInfo">
- Last modified by <span class="author">Julian
Reschke</span> on <span class="comment">2024-09-02</span>
+ Last modified by <span class="author">Julian
Reschke</span> on <span class="comment">2025-01-31</span>
</div><p>
Apache Sling, Sling, Apache, the Apache feather logo,
and the Apache Sling project
logo are trademarks of The Apache Software Foundation. All other marks
mentioned
diff --git a/pagefind/fragment/en_91cfc62.pf_fragment
b/pagefind/fragment/en_91cfc62.pf_fragment
new file mode 100644
index 000000000..40b40b771
Binary files /dev/null and b/pagefind/fragment/en_91cfc62.pf_fragment differ
diff --git a/pagefind/fragment/en_b640a44.pf_fragment
b/pagefind/fragment/en_b640a44.pf_fragment
deleted file mode 100644
index b075019f0..000000000
Binary files a/pagefind/fragment/en_b640a44.pf_fragment and /dev/null differ
diff --git a/pagefind/index/en_17a03d9.pf_index
b/pagefind/index/en_17a03d9.pf_index
deleted file mode 100644
index f1be18f81..000000000
Binary files a/pagefind/index/en_17a03d9.pf_index and /dev/null differ
diff --git a/pagefind/index/en_1bc7bb5.pf_index
b/pagefind/index/en_1bc7bb5.pf_index
deleted file mode 100644
index fadd1e613..000000000
Binary files a/pagefind/index/en_1bc7bb5.pf_index and /dev/null differ
diff --git a/pagefind/index/en_1f9b49d.pf_index
b/pagefind/index/en_1f9b49d.pf_index
deleted file mode 100644
index fcb0d5882..000000000
Binary files a/pagefind/index/en_1f9b49d.pf_index and /dev/null differ
diff --git a/pagefind/index/en_258f182.pf_index
b/pagefind/index/en_258f182.pf_index
deleted file mode 100644
index 5eff6b61a..000000000
Binary files a/pagefind/index/en_258f182.pf_index and /dev/null differ
diff --git a/pagefind/index/en_25a6d48.pf_index
b/pagefind/index/en_25a6d48.pf_index
deleted file mode 100644
index 13a29e7a3..000000000
Binary files a/pagefind/index/en_25a6d48.pf_index and /dev/null differ
diff --git a/pagefind/index/en_27bb639.pf_index
b/pagefind/index/en_27bb639.pf_index
deleted file mode 100644
index 5109d7ec3..000000000
Binary files a/pagefind/index/en_27bb639.pf_index and /dev/null differ
diff --git a/pagefind/index/en_297d154.pf_index
b/pagefind/index/en_297d154.pf_index
new file mode 100644
index 000000000..1910a76b3
Binary files /dev/null and b/pagefind/index/en_297d154.pf_index differ
diff --git a/pagefind/index/en_2e77bfd.pf_index
b/pagefind/index/en_2e77bfd.pf_index
deleted file mode 100644
index e45e93de4..000000000
Binary files a/pagefind/index/en_2e77bfd.pf_index and /dev/null differ
diff --git a/pagefind/index/en_31f2c2f.pf_index
b/pagefind/index/en_31f2c2f.pf_index
deleted file mode 100644
index b50313f43..000000000
Binary files a/pagefind/index/en_31f2c2f.pf_index and /dev/null differ
diff --git a/pagefind/index/en_3b9cae4.pf_index
b/pagefind/index/en_3b9cae4.pf_index
new file mode 100644
index 000000000..8f98904ca
Binary files /dev/null and b/pagefind/index/en_3b9cae4.pf_index differ
diff --git a/pagefind/index/en_3ee9cbc.pf_index
b/pagefind/index/en_3ee9cbc.pf_index
deleted file mode 100644
index 0667e7ba2..000000000
Binary files a/pagefind/index/en_3ee9cbc.pf_index and /dev/null differ
diff --git a/pagefind/index/en_4a7ec25.pf_index
b/pagefind/index/en_4a7ec25.pf_index
new file mode 100644
index 000000000..991df18b6
Binary files /dev/null and b/pagefind/index/en_4a7ec25.pf_index differ
diff --git a/pagefind/index/en_79a178e.pf_index
b/pagefind/index/en_79a178e.pf_index
new file mode 100644
index 000000000..a28dba381
Binary files /dev/null and b/pagefind/index/en_79a178e.pf_index differ
diff --git a/pagefind/index/en_7edf535.pf_index
b/pagefind/index/en_7edf535.pf_index
new file mode 100644
index 000000000..30a90c596
Binary files /dev/null and b/pagefind/index/en_7edf535.pf_index differ
diff --git a/pagefind/index/en_7f1ee42.pf_index
b/pagefind/index/en_7f1ee42.pf_index
deleted file mode 100644
index 618104afe..000000000
Binary files a/pagefind/index/en_7f1ee42.pf_index and /dev/null differ
diff --git a/pagefind/index/en_845ebb2.pf_index
b/pagefind/index/en_845ebb2.pf_index
new file mode 100644
index 000000000..5072f3549
Binary files /dev/null and b/pagefind/index/en_845ebb2.pf_index differ
diff --git a/pagefind/index/en_84d7a65.pf_index
b/pagefind/index/en_84d7a65.pf_index
deleted file mode 100644
index f964f3e88..000000000
Binary files a/pagefind/index/en_84d7a65.pf_index and /dev/null differ
diff --git a/pagefind/index/en_8dea22e.pf_index
b/pagefind/index/en_8dea22e.pf_index
deleted file mode 100644
index 4f19b971a..000000000
Binary files a/pagefind/index/en_8dea22e.pf_index and /dev/null differ
diff --git a/pagefind/index/en_a835a44.pf_index
b/pagefind/index/en_a835a44.pf_index
deleted file mode 100644
index f3316a7ba..000000000
Binary files a/pagefind/index/en_a835a44.pf_index and /dev/null differ
diff --git a/pagefind/index/en_a967ad4.pf_index
b/pagefind/index/en_a967ad4.pf_index
new file mode 100644
index 000000000..d59813ee1
Binary files /dev/null and b/pagefind/index/en_a967ad4.pf_index differ
diff --git a/pagefind/index/en_b0445fb.pf_index
b/pagefind/index/en_b0445fb.pf_index
new file mode 100644
index 000000000..df96af205
Binary files /dev/null and b/pagefind/index/en_b0445fb.pf_index differ
diff --git a/pagefind/index/en_b49d55f.pf_index
b/pagefind/index/en_b49d55f.pf_index
new file mode 100644
index 000000000..6bac1c5b1
Binary files /dev/null and b/pagefind/index/en_b49d55f.pf_index differ
diff --git a/pagefind/index/en_b6d7355.pf_index
b/pagefind/index/en_b6d7355.pf_index
new file mode 100644
index 000000000..5f69fbdab
Binary files /dev/null and b/pagefind/index/en_b6d7355.pf_index differ
diff --git a/pagefind/index/en_c2f4f1c.pf_index
b/pagefind/index/en_c2f4f1c.pf_index
deleted file mode 100644
index b7552dfe8..000000000
Binary files a/pagefind/index/en_c2f4f1c.pf_index and /dev/null differ
diff --git a/pagefind/index/en_c3274a7.pf_index
b/pagefind/index/en_c3274a7.pf_index
new file mode 100644
index 000000000..050bb6464
Binary files /dev/null and b/pagefind/index/en_c3274a7.pf_index differ
diff --git a/pagefind/index/en_c8dbca5.pf_index
b/pagefind/index/en_c8dbca5.pf_index
deleted file mode 100644
index 60ce0b6d1..000000000
Binary files a/pagefind/index/en_c8dbca5.pf_index and /dev/null differ
diff --git a/pagefind/index/en_cbd35b5.pf_index
b/pagefind/index/en_cbd35b5.pf_index
new file mode 100644
index 000000000..b836e4528
Binary files /dev/null and b/pagefind/index/en_cbd35b5.pf_index differ
diff --git a/pagefind/index/en_ce597d8.pf_index
b/pagefind/index/en_ce597d8.pf_index
new file mode 100644
index 000000000..4035ea8fc
Binary files /dev/null and b/pagefind/index/en_ce597d8.pf_index differ
diff --git a/pagefind/index/en_cfb67c4.pf_index
b/pagefind/index/en_cfb67c4.pf_index
deleted file mode 100644
index 46fdaac39..000000000
Binary files a/pagefind/index/en_cfb67c4.pf_index and /dev/null differ
diff --git a/pagefind/index/en_d1b4390.pf_index
b/pagefind/index/en_d1b4390.pf_index
deleted file mode 100644
index 07898330e..000000000
Binary files a/pagefind/index/en_d1b4390.pf_index and /dev/null differ
diff --git a/pagefind/index/en_df4e586.pf_index
b/pagefind/index/en_df4e586.pf_index
new file mode 100644
index 000000000..41fbf64dc
Binary files /dev/null and b/pagefind/index/en_df4e586.pf_index differ
diff --git a/pagefind/index/en_e07f657.pf_index
b/pagefind/index/en_e07f657.pf_index
new file mode 100644
index 000000000..20a9ff378
Binary files /dev/null and b/pagefind/index/en_e07f657.pf_index differ
diff --git a/pagefind/index/en_e83d703.pf_index
b/pagefind/index/en_e83d703.pf_index
new file mode 100644
index 000000000..45c9bcc28
Binary files /dev/null and b/pagefind/index/en_e83d703.pf_index differ
diff --git a/pagefind/index/en_e96f3f1.pf_index
b/pagefind/index/en_e96f3f1.pf_index
new file mode 100644
index 000000000..34147a25d
Binary files /dev/null and b/pagefind/index/en_e96f3f1.pf_index differ
diff --git a/pagefind/index/en_eed5baa.pf_index
b/pagefind/index/en_eed5baa.pf_index
deleted file mode 100644
index 9060c2034..000000000
Binary files a/pagefind/index/en_eed5baa.pf_index and /dev/null differ
diff --git a/pagefind/index/en_f823e3f.pf_index
b/pagefind/index/en_f823e3f.pf_index
new file mode 100644
index 000000000..f2dead4ca
Binary files /dev/null and b/pagefind/index/en_f823e3f.pf_index differ
diff --git a/pagefind/pagefind-entry.json b/pagefind/pagefind-entry.json
index 60f13b9a1..f6ef78d30 100644
--- a/pagefind/pagefind-entry.json
+++ b/pagefind/pagefind-entry.json
@@ -1 +1 @@
-{"version":"1.3.0","languages":{"en":{"hash":"en_c4516cfc41","wasm":"en","page_count":189}}}
\ No newline at end of file
+{"version":"1.3.0","languages":{"en":{"hash":"en_be1c834885","wasm":"en","page_count":189}}}
\ No newline at end of file
diff --git a/pagefind/pagefind.en_be1c834885.pf_meta
b/pagefind/pagefind.en_be1c834885.pf_meta
new file mode 100644
index 000000000..b152974c2
Binary files /dev/null and b/pagefind/pagefind.en_be1c834885.pf_meta differ
diff --git a/pagefind/pagefind.en_c4516cfc41.pf_meta
b/pagefind/pagefind.en_c4516cfc41.pf_meta
deleted file mode 100644
index 67f2fdd56..000000000
Binary files a/pagefind/pagefind.en_c4516cfc41.pf_meta and /dev/null differ
diff --git a/sitemap.xml b/sitemap.xml
index 66d84a0f5..02ed96392 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1,6 +1,8 @@
<?xml version="1.0"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9";
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9
http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd";>
<url>
+
<loc>https://sling.apache.org/documentation/the-sling-engine/mappings-for-resource-resolution.html</loc><lastmod>2025-01-31</lastmod>
+ </url><url>
<loc>https://sling.apache.org/releases.html</loc><lastmod>2025-01-31</lastmod>
</url><url>
<loc>https://sling.apache.org/documentation/the-sling-engine/authentication/authentication-authenticationhandler/form-based-authenticationhandler.html</loc><lastmod>2025-01-17</lastmod>
@@ -150,8 +152,6 @@
<loc>https://sling.apache.org/documentation/tutorials-how-tos/jackrabbit-persistence.html</loc><lastmod>2018-07-17</lastmod>
</url><url>
<loc>https://sling.apache.org/documentation/the-sling-engine/the-sling-launchpad.html</loc><lastmod>2022-03-21</lastmod>
- </url><url>
-
<loc>https://sling.apache.org/documentation/the-sling-engine/mappings-for-resource-resolution.html</loc><lastmod>2024-09-02</lastmod>
</url><url>
<loc>https://sling.apache.org/documentation/the-sling-engine/authentication/authentication-framework.html</loc><lastmod>2021-04-21</lastmod>
</url><url>
