docs(15.10): add the 15.10 documentation tree

de/15.10/admin/accesstoken-guide.rst

@@ -0,0 +1,80 @@
+============
+Zugriffstoken
+============
+
+Übersicht
+=========
+
+Die Konfigurationsseite für Zugriffstoken verwaltet Zugriffstoken.
+
+Verwaltung
+==========
+
+Anzeige
+-------
+
+Um die Konfigurationsübersichtsseite für Zugriffstoken zu öffnen, klicken Sie im linken Menü auf [System > Zugriffstoken].
+
+|image0|
+
+Klicken Sie auf den Konfigurationsnamen, um ihn zu bearbeiten.
+
+Konfiguration erstellen
+-----------------------
+
+Um die Konfigurationsseite für Zugriffstoken zu öffnen, klicken Sie auf die Schaltfläche „Neu erstellen".
+
+|image1|
+
+Konfigurationsparameter
+-----------------------
+
+Name
+::::
+
+Geben Sie einen Namen an, um dieses Zugriffstoken zu beschreiben.
+
+Berechtigung
+::::::::::::
+
+Legen Sie die Berechtigung für das Zugriffstoken fest.
+Geben Sie diese im Format „{user\ |group|\ role}name" an.
+Um beispielsweise Suchergebnisse für Benutzer anzuzeigen, die zur Gruppe „developer" gehören, legen Sie die Berechtigung auf „{group}developer" fest.
+
+.. warning::
+
+   Ein Zugriffstoken mit der Berechtigung ``{role}admin-api`` (gespeichert als ``Radmin-api``) kann jeden Endpunkt der Admin API nutzen; siehe :doc:`../api/admin/api-admin-overview`. Ein Benutzer mit der Rolle ``admin-accesstoken`` kann ein solches Zugriffstoken ausstellen, und ein Benutzer mit ``admin-accesstoken-view`` kann die Werte der Zugriffstoken anzeigen. Behandeln Sie daher beide Rollen wie die Administratorrolle und gewähren Sie sie nur vertrauenswürdigen Betreibern.
+
+Parametername
+:::::::::::::
+
+Geben Sie den Namen des Anforderungsparameters an, wenn Sie die Berechtigung als Suchabfrage angeben.
+
+.. warning::
+
+   Die Parametername-Funktion ist ausschließlich für die Verwendung in vertrauenswürdigen internen Umgebungen konzipiert.
+   Wenn diese Funktion aktiviert ist, können zusätzliche Berechtigungen über URL-Parameter angegeben werden.
+   In extern zugänglichen Umgebungen oder bei Bereitstellung als öffentliche API können jedoch
+   böswillige Benutzer URL-Parameter manipulieren, um sich Berechtigungen zu verschaffen, die sie nicht haben sollten.
+
+   Bitte beachten Sie Folgendes:
+
+   * Verwenden Sie diese Funktion nur, wenn Fess in eine andere Anwendung oder einen Dienst eingebettet ist, der eingehende Anfragen vollständig kontrolliert.
+   * Konfigurieren Sie keinen Parameternamen, wenn Fess für nicht vertrauenswürdige Netzwerke zugänglich ist.
+   * Stellen Sie sicher, dass URL-Parameter bei Verwendung von Zugriffstoken nicht von externen Benutzern manipuliert werden können.
+
+Läuft ab
+::::::::
+
+Geben Sie das Ablaufdatum des Zugriffstokens an.
+
+Konfiguration löschen
+---------------------
+
+Klicken Sie auf den Konfigurationsnamen auf der Übersichtsseite und dann auf die Schaltfläche „Löschen". Es wird ein Bestätigungsbildschirm angezeigt.
+Klicken Sie auf die Schaltfläche „Löschen", um die Konfiguration zu löschen.
+
+
+
+.. |image0| image:: ../../../resources/images/en/15.10/admin/accesstoken-1.png
+.. |image1| image:: ../../../resources/images/en/15.10/admin/accesstoken-2.png

de/15.10/admin/backup-guide.rst

