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 Titre du lien permettant d'accéder aux résultats suivants (par défaut, «… autres résultats»)
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.1 released

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

This new version introduces a new feature called "deprecation notices", enhances existing functionality, provides bugfixes and further increases platform stability. Please refer to the help page on installing Semantic MediaWiki to get detailed instructions on how to install or upgrade.

Semantic MediaWiki 2.5 released

Semantic MediaWiki 2.5 (SMW 2.5.0), the next feature version after 2.4 has now been released.

This new version brings many enhancements and new features such as full-text search support for datatype "Text", query result caching for better performance and the options to record and reference provenance data, to use property chains and language filters in print requests, to define preferred property labels as well as to integrate edit protection with annotations. Moreover the links in values feature for datatype "Text" was improved a lot and the fixed properties support was repaired which is now no longer experimental. Not to forget special page "SMWAdmin" was renamed to "SemanticMediaWiki" extended and overhauled.

See also the version release page for information on further improvements and new features. Additionally this version fixes a lot of bugs and brings stability and performance improvements. Automated software testing was again further expanded to assure software stability. Please see the page Installation for details on how to install and upgrade.

Semantic MediaWiki 2.4.6 released

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

This new version is a minor release and provides an enhancement for users of MySQL data stores to the current 2.4 branch of Semantic MediaWiki. 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 : deenzh-hans

Help:Embedded format fr 0.7