codelibs · marevol · Oct 1, 2026 · Oct 1, 2026
diff --git a/de/15.9/user/index.rst b/de/15.9/user/index.rst
@@ -3,7 +3,7 @@
 
 Wie Suchanfragen in |Fess| geschrieben werden: UND, ODER und NICHT,
 Feld- und Labelsuche, Sortierung, Platzhalter, Bereiche, Boosting,
-unscharfe Suche und Geo-Suche.
+unscharfe Suche, Näherungssuche und Geo-Suche.
 
 .. toctree::
    :maxdepth: 2
@@ -19,6 +19,7 @@ unscharfe Suche und Geo-Suche.
    search-range
    search-boost
    search-fuzzy
+   search-proximity
    search-geo
    search-additional
    role-search

diff --git a/de/15.9/user/search-fuzzy.rst b/de/15.9/user/search-fuzzy.rst
@@ -41,7 +41,7 @@ Nutzungsbedingungen
 
 Beachten Sie bei der Verwendung der unscharfen Suche die folgenden Punkte:
 
-* Die unscharfe Suche wird auf einzelne Wörter angewendet. Sie kann nicht auf Phrasen angewendet werden, die in Anführungszeichen eingeschlossen sind. Eine Zahl, die einer Phrase angehängt wird (zum Beispiel ``"Fess Search"~2``), stellt dabei keine unscharfe Suche dar, sondern eine Näherungssuche (proximity search), die den Abstand zwischen den Wörtern angibt.
+* Die unscharfe Suche wird auf einzelne Wörter angewendet. Sie kann nicht auf Phrasen angewendet werden, die in Anführungszeichen eingeschlossen sind. Eine Zahl, die einer Phrase angehängt wird (zum Beispiel ``"Fess Search"~2``), stellt dabei keine unscharfe Suche dar, sondern eine :doc:`Näherungssuche <search-proximity>` (proximity search), die den Abstand zwischen den Wörtern angibt.
 * Die unscharfe Suche erfolgt auf Basis der im Index registrierten Wörter, wobei der Suchbegriff nicht erneut analysiert wird. Daher funktioniert sie möglicherweise nicht wie erwartet bei Texten wie Japanisch, die per Bi-Gramm oder morphologischer Analyse in Token zerlegt werden. Die unscharfe Suche ist vor allem bei alphanumerischen Wörtern wirksam.
 * Bei sehr kurzen Wörtern mit 1 bis 2 Zeichen kann das Verhalten trotz angehängtem "~" einer exakten Übereinstimmung nahekommen, da ein Treffer nur zustande kommt, wenn die Editierdistanz kleiner als die Wortlänge ist.
 
@@ -61,4 +61,5 @@ Siehe auch
 ==========
 
 - :doc:`search-wildcard`
+- :doc:`search-proximity`
 - :doc:`special-char`