@@ -0,0 +1,115 @@
+=========
+Sicherung
+=========
+
+Übersicht
+=========
+
+Auf der Sicherungsseite können Sie Konfigurationsinformationen von |Fess| herunterladen und hochladen.
+
+Download
+--------
+
+|Fess| speichert Konfigurationsinformationen als Index.
+Klicken Sie zum Herunterladen auf den Indexnamen.
+
+|image0|
+
+.. note::
+
+   Wörterbuchdateien (Synonyme, Stoppwörter usw.) sind nicht Teil der Sicherung.
+   Sie liegen im Wörterbuchverzeichnis der Suchmaschine (``FESS_DICTIONARY_PATH``);
+   kopieren Sie sie bei Bedarf separat.
+
+fess_config.bulk
+::::::::::::::::
+
+fess_config.bulk enthält die Konfigurationsinformationen von |Fess|.
+
+fess_basic_config.bulk
+::::::::::::::::::::::
+
+fess_basic_config.bulk enthält die Konfigurationsinformationen von |Fess| ohne Crawl-Informationen, Fehler-URLs, Job-Protokolle, Thumbnail-Warteschlange, Benutzer-Tags und Ähnliches.
+
+fess_user.bulk
+::::::::::::::
+
+fess_user.bulk enthält Informationen zu Benutzern, Rollen und Gruppen.
+
+system.properties
+:::::::::::::::::
+
+system.properties enthält allgemeine Konfigurationsinformationen.
+
+fess.json
+:::::::::
+
+fess.json enthält die Konfigurationsinformationen des Fess-Index.
+
+doc.json
+::::::::
+
+doc.json enthält die Mapping-Informationen des Fess-Index.
+
+chat_log.ndjson
+:::::::::::::::
+
+chat_log.ndjson enthält die Nutzungsprotokolle des KI-Chats.
+
+click_log.ndjson
+::::::::::::::::
+
+click_log.ndjson enthält Klick-Protokollinformationen.
+
+favorite_log.ndjson
+:::::::::::::::::::
+
+favorite_log.ndjson enthält Favoriten-Protokollinformationen.
+
+search_log.ndjson
+:::::::::::::::::
+
+search_log.ndjson enthält Such-Protokollinformationen.
+
+user_info.ndjson
+::::::::::::::::
+
+user_info.ndjson enthält Informationen zu Suchbenutzern.
+
+Upload
+------
+
+Sie können Konfigurationsinformationen hochladen und importieren.
+Folgende Dateien können wiederhergestellt werden:
+
+- ``*.bulk``
+- ``system.properties``
+- ``fess.json`` und ``doc.json``: Sie ersetzen die Indexdefinitionsdateien, die |Fess| verwendet. Einstellungen und Mapping eines bestehenden Index werden dadurch nicht sofort geändert.
+- ``gsa*.xml``: eine Konfigurationsdatei der Google Search Appliance. Sie wird als Web-Crawl-Konfiguration, Dateisystem-Crawl-Konfiguration und als Labels importiert.
+
+``*.ndjson``-Dateien (Suchprotokolle und andere Protokolle) können nicht hochgeladen und wiederhergestellt werden.
+
+Ein Dokument in einer \*.bulk-Datei, das ein ``updatedTime`` hat, wird nur geschrieben, wenn das
+gespeicherte Dokument nicht existiert, kein ``updatedTime`` hat oder älter ist. Ein Dokument, das
+nicht neuer ist, wird übersprungen und in ``fess.log`` auf INFO-Ebene protokolliert. So macht eine
+Wiederherstellung Änderungen nach der Sicherung nicht rückgängig, und die mit der installierten
+Version gelieferten geplanten Jobs (``updatedTime`` 0) bleiben unverändert. Dokumente ohne
+``updatedTime`` werden immer geschrieben.
+
+.. note::
+
+   Das Überspringen wird auf INFO-Ebene protokolliert und erscheint daher mit der Standard-Protokollebene (``warn``) nicht in ``fess.log``. Um diese Einträge zu sehen, setzen Sie die Protokollebene vor der Wiederherstellung auf ``info``. Sie können sie in der Verwaltungsoberfläche unter [System > Allgemein] bei „Protokollebene" ändern (nach einem Neustart von |Fess| gilt wieder der konfigurierte Wert) oder unter Linux mit ``FESS_LOG_LEVEL=info``. Details finden Sie unter :doc:`../config/admin-logging`.
+
+.. note::
+
+   |Fess| 15.10 speichert das ``password`` der Web- und Datei-Authentifizierung mit dem Anwendungsschlüssel
+   (``app.cipher.key`` in ``fess_config.properties``) verschlüsselt, sodass ``fess_basic_config.bulk`` und
+   ``fess_config.bulk`` die verschlüsselten Werte enthalten. Übernehmen Sie beim Wiederherstellen einer Sicherung auf
+   einer anderen Installation denselben ``app.cipher.key``. Mit einem anderen Schlüssel schlagen Crawls, die diese
+   Zugangsdaten verwenden, mit einem Fehler fehl. Eine Sicherung, die vor 15.10 erstellt wurde, enthält sie im
+   Klartext und funktioniert weiterhin.
+
+   Andere Werte in einer ``*.bulk``-Datei sind nicht verschlüsselt. Bewahren Sie diese Dateien daher als sensible
+   Dateien auf.
+
+  .. |image0| image:: ../../../resources/images/en/15.10/admin/backup-1.png

