Help:Format inclusion

From semantic-mediawiki.org
Format inclusion
Sujet :
Permet l'inclusion d'articles entiers.
Fourni par :
Semantic MediaWiki
Ajouté dans la version :
0.7
Retiré depuis la version :
toujours supporté
Nécessite en plus :
rien
Nom du format :
embedded
Auteurs :
Markus Krötzsch
Catégories :
Divers

Le format de résultat embedded est utilisé pour inclure dans une page, le contenu des pages résultant d'une requête. L'incorporation utilise le principe de transclusion de Semantic MediaWiki (comme pour l'insertion d'un modèle), aussi les balises <includeonly> et <noinclude> sont reconnues et permettent ainsi de controler l'affichage.

Paramètres[edit]

Cas général[edit]

Paramètre Type Par défaut Description
source texte vide Source de requête alternative
limit nombre entier 50 Le nombre maximal de résultats à renvoyer
offset nombre entier 0 Le décalage du premier résultat
link texte all Montrer les valeurs en tant que liens
sort liste de textes vide Propriété sur laquelle trier la requête
order liste de textes vide Ordre de tri pour la requête
headers texte show Afficher les en-têtes / noms de propriétés
mainlabel texte no L’étiquette de la page d’accueil
intro texte vide Le texte à afficher avant les résultats de la requête, s’il y en a
outro texte vide Le texte à afficher après les résultats de la requête, s’il y en a
searchlabel texte ... further results Texte pour continuer la recherche
default texte vide Le texte à afficher s’il n’y a aucun résultat pour la requête

Format spécifique[edit]

Paramètre Type Par défaut Description
embedformat texte h1 La balise HTML qui sert à définir les en-têtes
embedonly oui/non no Ne pas afficher d’en-tête

Le format inclusion introduit les paramètres additionnels suivants:

  • embedformat: ceci définit le type d'entête à utiliser quand des pages sont incluses, éventuellement avec un niveau d'imbrication , par exemple une des valeurs suivantes h1, h2, h3, h4, h5, h6, ou une description de format de liste, comme ul ou ol
  • embedonly: si ce paramètre a une valeur affectée, (par exemple oui), alors il n'y a aucune entête pour les pages incluses.

Exemple[edit]

Ci après on recherche la liste des dernières nouvelles postées sur ce site (comme pour un blog):

{{#ask:
 [[News date::+]]
 [[language code::en]]
 |sort=news date
 |order=descending
 |format=embedded
 |embedformat=h3
 |searchlabel= <br /><br />[afficher les nouvelles plus anciennes]
 |limit=3
}}

Ce qui donne le résultat suivant:

MediaWiki Users and Developers Conference 2024 (April 17 to 19, 2024)

MediaWiki Users and Developers Conference 2024

The first MediaWiki Users and Developers Conference 2024 will occur on April 17 - 19, 2024 in Portland, Oregon, USA. Semantic MediaWiki-related talks are welcome.

Semantic MediaWiki at the MediaWiki Hackathon 2024 (May 3 to 5, 2024)

Semantic MediaWiki at the MediaWiki Hackathon 2024

The MediaWiki Hackathon 2024 will occur on May 3 - 5, 2024 in Tallinn, Estonia. We will organize Semantic MediaWiki-related activities. You are welcome to propose an online or on-site activity. See hackathon page for more information and inscription.

SMWCon Fall 2023 announced

SMWCon Fall 2023 will be held in Germany

Save the date! SMWCon Fall 2023 will take place December 11 - 13, 2023 in Paderborn, Germany. The conference is for everybody interested in wikis and open knowledge, especially in Semantic MediaWiki. You are welcome to propose a related talk, tutorial, workshop and more via the conference page.

[afficher les nouvelles plus anciennes]

NoteNote: Le symbole de retour à la ligne (<br />) est utilisé pour cadre les résultats successifs sur une nouvelle ligne.

Remarques[edit]

Remarquez bien que, par défaut, ce format de résultat ramène aussi toutes les annotations contenues dans les pages incluses dans la page qui réalise la requête. 1 A partir de Semantic MediaWiki 2.4.0 il est possible de masquer les annotations au travers de fonction #set et la fonction #subobject de l'analyseur, en déclarant le paramètre embedonly avec "yes". 2 Les annotations dans le texte continueront à être incluses. Ainsi ces annotations doivent être migrées pour utiliser la fonction #set de l'analyseur afin d'éviter que cela ne se produise.

Notez aussi que l'indentation des pages peut accidentellement inclure des commandes de catégorie si les articles ramenés n'ont pas de catégorie. Utilisez <noinclude> pour empêcher cela, par exemple en écrivant

<noinclude>[[Category:News feed]]</noinclude>

Semantic MediaWiki évitera que les articles inclus n'importent leurs annotations sémantiques, et donc qu'elles n'auront pas besoin d'être traitées spécifiquement.

Enfin, et pas des moindres, notez que les commandes de mise en forme sont inopérantes sur les résultats inclus.

Limitations[edit]

Vous ne pouvez pas utiliser le format inclusion pour inclure la requête d'une autre page si cette requête dépend du mot magique {{PAGENAME}}.



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


References

  1. ^  Semantic MediaWiki: GitHub issue gh:smw:1076
  2. ^  Semantic MediaWiki: GitHub pull request gh:smw:1455