diff --git a/de/15.9/user/search-proximity.rst b/de/15.9/user/search-proximity.rst
@@ -0,0 +1,70 @@
+================
+Näherungssuche
+================
+Näherungssuche (Proximity-Suche)
+==================================
+
+Mit der Näherungssuche finden Sie Dokumente, in denen die Wörter einer Phrase nahe beieinander stehen, auch wenn sie nicht direkt aufeinander folgen. Sie ist nützlich, wenn zwischen den gesuchten Wörtern weitere Wörter stehen können.
+
+Verwendung
+------------
+
+Schließen Sie die Wörter in doppelte Anführungszeichen ein und fügen Sie hinter dem schließenden Anführungszeichen "~" und eine Zahl an.
+
+Die folgende Suche findet beispielsweise Dokumente, in denen "Fess" und "Suche" innerhalb eines Abstands von 3 vorkommen:
+
+::
+
+    "Fess Suche"~3
+
+Die Zahl gibt die maximale Anzahl an Positionsverschiebungen an, die zwischen den Wörtern zulässig sind (siehe "Wie der Abstand gezählt wird" weiter unten). Je größer die Zahl, desto weiter dürfen die Wörter auseinander liegen.
+
+Sie können die Näherungssuche auch auf ein bestimmtes Feld anwenden. Im folgenden Beispiel wird das Feld title durchsucht.
+
+::
+
+    title:"Fess Suche"~3
+
+Wenn Sie die Zahl weglassen und nur "~" angeben (zum Beispiel ``"Fess Suche"~``), wird die Phrase als normale Phrasensuche behandelt, bei der die Wörter direkt aufeinander folgen müssen. Eine Dezimalzahl wird auf eine ganze Zahl gekürzt (``~2.5`` wird als ``~2`` behandelt).
+
+Die Näherungssuche kann mit einem Boost kombiniert werden. Im folgenden Beispiel wird die Näherungssuche mit dem Faktor 2 gewichtet (siehe :doc:`search-boost`).
+
+::
+
+    "Fess Suche"~5^2
+
+Wie der Abstand gezählt wird
+------------------------------
+
+* Die Zahl ist die maximale Anzahl an Positionsverschiebungen zwischen den Wörtern. Sie wird in Token gezählt, die der Analyzer des Zielfelds erzeugt, nicht in Zeichen oder durch Leerzeichen getrennten Wörtern. Bei englischem Text entspricht sie ungefähr der Anzahl der Wörter zwischen den Begriffen. Wörter, die bei der Analyse als Stoppwörter entfernt werden, werden dennoch mitgezählt.
+* Die Wörter dürfen in anderer Reihenfolge vorkommen, für die umgekehrte Reihenfolge ist jedoch eine größere Zahl erforderlich. Ein Dokument mit "quick brown fox" trifft beispielsweise auf ``"quick fox"~1`` zu, auf ``"fox quick"`` aber erst ab ``~3``.
+
+::
+
+    "quick fox"~1
+    "fox quick"~3
+
+Japanische, chinesische und koreanische Texte (CJK)
+-----------------------------------------------------
+
+Bei japanischen und anderen CJK-Texten hängt die Einheit, in der der Abstand gezählt wird, vom Feld ab.
+
+* In den allgemeinen Feldern title und content entspricht der Abstand in etwa der Anzahl der Zeichen zwischen den Wörtern.
+* In den sprachspezifischen Feldern wird in morphologischen Token gezählt; entfernte Partikel werden ebenfalls mitgezählt.
+
+Trennen Sie die Wörter daher durch Leerzeichen und geben Sie eine großzügige Zahl an.
+
+::
+
+    "全文 検索"~5
+    "大阪 おいしい"~10
+
+Eine Zeichenfolge ohne Leerzeichen (zum Beispiel ``"大阪おいしい"~10``) funktioniert als Näherungssuche zwischen den Wörtern möglicherweise nicht wie erwartet, da sie in den allgemeinen Feldern als eine zusammenhängende Zeichenfolge abgeglichen wird. Trennen Sie die Wörter daher durch Leerzeichen. Der Abstand lässt sich nicht exakt in eine Zeichenanzahl umrechnen. Beginnen Sie daher mit einer großzügigen Zahl und grenzen Sie sie anhand der Ergebnisse ein.
+
+Siehe auch
+============
+
+- :doc:`search-fuzzy`
+- :doc:`search-boost`
+- :doc:`search-field`
+- :doc:`special-char`
diff --git a/de/15.9/user/special-char.rst b/de/15.9/user/special-char.rst
@@ -8,7 +8,7 @@ Die folgenden Zeichen haben in der Syntax der Suchanfrage eine besondere Bedeutu
 
     + - && || ! ( ) { } [ ] ^ " ~ * ? : \ /
 