de/15.10/admin/badword-guide.rst

@@ -0,0 +1,85 @@
+==================
+Ausschlusswörter
+==================
+
+Übersicht
+=========
+
+Hier wird die Konfiguration von Ausschlusswörtern für Vorschläge erläutert.
+Vorschläge werden entsprechend den Suchbegriffen angezeigt, aber Sie können konfigurieren, dass bestimmte Wörter nicht in den Vorschlägen erscheinen.
+
+
+Verwaltung
+==========
+
+Anzeige
+-------
+
+Um die Konfigurationsübersichtsseite für Ausschlusswörter für Vorschläge zu öffnen, klicken Sie im linken Menü auf [Vorschlagen > Schlechtes Wort].
+
+|image0|
+
+Klicken Sie auf den Konfigurationsnamen, um ihn zu bearbeiten.
+
+Konfiguration erstellen
+-----------------------
+
+Um die Erstellungsseite für Ausschlusswörter für Vorschläge zu öffnen, klicken Sie auf die Schaltfläche „Neu erstellen".
+
+|image1|
+
+Konfigurationsparameter
+-----------------------
+
+Schlechtes Wort
+:::::::::::::::
+
+Registrieren Sie unerwünschte Wörter.
+Wörter, die hier registriert sind, werden nicht in den Vorschlägen angezeigt.
+
+Konfiguration löschen
+---------------------
+
+Klicken Sie auf den Konfigurationsnamen auf der Übersichtsseite und dann auf die Schaltfläche „Löschen". Es wird ein Bestätigungsbildschirm angezeigt.
+Klicken Sie auf die Schaltfläche „Löschen", um die Konfiguration zu löschen.
+
+Download
+========
+
+Laden Sie registrierte Wörter im CSV-Format herunter.
+
+|image2|
+
+CSV-Inhalt
+----------
+
+Zeile 1 ist die Kopfzeile.
+Ab Zeile 2 werden die Ausschlusswörter aufgeführt.
+
+::
+
+"BadWord"
+"検索エンジン"
+
+Upload
+======
+
+Registrieren Sie Wörter im CSV-Format.
+
+|image3|
+
+CSV-Inhalt
+----------
+
+Zeile 1 ist die Kopfzeile.
+Ab Zeile 2 beschreiben Sie die Ausschlusswörter.
+
+::
+
+"BadWord"
+"検索エンジン"
+
+.. |image0| image:: ../../../resources/images/en/15.10/admin/badword-1.png
+.. |image1| image:: ../../../resources/images/en/15.10/admin/badword-2.png
+.. |image2| image:: ../../../resources/images/en/15.10/admin/badword-3.png
+.. |image3| image:: ../../../resources/images/en/15.10/admin/badword-4.png

de/15.10/admin/boostdoc-guide.rst

