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 :
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 :
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.
- 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)- ActionBacklinks insére la liste des pages faisant r�f�rence � la page courante
- ActionInclude : inclusion d'une page au sein d'une autre
- ActionListPages : liste la totalit� des pages du site (param�tres possibles)
- ActionListUsers : liste la totalit� des pages du site (tri /last).
- ActionMyChanges : donne les derni�res pages modifi�es par l'utilisateur courant (force son identification)
- ActionMyPages : donne la liste des pages dont l'utilisateur courant est le propri�taire
- ActionOrphanedPages : recherche les pages qui ne sont pas cibles de liens (pages orphelines)
- ActionPageIndex : liste toutes les pages class�es par ordre alphab�tique et regroup�es par lettres.
- ActionRecentChanges : affiche la liste des pages r�cemment modifi�es (voir DerniersChangements )
- ActionRecentChangesRSS : automatise la diffusion pr RSS (voir la page DerniersChangementsRss )
- ActionRecentComments : donne la liste des pages comment�es tri�es par date anti-chronologique (cf. ci-dessous)
- ActionRecentlyCommented : affiche une liste (born�e par max= ) des pages ayant �t� r�cemment comment�es (voir DerniersCommentaires ).
- ActionRedirect : redirection d'une page vers une autre
- ActionResetPassword : r�-initialise le mot de passe de l'utilisateur (utilis� dans ParametresUtilisateur )
- ActionTextSearch : recherche d'une cha�ne de caract�res dans l'ensemble des pages de Wikini
- ActionTrail : permet de lier des pages entres elles et de passer de l'une � l'autre avec un petit navigateur style "pr�c�dente/suivante"
- ActionUserSettings : cr�ation de compte et connexion (voir ParametresUtilisateur ).
- ActionWantedPages : liste les pages de Mot Wiki devant �tre �crites (voir PagesACreer ).
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.