Help:Format inclusion

From semantic-mediawiki.org
Jump to: navigation, search
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 2.5.5 released

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

This maintenance release provides bugfixes and improvements. Please refer to the help page on installing Semantic MediaWiki to get detailed instructions on how to install or upgrade.

SMWCon Fall 2017 registration open

SMWCon Fall 2017 Registration open.

The registration for SMWCon Fall 2017 in Rotterdam, the Netherlands (October 4-6, 2017) is now open. All interested participants can now register at the registration site. Note that the Early Bird period ends on September 6, 2017.

The conference is organised by ArchiXL, Wikibase Solutions, the Open University in the Netherlands and Open Semantic Data Association (OSDA).

For more information on this and the conference, see the SMWCon Fall 2017 homepage.

Semantic MediaWiki 2.5.4 released

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

This new version brings a security fix for special page "SemanticMediaWiki". It also provides an improvement for software testing, other bugfixes and further increases platform stability. Since this release provides a security fix it is strongly advised to upgrade immediately! Please refer to the help page on installing Semantic MediaWiki to get detailed instructions on how to install or upgrade.

[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

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 : dezh-hans

Help:Embedded format fr 0.7


References

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