L'action
{{include page="PagePrincipale"}} (
WikiNi >= 0.4.1) permet d'inclure dans une page une autre page du wiki (ici la page
PagePrincipale). Cette action possède plusieurs applications :
- Regrouper plusieurs pages en une seule et par exemple, créer un document à partir de différentes "sections" disséminées dans plusieurs pages ;
- Commenter/critiquer une page en lecture seule
- (en l'incluant dans le corps d'une autre page)
- Constituer des blocs d'informations redondantes qui seront répétés (incluses) dans plusieurs autres pages
- (il peut s'agir d'un menu, d'une signature, d'une mention légale, ou autre)
- Configurer le menu de navigation de WikiNi
- (en indiquant "navigation_links" => "{{include page=\"MenuDuHaut\"}}", dans le fichier wakka.config.php. La page MenuDuHaut, optionnellement protégée en écriture, contiendra le menu qui sera affiché.)
- Réaliser une sorte de syndication
- (en incluant des pages d'un autre WikiNi)
Paramètres
Cette action accepte deux paramètres :
- page (paramètre obligatoire) : désigne la page à inclure. Ce paramètre peut être une page locale au WikiNi ou une page d'un autre WikiNi.
- class (paramètre optionnel) : désignant un ou plusieurs éléments de style qui seront combinés pour déterminer l'aspect que prendra la page incluse.
Le paramètre
class liste un ou plusieurs éléments de style, séparés par des espaces. Les éléments possibles sont les suivants :
- right : bloc flotant à droite { float: right; width: 17%; }
- left : bloc flotant à gauche { float: left; width: 17%; }
- solid_border : encadré noir { border: solid; padding: 2px; }
- gray_background : fond gris { background-color: #DDDDDD; }
- small_fonts : petites polices { font-size: 0.8em; }
- big_fonts : grandes polces { font-size: 1.2em; }
- height10em : boite d'une hauteur de 10 lignes de texte, avec ascenseur { height: 10em; overflow: scroll; }
- height15em : boite d'une hauteur de 15 lignes de texte, avec ascenseur { height: 15em; overflow: scroll; }
- height30em : boite d'une hauteur de 30 lignes de texte, avec ascenseur { height: 30em; overflow: scroll; }
- height60em : boite d'une hauteur de 60 lignes de texte, avec ascenseur { height: 60em; overflow: scroll; }
Wikini propose par défaut les "actions" suivantes.
Le paramètre
class liste des éléments de style qui seront combinés. Par exemple, si l'on souhaite obtenir une boite grise avec une bordure et de petits caractères, on écrira :
{{include page="ListeDesActionsWikini" class="right height15em small_fonts solid_border gray_background"}} (voir le résultat dans le cadre ci-contre)
Si le paramètre
class est absent, le texte inclus sera présenté de manière non différenciée par rapport au reste de la page.
Une page ne peut-être inclue dans elle-même. De même, une chaîne d'inclusion ne peut contenir deux fois la même page. Par ensmple, si la page Toto inclus la page Titi, et si la page Titi inclus la page Tata, alors ni la page Titi ni la page Tata ne peuvent inclure la page Toto, sans quoi une erreur sera produite.