@@ -0,0 +1,83 @@
+==================
+Dokument-Boosting
+==================
+
+Übersicht
+=========
+
+Hier wird die Konfiguration für Dokument-Boosting erläutert.
+Durch die Konfiguration von Dokument-Boosting können Sie Dokumente unabhängig vom Suchbegriff in den Suchergebnissen höher positionieren.
+
+Verwaltung
+==========
+
+Anzeige
+-------
+
+Um die Konfigurationsübersichtsseite für Dokument-Boosting zu öffnen, klicken Sie im linken Menü auf [Crawler > Dokument-Boost].
+
+|image0|
+
+Klicken Sie auf den Konfigurationsnamen, um ihn zu bearbeiten.
+
+Konfiguration erstellen
+-----------------------
+
+Um die Konfigurationsseite für Dokument-Boosting zu öffnen, klicken Sie auf die Schaltfläche „Neu erstellen".
+
+|image1|
+
+Konfigurationsparameter
+-----------------------
+
+Bedingung
+:::::::::
+
+Geben Sie die Bedingung für Dokumente an, die höher positioniert werden sollen.
+Wenn Sie beispielsweise URLs mit https://www.n2sm.net/ höher anzeigen möchten, schreiben Sie url.matches("https://www.n2sm.net/.\*").
+Bedingungen werden in der Syntax der unter „Skripttyp" angegebenen Skript-Engine geschrieben.
+
+Boost-Ausdruck
+::::::::::::::
+
+Geben Sie den Gewichtungswert für das Dokument an.
+Ausdrücke werden in der Syntax der unter „Skripttyp" angegebenen Skript-Engine geschrieben.
+
+Skripttyp
+:::::::::
+
+Geben Sie die Skript-Engine an, mit der die Bedingung und der Boost-Ausdruck ausgewertet werden.
+Neue Konfigurationen sind mit ``javascript`` vorausgefüllt. Für ``groovy`` ist das Plugin
+``fess-script-groovy`` erforderlich. Bleibt das Feld leer, werden die Ausdrücke als Groovy ausgewertet.
+
+.. warning::
+
+   Schreiben Sie unter JavaScript die Bedingung und den Boost-Ausdruck als reine Ausdrücke ohne
+   abschließendes Semikolon. Text, der sich nur als Block von Anweisungen parsen lässt, wird zu
+   ``null`` ausgewertet, sofern er kein explizites ``return`` enthält. Siehe
+   :ref:`javascript-statement-null` (in :doc:`../config/scripting-javascript`).
+
+Sortierreihenfolge
+::::::::::::::::::
+
+Legen Sie die Sortierreihenfolge für das Dokument-Boosting fest.
+
+Zeitpunkt der Regelanwendung
+----------------------------
+
+Die Regeln für das Dokument-Boosting werden ausgewertet, wenn ein Web-Crawl oder ein Datei-Crawl ein Dokument im Index registriert. Auf Datenspeicher-Crawls werden sie nicht angewendet.
+Das Hinzufügen, Ändern oder Löschen einer Regel ändert den Boost von Dokumenten, die sich bereits im Index befinden, nicht.
+
+Ist „Letzte Änderung prüfen" unter [System > Allgemein] aktiviert (Standard), wird ein Dokument, dessen Inhalt sich nicht geändert hat, beim erneuten Crawlen nicht erneut im Index registriert. Sein Boost wird daher nicht erneut ausgewertet.
+Um eine neue oder geänderte Regel auf vorhandene Dokumente anzuwenden, löschen Sie diese Dokumente aus dem Index (siehe :doc:`searchlist-guide`) und crawlen Sie erneut.
+Ein Dokument, das erneut registriert wird, zum Beispiel weil sich sein Inhalt geändert hat, wird zu diesem Zeitpunkt ausgewertet.
+Ist „Letzte Änderung prüfen" deaktiviert, wird bei jedem Crawl jedes Dokument erneut registriert, sodass die Regeln jedes Mal ausgewertet werden.
+
+Konfiguration löschen
+---------------------
+
+Klicken Sie auf den Konfigurationsnamen auf der Übersichtsseite und dann auf die Schaltfläche „Löschen". Es wird ein Bestätigungsbildschirm angezeigt. Klicken Sie auf die Schaltfläche „Löschen", um die Konfiguration zu löschen.
+
+
+.. |image0| image:: ../../../resources/images/en/15.10/admin/boostdoc-1.png
+.. |image1| image:: ../../../resources/images/en/15.10/admin/boostdoc-2.png