Help:Format calendrier

From semantic-mediawiki.org
Format calendrier
Sujet :
Affiche le produit de toutes les données numériques demandées
Fourni par :
Semantic Result Formats
Ajouté dans la version :
1.4.0
Retiré depuis la version :
toujours supporté
Nécessite en plus :
rien
Nom du format :
calendrier (calendar)
Auteurs :
Yaron Koren
Catégories :
temps


Le format de résultat calendrier (calendar en anglais), partie intégrante de l'extension Semantic MediaWiki, peut être utilisé pour afficher les pages qui ont un temps associé, par exemple des événements, sur un calendrier.

Paramètres[edit]

Paramètre Type Par défaut Description
lang texte no Le code de la langue dans laquelle afficher le calendrier
template texte vide Le nom d'un modèle qui servira à afficher les résultats
userparam texte vide Une valeur passée dans chaque appel de modèle, si un modèle est utilisé
color texte vide La couleur pour marquer les entrées de calendrier
colors texte vide La couleur d’affichage pour chaque propriété de date (exemple : « Date de démarrage=>green,Date de fin=>#09C »)
startmonth texte 3 Le mois avec lequel l’affichage du calendrier est initialisé (par défaut, le mois en cours)
startyear texte 2024 L’année avec laquelle l’affichage de calendrier est initialisé (par défaut, l’année en cours)

Utilisation[edit]

Une requête au format calendrier devrait être appelée de la manière suivante :

{{#ask:
  [[Category:Events]]
  [[Has date::>{{#calendarstartdate:}}]]
  [[Has date::<{{#calendarenddate:}}]]
  |? Has date
  |format=calendar
}}

...En d'autres termes, la propriété date que l'on demande devrait aussi êtres utilisée pour filtrer les dates : #calendarstartdate et #calendarenddate donneront la première et la dernière date (en fait, le jour après la dernière date) respectivement, pour un mois spécifique. Ceci est fait afin que seules les dates situées dans le mois courant, au lieu de toutes, sont passées pour être affichées par le calendrier.

Quelques notes sur la création de telles requêtes :

  • Assurez-vous d'inclure les deux points, « : », dans les appels de fonction parseur #calendarstartdate et #calendarenddate ; dans le cas contraire, cela ne marchera pas.
  • Ne vous inquiétez pas du fait que les opérateurs de comparaisons sont « < » et « > » au lieu de « <= » et « >= » ; la valeur de retour des fonctions parseur sont paramétrées pour que cela ne soit pas un problème.
  • Vous pouvez aussi ajouter un paramètre « sort= » comme « sort=Has date », ainsi les événements compris dans chaque journée seront triés selon l'heure à laquelle ils se déroulent (en supposant que la propriété « Has date » dans ce cas inclue aussi une valeur de temps).

Options d'affichage[edit]

Vous pouvez paramétrer la couleur des entrées que sont marquées en ajoutant l'option couleur dans la requête :

|color=red

Différentes couleurs pour chaque jeu d'événements peuvent être affichées en utilisant les requêtes sémantiques complexes (Semantic Compound Queries).

L'option template = <nom du modèle> peut être utilisée pour modifier l'affichage d'un objet/événement calendrier :

|format=calendar
|template=''<...>''

Pour plus d'informations concernant le modèle utilisé, voir Format modèle.

Comme pour SRF 1.6, vous pouvez aussi paramétrer le premier jour où commence la semaine (par défaut, c'est dimanche) dans tout le wiki en modifiant la variable $srfgFirstDayOfWeek dans LocalSettings.php après l'inclusion des formats de résultat sémantiques. Pour le paramétrer sur lundi, par exemple, vous pouvez ajouter la ligne suivante si vous utilisez un wiki en français :

$srfgFirstDayOfWeek = 'lundi';

Veuillez noter que le jour doit être défini suivant la langue du wiki.

Le problème de cache[edit]

Dans les versions précédentes de formats de résultats sémantiques, les calendriers ne s'affichaient pas correctement à moins que le cache de MediaWiki soit désactivé manuellement au moins sur les pages qui contenaient des calendriers. Ce problème est maintenant résolu dans le code : si le problème existe toujours dans votre cas, veuillez upgrader vers la dernière version de SRF.

Changement des limites de résultats[edit]

La limite par défaut des résultats affichées dans une requête intégrée est de 20. S'il y a plus de 20 événements dans un mois, vous devriez ajouter un paramètre limit= dans la requête avec un nombre supérieur au nombre maximum que vous avez. Par exemple :

{{#ask:
  [[Category:Events]]
  [[Has date::>{{#calendarstartdate:}}]]
  [[Has date::<{{#calendarenddate:}}]]
  |? Has date
  |format=calendar
  |limit=300
}}

Dans le cas où le nombre d'événements dans le mois dépasse les 500, vous aurez besoin de faire une seconde opération - ajouter la ligne suivante dans votre fichier LocalSettings.php après l'inclusion de Semantic MediaWiki :

$smwgQMaxInlineLimit = 1000;

La valeur peut être n'importe quel nombre supérieur au nombre maximum d'événement que vous avez par mois.

Exemple[edit]

Vous pouvez voir un exemple du format calendrier en fonction sur cette page calendrier sur Discourse DB.


Cette page de documentation concerne toutes les versions de SMW depuis la 1.6.0 jusqu'à la version la plus récente.
      Autres langues : deenzh-hans