Help:Format inclusion

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

Cas général

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

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

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:

Semantic MediaWiki 4.1.3 released

Semantic MediaWiki 4.1.3 (SMW 4.1.3) has been released today as a new version of Semantic MediaWiki.

It is a maintenance release that increases version compatibility with MediaWiki 1.39 and PHP 8.1, also provides bug fixes, and translation updates. Please refer to the help pages on installing or upgrading Semantic MediaWiki to get detailed instructions on how to do this.

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

Semantic MediaWiki at the Wikimedia Hackathon 2024

The Wikimedia 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.

Semantic MediaWiki 4.1.2 released

Semantic MediaWiki 4.1.2 (SMW 4.1.2) has been released today as a new version of Semantic MediaWiki.

It is a maintenance release that increases version compatibility with MediaWiki 1.39 and PHP 8.1, provides bug fixes and translation updates. Please refer to the help pages on installing or upgrading Semantic MediaWiki to get detailed instructions on how to do this.

[afficher les nouvelles plus anciennes]

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

Remarques

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

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 : de, zh-hans

Help:Embedded format fr 0.7