summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorÉtienne Loks <etienne.loks@iggdrasil.net>2025-09-26 12:39:52 +0200
committerÉtienne Loks <etienne.loks@iggdrasil.net>2025-09-26 13:19:55 +0200
commit2828a7ff52a5772b430e2c5af5603a1be15ece0b (patch)
tree4d5a5e04eef1f73fe5a684e718938ce28be03ed0
parent5b4602b39ca38460cae3224676f3ec03277f0639 (diff)
downloadIshtar-2828a7ff52a5772b430e2c5af5603a1be15ece0b.tar.bz2
Ishtar-2828a7ff52a5772b430e2c5af5603a1be15ece0b.zip
✨ search online documentation: add documentation for "today" keyword
-rw-r--r--docs/fr/source/interface-utilisateur.rst18
-rw-r--r--ishtar_common/templates/widgets/search_input.html4
2 files changed, 16 insertions, 6 deletions
diff --git a/docs/fr/source/interface-utilisateur.rst b/docs/fr/source/interface-utilisateur.rst
index c598b64bf..7af8e48f2 100644
--- a/docs/fr/source/interface-utilisateur.rst
+++ b/docs/fr/source/interface-utilisateur.rst
@@ -142,7 +142,7 @@ Dans la recherche par critère, le moteur recherche exactement la valeur entrée
Exclusion
+++++++++
-Pour exclure des éléments de la recherche, ajouter le critère depuis le formulaire puis préfixer le critère par « - ».
+Pour exclure des éléments de la recherche, ajouter le critère depuis le formulaire puis préfixer le critère par « ``-`` ».
**Exemple** : la recherche « ``-materiau="métal"`` » excluera de la recherche tous le mobilier métallique.
@@ -160,22 +160,28 @@ Pour des recherches de type plus grand, plus petit (pour les champs de type numÃ
**Exemple** : la recherche « ``annee=>"2019"`` » permet d'obtenir tous les éléments de 2019 et après.
+Aujourd'hui
++++++++++++
+
+Des recherches peuvent être faites en relation avec la date du jour en utilisant le mot clé « ``aujourdhui`` ». Les signes « ``+`` » et « ``-`` » peuvent être utilisés pour ajouter ou supprimer des jours à la date du jour.
+
+**Exemple** : la recherche « ``cree=>"aujourdhui-10"`` » permet d'obtenir tous les éléments créés lors des 10 derniers jours.
Opérateur OU
++++++++++++
-Un opérateur OU est disponible afin de faire une recherche incluant, par exemple, des critères différents. Cet opérateur utilise la notation «`` || ``».
+Un opérateur OU est disponible afin de faire une recherche incluant, par exemple, des critères différents. Cet opérateur utilise la notation « ``||`` ».
-**Exemple** : la recherche « ``materiau="Métal" || type-objet="lingot" `` » incluera dans la recherche tout le mobilier métallique ainsi que tout le mobilier dont le type d'objet est lingot.
+**Exemple** : la recherche « ``materiau="Métal" || type-objet="lingot"`` » incluera dans la recherche tout le mobilier métallique ainsi que tout le mobilier dont le type d'objet est lingot.
Opérateur ET
++++++++++++
-Un opérateur ET est disponible notamment afin de faire une recherche sur un même critère avec plusieurs valeurs. Cet opérateur utilise la notation «`` && ``».
+Un opérateur ET est disponible notamment afin de faire une recherche sur un même critère avec plusieurs valeurs. Cet opérateur utilise la notation « ``&&`` ».
-**Exemple** : la recherche « ``materiau="Métal" && matériau="Bois" `` » n'incluera dans la recherche que le mobilier qui a pour matériau métal et bois.
+**Exemple** : la recherche « ``materiau="Métal" && matériau="Bois"`` » n'incluera dans la recherche que le mobilier qui a pour matériau métal et bois.
-.. warning:: Les opérateurs «`` && ``» et «`` || ``» ne fonctionnent que s'ils sont bien entourés d'espaces.
+.. warning:: Les opérateurs « ``&&`` » et « ``||`` » ne fonctionnent que s'ils sont bien entourés d'espaces.
.. _bookmarks:
diff --git a/ishtar_common/templates/widgets/search_input.html b/ishtar_common/templates/widgets/search_input.html
index e6808833e..d8ad26d8d 100644
--- a/ishtar_common/templates/widgets/search_input.html
+++ b/ishtar_common/templates/widgets/search_input.html
@@ -83,6 +83,10 @@
<p>{% blocktrans %}For searches such as larger, smaller (for numeric fields), before, after (for date fields), add the criterion from the form, then change the "=" sign to "=&gt;" or "=&lt;", depending on the desired result.{% endblocktrans %}</p>
<p><em>{% blocktrans %}Example: the search "year=&gt;'2019'" will return all items from 2019 and onwards.{% endblocktrans %}</em></p>
+ <h4>{% trans "Today" %}</h4>
+ <p>{% blocktrans %}Searches can be performed in relation to today's date using the keyword "today". "+" and "-" sign can be used in order to add or remove day to the current date.{% endblocktrans %}</p>
+ <p><em>{% blocktrans %}Example: the search "created=&gt;'today-10'" will return all items created in the last 10 days.{% endblocktrans %}</em></p>
+
<h4>{% trans "OR operator" %}</h4>
<p>{% blocktrans %}An OR operator is available for searches that include, for example, different criteria. This operator uses the notation "&nbsp;||&nbsp;".{% endblocktrans %}</p>
<p><em>{% blocktrans %}Example: the search "material='Metal' || object-type='ingot'" will include in the search all metallic finds as well as all finds whose object type is ingot.{% endblocktrans %}</em></p>