-Diese Zeichen werden verwendet, um Suchfunktionen wie erforderliche/ausgeschlossene Begriffe (``+`` ``-``), boolesche Operatoren (``&&`` ``||`` ``!``), Gruppierung (``( )``), Bereichssuche (``[ ]`` ``{ }``), Boost-Suche (``^``), Phrasensuche (``"``), unscharfe Suche (``~``), Platzhaltersuche (``*`` ``?``) und Feldsuche (``:``) aufzurufen.
+Diese Zeichen werden verwendet, um Suchfunktionen wie erforderliche/ausgeschlossene Begriffe (``+`` ``-``), boolesche Operatoren (``&&`` ``||`` ``!``), Gruppierung (``( )``), Bereichssuche (``[ ]`` ``{ }``), Boost-Suche (``^``), Phrasensuche (``"``), unscharfe Suche und Näherungssuche (``~``), Platzhaltersuche (``*`` ``?``) und Feldsuche (``:``) aufzurufen.
 
 Wird beispielsweise ein in einer URL oder einem Dateipfad enthaltenes „/" oder „:" oder ein in Programmcode enthaltenes „+" oder „-" unmaskiert als Suchbegriff verwendet, kann dies zu einem unerwarteten Suchergebnis führen.
 
@@ -43,8 +43,8 @@ Liste der Sonderzeichen und ihre Bedeutung
      - Phrasensuche (behandelt den eingeschlossenen Text als zusammenhängendes Wort; kann auch anstelle einer Maskierung verwendet werden)
      - :doc:`advanced-search`
    * - ``~``
-     - Unscharfe Suche (Fuzzy-Suche)
-     - :doc:`search-fuzzy`
+     - Unscharfe Suche (nach einem Wort) / Näherungssuche (nach einer Phrase)
+     - :doc:`search-fuzzy` / :doc:`search-proximity`
    * - ``*`` ``?``
      - Wildcard-Suche
      - :doc:`search-wildcard`
@@ -84,4 +84,5 @@ Siehe auch
 - :doc:`search-field`
 - :doc:`search-wildcard`
 - :doc:`search-fuzzy`
+- :doc:`search-proximity`
 - :doc:`advanced-search`
diff --git a/en/15.9/user/index.rst b/en/15.9/user/index.rst
@@ -2,8 +2,8 @@
 ==================
 
 How to write search queries in |Fess|: AND, OR and NOT, field and
-label search, sorting, wildcards, ranges, boosting, fuzzy search, and
-geo search.
+label search, sorting, wildcards, ranges, boosting, fuzzy search, proximity search,
+and geo search.
 
 .. toctree::
    :maxdepth: 2
@@ -19,6 +19,7 @@ geo search.
    search-range
    search-boost
    search-fuzzy
+   search-proximity
    search-geo
    search-additional
    role-search

diff --git a/en/15.9/user/search-fuzzy.rst b/en/15.9/user/search-fuzzy.rst
@@ -41,7 +41,7 @@ Usage Conditions
 
 Please note the following points when using fuzzy search.
 
-* Fuzzy search is applied on a per-word basis. It cannot be applied to phrases enclosed in quotation marks. Note that a number placed after a phrase (for example, ``"Fess Search"~2``) is not a fuzzy search but a proximity search that represents the distance between words.
+* Fuzzy search is applied on a per-word basis. It cannot be applied to phrases enclosed in quotation marks. Note that a number placed after a phrase (for example, ``"Fess Search"~2``) is not a fuzzy search but a :doc:`proximity search <search-proximity>` that represents the distance between words.
 * Fuzzy search targets words that have been registered in the index, and the search term is not re-analyzed. As a result, it may not work as expected for text such as Japanese, which is tokenized using bi-grams or morphological analysis. Fuzzy search is mainly effective for alphanumeric words.
 * For very short words of one or two characters, since the edit distance must be smaller than the length of the word for a match to occur, adding "~" may result in behavior close to an exact match.
 
@@ -61,4 +61,5 @@ Related Topics
 --------------
 
 - :doc:`search-wildcard` - Wildcard search
+- :doc:`search-proximity` - Proximity search
 - :doc:`special-char` - Special characters and escaping
diff --git a/en/15.9/user/search-proximity.rst b/en/15.9/user/search-proximity.rst
@@ -0,0 +1,70 @@
+==================
+Proximity Search
+==================
+Proximity Search (Word Distance Search)
+=========================================
+
+Proximity search finds documents in which the words of a phrase appear close to each other, even if they are not directly adjacent. It is useful when other words may appear between the words you are looking for.
+
+Usage
+-------
+
+Enclose the words in double quotation marks, and add "~" and a number after the closing quotation mark.
+
+For example, the following search finds documents in which "Fess" and "search" appear within a distance of 3:
+
+::
+
+    "Fess search"~3
+
+The number is the maximum number of position moves allowed between the words (see "How the Distance Is Counted" below). The larger the number, the farther apart the words may be.
+
+You can also perform a proximity search on a specific field. In the following example, the title field is searched.
+
+::
+
+    title:"Fess search"~3
+
+If you omit the number and specify only "~" (for example, ``"Fess search"~``), the phrase is searched as a normal phrase in which the words must be adjacent. A decimal number is truncated to an integer (``~2.5`` is treated as ``~2``).
+
+Proximity search can be combined with a boost. In the following example, the proximity search is boosted by 2 (see :doc:`search-boost`).
+
+::
+
+    "Fess search"~5^2
+
+How the Distance Is Counted
+-----------------------------
+
+* The number is the maximum number of position moves allowed between the words. It is counted in tokens produced by the analyzer of the target field, not in characters or whitespace-separated words. For English text, it is roughly the number of words between the terms. Words removed as stop words during analysis are still counted.
+* The words may appear in a different order, but a reversed order requires a larger number. For example, a document containing "quick brown fox" matches ``"quick fox"~1``, but it matches ``"fox quick"`` only with ``~3`` or larger.
+
+::
+
+    "quick fox"~1
+    "fox quick"~3
+
+Japanese and Other CJK Text
+-----------------------------
+
+For Japanese and other CJK text, the unit in which the distance is counted depends on the field.
+
+* On the general title and content fields, the distance is close to the number of characters between the words.
+* On the language-specific fields, the distance is counted in morphological tokens, and removed particles are also counted.
+
+Because of this, separate the words with spaces and specify a generous number.
+
+::
+
+    "全文 検索"~5
+    "大阪 おいしい"~10
+
+A string without spaces (for example, ``"大阪おいしい"~10``) may not work as a proximity search between the words as expected, because on the general fields it is matched as one continuous string. Separate the words with spaces. The distance cannot be converted exactly into a number of characters, so start with a generous number and narrow it down while checking the results.
+
+Related Topics
+----------------
+
+- :doc:`search-fuzzy` - Fuzzy search
+- :doc:`search-boost` - Boost search
+- :doc:`search-field` - Field-specified search
+- :doc:`special-char` - Special characters and escaping
diff --git a/en/15.9/user/special-char.rst b/en/15.9/user/special-char.rst
@@ -8,7 +8,7 @@ The following characters have a special meaning in the search query syntax, so t
 
     + - && || ! ( ) { } [ ] ^ " ~ * ? : \ /
 
-These characters are used to invoke search features such as required/prohibited terms (``+`` ``-``), boolean operators (``&&`` ``||`` ``!``), grouping (``( )``), range search (``[ ]`` ``{ }``), boost search (``^``), phrase search (``"``), fuzzy search (``~``), wildcard search (``*`` ``?``), and field search (``:``).
+These characters are used to invoke search features such as required/prohibited terms (``+`` ``-``), boolean operators (``&&`` ``||`` ``!``), grouping (``( )``), range search (``[ ]`` ``{ }``), boost search (``^``), phrase search (``"``), fuzzy search and proximity search (``~``), wildcard search (``*`` ``?``), and field search (``:``).
 
 For example, searching directly for a "/" or ":" in a URL or file path, or a "+" or "-" in program code, can produce unexpected search results. See below for how to escape these characters.
 
@@ -43,8 +43,8 @@ List of Special Characters
      - Phrase search (treats the enclosed text as a single phrase; can also be used instead of escaping)
      - :doc:`advanced-search`
    * - ``~``
-     - Fuzzy search
-     - :doc:`search-fuzzy`
+     - Fuzzy search (after a word) / proximity search (after a phrase)
+     - :doc:`search-fuzzy` / :doc:`search-proximity`
    * - ``*`` ``?``
      - Wildcard search
      - :doc:`search-wildcard`
@@ -85,4 +85,5 @@ Related Topics
 - :doc:`search-field` - Field-specified search
 - :doc:`search-wildcard` - Wildcard search
 - :doc:`search-fuzzy` - Fuzzy search
+- :doc:`search-proximity` - Proximity search
 - :doc:`advanced-search` - Advanced search options
diff --git a/es/15.9/user/index.rst b/es/15.9/user/index.rst
@@ -3,7 +3,7 @@ Guía de Usuario de |Fess|
 
 Cómo escribir consultas de búsqueda en |Fess|: AND, OR y NOT, búsqueda
 por campo y por etiqueta, ordenación, comodines, rangos, boosting,
-búsqueda difusa y búsqueda geográfica.
+búsqueda difusa, búsqueda de proximidad y búsqueda geográfica.
 
 .. toctree::
    :maxdepth: 2
@@ -19,6 +19,7 @@ búsqueda difusa y búsqueda geográfica.
    search-range
    search-boost
    search-fuzzy
+   search-proximity
    search-geo
    search-additional
    role-search

diff --git a/es/15.9/user/search-fuzzy.rst b/es/15.9/user/search-fuzzy.rst
@@ -41,7 +41,7 @@ Condiciones de uso
 
 Tenga en cuenta los siguientes puntos al utilizar la búsqueda difusa.
 
-* La búsqueda difusa se aplica a nivel de palabra. No se puede aplicar a frases entre comillas. Además, un número agregado después de una frase (por ejemplo, ``"Fess Search"~2``) no corresponde a una búsqueda difusa, sino a una búsqueda de proximidad que indica la distancia entre palabras.
+* La búsqueda difusa se aplica a nivel de palabra. No se puede aplicar a frases entre comillas. Además, un número agregado después de una frase (por ejemplo, ``"Fess Search"~2``) no corresponde a una búsqueda difusa, sino a una :doc:`búsqueda de proximidad <search-proximity>` que indica la distancia entre palabras.
 * La búsqueda difusa se realiza sobre las palabras registradas en el índice y el término de búsqueda no se vuelve a analizar. Por ello, es posible que no funcione como se espera en textos como el japonés, que se tokeniza mediante bi-gramas o análisis morfológico. La búsqueda difusa es eficaz principalmente con palabras alfanuméricas.
 * En el caso de palabras muy cortas, de 1 o 2 caracteres, la distancia de edición debe ser menor que la longitud de la palabra para que se produzca una coincidencia, por lo que, aunque se agregue "~", el comportamiento puede acercarse al de una coincidencia exacta.
 
@@ -62,4 +62,5 @@ Véase también
 =============
 
 - :doc:`search-wildcard` - Búsqueda con comodines
+- :doc:`search-proximity` - Búsqueda de proximidad
 - :doc:`special-char` - Caracteres especiales
diff --git a/es/15.9/user/search-proximity.rst b/es/15.9/user/search-proximity.rst
@@ -0,0 +1,70 @@
+========================
+Búsqueda de proximidad
+========================
+Búsqueda de proximidad (distancia entre palabras)
+===================================================
+
+La búsqueda de proximidad permite encontrar documentos en los que las palabras de una frase aparecen cerca unas de otras, aunque no estén juntas. Es útil cuando pueden aparecer otras palabras entre las que se están buscando.
+
+Cómo utilizar
+---------------
+
+Encierre las palabras entre comillas dobles y agregue "~" y un número después de la comilla de cierre.
+
+Por ejemplo, la siguiente búsqueda encuentra documentos en los que "Fess" y "búsqueda" aparecen a una distancia de 3 o menos:
+
+::
+
+    "Fess búsqueda"~3
+
+El número es la cantidad máxima de desplazamientos de posición permitidos entre las palabras (consulte "Cómo se cuenta la distancia" más adelante). Cuanto mayor sea el número, más separadas pueden estar las palabras.
+
+También puede realizar una búsqueda de proximidad en un campo específico. En el siguiente ejemplo, se busca en el campo title.
+
+::
+
+    title:"Fess búsqueda"~3
+
+Si omite el número y especifica únicamente "~" (por ejemplo, ``"Fess búsqueda"~``), la frase se busca como una frase normal en la que las palabras deben ser contiguas. Un número decimal se trunca a un entero (``~2.5`` se trata como ``~2``).
+
+La búsqueda de proximidad se puede combinar con un impulso (boost). En el siguiente ejemplo, la búsqueda de proximidad se multiplica por 2 (consulte :doc:`search-boost`).
+
+::
+
+    "Fess búsqueda"~5^2
+
+Cómo se cuenta la distancia
+-----------------------------
+
+* El número es la cantidad máxima de desplazamientos de posición permitidos entre las palabras. Se cuenta en tokens generados por el analizador del campo de destino, no en caracteres ni en palabras separadas por espacios. En textos en inglés, equivale aproximadamente al número de palabras que hay entre los términos. Las palabras eliminadas como palabras vacías (stop words) durante el análisis también se cuentan.
+* Las palabras pueden aparecer en otro orden, pero el orden inverso requiere un número mayor. Por ejemplo, un documento que contiene "quick brown fox" coincide con ``"quick fox"~1``, pero solo coincide con ``"fox quick"`` a partir de ``~3``.
+
+::
+
+    "quick fox"~1
+    "fox quick"~3
+
+Texto en japonés, chino y coreano (CJK)
+-----------------------------------------
+
+En textos en japonés y otros textos CJK, la unidad en que se cuenta la distancia depende del campo.
+
+* En los campos generales title y content, la distancia es cercana al número de caracteres que hay entre las palabras.
+* En los campos específicos de cada idioma, la distancia se cuenta en tokens morfológicos, y las partículas eliminadas también se cuentan.
+
+Por ello, separe las palabras con espacios y especifique un número generoso.
+
+::
+
+    "全文 検索"~5
+    "大阪 おいしい"~10
+
+Es posible que una cadena sin espacios (por ejemplo, ``"大阪おいしい"~10``) no funcione como se espera como búsqueda de proximidad entre palabras, ya que en los campos generales se compara como una única cadena continua. Separe las palabras con espacios. La distancia no se puede convertir exactamente en un número de caracteres, por lo que conviene empezar con un número generoso y reducirlo a medida que comprueba los resultados.
+
+Véase también
+===============
+
+- :doc:`search-fuzzy` - Búsqueda difusa
+- :doc:`search-boost` - Búsqueda con boost
+- :doc:`search-field` - Búsqueda con especificación de campos
+- :doc:`special-char` - Caracteres especiales