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 possde plusieurs applications :
  • elle permet de regrouper plusieurs pages en une seule et donc, par exemple, crer un document partir de diffrentes "sections" dissmines 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 rpts (inclus) dans plusieurs autres pages (il peut s'agir d'un menu, d'une signature, d'une mention lgale, ou autre)
  • encore plus fort ! il semble possible configurer ainsi le menu de navigation de WikiNi de cette manire ! dans le fichier wakka.config.php, il suffit d'indiquer :
    • "navigation_links" => "{{include page=\"MenuDuHaut\"}}",
    • et de crer dans la page MenuDuHaut ce que l'on souhaite voir apparatre. Cette page peut tre protge 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.

Paramtres

Cette action accepte deux paramtres :
  • page : paramtre obligatoire pour dsigner la page inclure (sans lequel l'action ne fonctionne pas). Ce paramtre peut tre une page local au WikiNi ou une page d'un autre WikiNi.
  • class : dsignant une ou plusieurs classes de style, spares par des espaces, agissant sur la mise en forme de l'inclusion ; ce paramtre est optionnel.

Actuellement, WikiNi intgre plusieurs classes prdfinies pour grer la mise en forme de l'inclusion :



Wikini propose par dfaut les "actions" suivantes.


Ces classes de style peuvent tre employes cumulativement. Ainsi, si l'on souhaite obtenir, par exemple, une boite grise avec une bordure et de petits caractres, on emploiera :
{{include page="ListeDesActionsWikini" class="gray_background solid_border small_fonts"}}
L'inclusion par dfaut, pour le moment, produit une prsentation non diffrencie par rapport au reste de la page ; il faut spcifier un style (comme en HTML classique), pour le voir appliqu. L'utilisation des classes de style doit faire l'objet d'une attention particulire, 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 incluse dans elle-mme : cela provoquerait une boucle rcursive infinie : un page affichant une page, affichant une page, affichant une page, etc.
De mme, 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 inclut la page Page1. Lorsque l'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-mme. En effet, la page "active" est Page1 et le test dans l'action {{include}} regarde si le nom de la page inclus est le mme 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 concrtement dvelopp dans WikiNi:ActionIncludeExempleDeBouclePage1 (interwiki) et suivantes.


<< ActionFindpage crayon ListeDesActionsWikini ActionListPages >>

Il n'y a pas de commentaire sur cette page. [Afficher commentaires/formulaire]