Eco-responsabilité:ActionInclude

Fichier Description Alignement

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 :
  - elle permet de regrouper plusieurs pages en une seule et donc, par exemple, crÃ©er un document Ã  partir de diffÃ©rentes "sections" dissÃ©minÃ©es dans plusieurs pages
  - elle permet de commenter/critiquer une page en lecture seule en l'incluant dans le corps d'une autre page
  - elle peut permettre, par exemple, de constituer des blocs d'informations redondantes qui seront rÃ©pÃ©tÃ©s (inclus) dans plusieurs autres pages (il peut s'agir d'un menu, d'une signature, d'une mention lÃ©gale, ou autre)
  - encore plus fort ! il semble possible configurer ainsi le menu de navigation de [[http://www.wikini.net WikiNi]] de cette maniÃ¨re ! dans le fichier wakka.config.php, il suffit d'indiquer :
    ##"navigation_links" => """{{include page=\"MenuDuHaut\"}}""",##
    et de crÃ©er dans la page ""MenuDuHaut"" ce que l'on souhaite voir apparaÃ®tre. Cette page peut Ãªtre protÃ©gÃ©e en lecture seule pour tout le monde et en Ã©criture pour les administrateurs fonctionnels.
  - elle permet une sorte de syndication en incluant des pages d'un autre __""WikiNi""__.

==== ParamÃ¨tres ====
Cette action accepte deux paramÃ¨tres :
  - page : paramÃ¨tre obligatoire pour dÃ©signer la page Ã  inclure (sans lequel l'action ne fonctionne pas). Ce paramÃ¨tre peut Ãªtre une page local au [[http://www.wikini.net WikiNi]] ou une page d'un autre [[http://www.wikini.net WikiNi]].
  - class : dÃ©signant une ou plusieurs classes de style, sÃ©parÃ©es par des espaces, agissant sur la mise en forme de l'inclusion ; ce paramÃ¨tre est optionnel.

Actuellement, [[http://www.wikini.net WikiNi]] intÃ¨gre plusieurs classes prÃ©dÃ©finies pour gÃ©rer la mise en forme de l'inclusion :
%%
.include_right { float: right; width: 17%; } /* bloc flotant Ã  droite */
.include_left { float: left; width: 17%; } /* bloc flotant Ã  gauche */
.include_solid_border { border: solid; padding: 2px; } /* encadrÃ© noir */
.include_gray_background { background-color: #DDDDDD; } /* fond gris */
.include_small_fonts { font-size: 0.8em; } /* petites polices */
.include_big_fonts { font-size: 1.2em; } /* grandes polces */
.include_height10em { height: 10em; overflow: scroll; } /* boite de 10em de hauteur, avec ascenseur */
.include_height15em { height: 15em; overflow: scroll; }
.include_height30em { height: 30em; overflow: scroll; }
.include_height60em { height: 60em; overflow: scroll; }
%%

{{include page="ListeDesActionsWikini" class="right height15em small_fonts solid_border gray_background"}}
Ces classes de style peuvent Ãªtre employÃ©es cumulativement. Ainsi, si l'on souhaite obtenir, par exemple, une boite grise avec une bordure et de petits caractÃ¨res, on employera :
##""{{include page="ListeDesActionsWikini" class="gray_background solid_border small_fonts"}}""##
L'inclusion par dÃ©faut, pour le moment, produit une prÃ©sentation non diffÃ©renciÃ©e par rapport au reste de la page ; il faut **spÃ©cifier** un style (comme en HTML classique), pour le voir appliquÃ©. L'utilisation des classes de style doit faire l'objet d'une attention particuliÃ¨re, certains navigateurs ne supportant que peu ou pas les styles CSS.
La boite ci Ã  droite correspond Ã  l'inclusion suivante : ##""{{include page="ListeDesActionsWikini" class="right height15em small_fonts solid_border gray_background"}}""##

Une page ne peut-Ãªtre inclue dans elle-mÃªme : cela provoquerait une boucle rÃ©cursive infinie : un page affichant une page, affichant une page, affichant une page, etc.
De mÃªme, les boucles d'inclusion portant sur plus d'une page, sont impossibles. Prenons par exemple : un page ""Page1"" inclus une page ""Page2"" qui inclus une page ""Page3"" qui inclus la page ""Page1"". Lorsque ont demande Ã  afficher la page ""Page1"", on voit le contenu des pages ""Page1"", ""Page2"" et ""Page3"" et le message d'erreur indiquant qu'il est impossible d'inclure une page dans elle mÃªme. En effet, la page "active" est ""Page1"" et le test dans l'action ##""{{include}}""## regarde si le nom de la page inclus est le mÃªme que celui de la page active ce qui provoque une erreur car l'inclusion d'autres pages ne change pas la page active.
On verra cet exemple concrÃ¨tement dÃ©veloppÃ© dans WikiNi:ActionIncludeExempleDeBouclePage1 et suivantes.

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

Vérification

Veuillez réecrire le mot présent dans l'image si vous souhaitez sauvegarder la page.

(actualisez la page si le mot est illisible)