Ceci est une page incluse
sous-section
Texte de sous-section
<WRAP box>...</WRAP> et non la macro {{page>...}} qui provoque le fond coloré.
Cette page ne peut pas servir à vos essais personnesls : allez dans playground.
Au moment de l'édition de la page dans la barre d'outil choisisez “inserer une image” (
).
Si le fichier n'est pas déjà dans la liste faîtes un “upload” dans la boîte de dialogue.
Voici le résultat : {{wiki:pg:test.pdf}}
Voici le résultat : test.pdf
Le site de référence des plugins de DokuWiki recense actuellement 550 plugins ; il n'est évidemment pas question de les recenser tous ici. Cette page présente la majorité de ceux qui sont utilisés sur les sites de iut-info-vannes.net, avec pur chacun un petit exemple d'utilisation.
La liste suivante est générée automatiquement par le plugin «info»
<spoiler | Info plugin en action> ~~INFO:syntaxplugins~~ </spoiler>
Ce plugin implante les listes de définitions avec la même logique que les listes classiques ; penser à sauter une ligne vide après le dernier item de la liste pour sortir du mode.
; Terme : définition du terme
; Terme 2 : première définition
: seconde définition
; Terme 3
; et Quatre
: Une définition commune
Donne le résultat suivant (notez les deux espaces minimum avant le caractère ';') :
Une structure sémantiquement correcte pour insérer des citations avec auteur dans le texte des pages :
<blockquote> Ceci est une citation .... </blockquote>
Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation.
Avec citation de l'auteur :
<blockquote D. Deveaux> Ceci est une citation ..... </blockquote>
Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation.
La structure interne <cite>...</cite> permet de contrôler la position du nom d'auteur et d'ajouter des liens si besoin :
<blockquote> <cite>[[daniel.deveaux@univ-ubs.fr|D. Deveaux]]</cite> Ceci est une citation ..... </blockquote>
D. DeveauxCeci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation Ceci est une citation.
Ces plugins apportent une aide pour faire une mise en page sophistiquée de la zone «contenu» des pages du wiki.
Le plugin Wrap récemment publié apporte le maximum de réponses aux problèmes d'organisation interne des pages ; voir la page d'exemples qui en démontre toutes les possibilités.
La plupart des autres plugins de mise en page sont devenus de ce fait obsolètes ; ils sont conservés ici car de nombreuses pages du site les emploient encore.
conf/userstyle.css pour supporter, outre la classe exemple utilisée dans cette page, une classe prof (ici) et une classe correct ci-dessous :
Ces deux plugins très employés ont été rendus obsolètes par l'arrivé du plugin wrap ; leur démonstration est reporté dans une page annexe
.
Ces deux plugins développés à l'IUT de Vannes couvrent des fonctionnalités très voisines de wrap. Cependant il peut être utile de les employer car ils permettent non seulement de choisir une ou des classes prédéfinies (comme wrap), mais aussi de définir n'importe quel style CSS dans l'attribut style. Télécharger et voir une documentation complète à http://projets.iut-info-vannes.net/wiki/wiki/plugins/.
Donne :
Un texte bien mis en valeur avec un lien dedans.
Boîte incluse
Ca marche
<color green>La réponse est OUI</color>.
On va bien voir
Ce plugin permet d'imbriquer une page web (du même site ou d'un autre site) dans la page courante.
<WRAP left 46%> {{url>http://www.univ-ubs.fr/}} </WRAP> <WRAP right 46%> {{url>http://iut-info-vannes.net/}} </WRAP> <WRAP clear></WRAP>
Permet d'inclure le contenu d'une autre page du site ou d'une section de page dans la page courante.
<WRAP box> {{page>.:inclusion&noheader&fullpage}} </WRAP>Ceci est une page incluse
sous-section
Texte de sous-section
C'est la commande englobante<WRAP box>...</WRAP>et non la macro{{page>...}}qui provoque le fond coloré.
Cette macro fait partie du paquetage blog que nous discutons ci-après.
spoiler permet de créer un bloc de texte caché qui s'ouvre en cliquant sur un bouton.
<spoiler|Cliquez "show" pour ouvrir> Voici la zone de texte cachée : * elle peut comporter des constructions Dokuwiki * mais pas de titres === voyez donc :-( === </spoiler>
De très nombreux plugins sont disponibles pour présenter des média variés (documents, musique, video, etc) ou pour gérer l'accès à des sites de présentation de contenu comme YouTube par exemple. Seuls quelques exemples sont présentés dans cette section.
Ce plugin très intéressant permet de visualiser dynamiquement les pièces attachées associées au namespace de la page courante ; si l'utilisateur à le droit de téléchargement sur cet espace, il propose en outre un lien qui ouvre une fenêtre de dialogue de téléchargement sur cet espace.
<spoiler|Démo de medialist> {{medialist>@PAGE@}} </spoiler>
Ce plugin très pratique permet de visualiser des photos chargées sur le site.
Voir un exemple sur AdInfo. Une galerie de la page exemple s'incorpore avec le code suivant :
{{gallery>:photos:2009:20090317_printemps_entreprise:01_preparation}}
Il existe également des plugins pour lancer des requêtes aux principaux sites de partage de photos tels Picasa, Flickr, etc.
Comme son nom l'indique, ce plugin active un player MP3. Attention le player est en Flash et suppose que le moter Flash est installé chez le cient.
{{mp3play>wiki:08_champagne.mp3?loop&autostart}} Higelin\\
{{mp3play>wiki:08_ma_blonde.mp3}} Mes Souliers sont Rouges
Higelin
Mes Souliers sont Rouges
Ceci est un simple exemple ; il y a aussi des plugins pour accéder à DailyMotion ou à DailyMotion VideoZap.
{{ youtube>small:OsIQnLQ3ADk }}
Il ne s'agit pas d'un plugin, mais d'un ensemble de composants qui, combinés, apportent tous les services nécessaires à des application de type blog :
Ils apparaissent dans la liste ci-dessus sous forme de plusieurs plugins : blog archive, blog draft, blog, include, pagelist, discussion threads, discussion comments. L'ensemble est assez complexe et demande un temps d'expérimentation, mais au bout du compte il permet de mettre en place une grande variété de services interactifs sur le wiki. Par exemple, les news des sites iut-info-vannes, les forums des projets sont gérés avec ces composants.
Voir la documentation blogging sur le site DokuWiki.
Il s'agit d'un plugin privé, développé à l'IUT de Vannes pour servir d'interface entre DokuWiki et les applications de gestion administrative du Département Informatique. Ce plugin, très largement employé sur les sites iut-info-vannes, n'est pas diffusé.
Ces services généraux sont inclassables dans les sections précédentes mais présentent une utilité certaine.
Ce petit plugin permet de mettre des commentaires «à la html» dans le code source dokuwiki ; il suffit pour cela de mettre le bloc de texte à commenter entre <!-- et --> comme dans le langage HTML. C'est la même fonctionnalité que celle obtenue avec <WRAP hidden>, mais en plus robuste (du code wiki bogué va planter WRAP mais pas htmlcomment) ; il est donc recommandé d'utiliser ce plugin pour commenter.
Ce texte est visible.
<!-- Celui-ci est un commentaire -->
Ce texte est visible.
Il s'agit d'un plugin système qui n'a donc d'intérêt que pour les administrateurs du Wiki. Il est plus pratique et convivial que le plugin de base installé par défaut dans la distribution, il est donc conseillé de l'installer si votre site doit gérer finement le contrôle d'accès en fonction des usagers.