Formation Coop-Tic : ActionInclude

L'action ##""{{include page="PagePrincipale"}}""## ([[http://www.wikini.net 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 [[http://www.wikini.net 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 [[http://www.wikini.net WikiNi]] ou une page d'un autre [[http://www.wikini.net 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; }##

{{include page="ListeDesActionsWikini" class="right height15em small_fonts solid_border gray_background"}}
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.

----
{{trail toc="ListeDesActionsWikini"}}

Personnalisation graphique de la page ActionInclude