Exemples de constructions Wiki

Cette page ne peut pas servir à vos essais personnesls : allez dans playground.

Exemple de fichier téléchargeable

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.

Attention, ne peuvent être uploadés que des fichiers dont le type mime est déclaré dans la configuration du Wiki ; contactez un administrateur si le vôtre est bloqué.
Voici le résultat : {{wiki:pg:test.pdf}}

Voici le résultat : test.pdf

Plugins installés

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.

L'interface d'administration de DokuWiki fournit un moyen simple pour installer et mettre à jour les plugins. Il est conseillé de lire complètement la documentation en ligne du plugin avant de l'installer ; il est par contre déconseillé de bricoler le code des plugins installés, ce qui compromettrait leur mises à jour ultérieures.

La liste suivante est générée automatiquement par le plugin «info»

<spoiler | Info plugin en action>
~~INFO:syntaxplugins~~
</spoiler>
Info plugin en action

Structuration logique du texte

Démonstration de "definition list"

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 ';') :

Terme
définition du terme
Terme 2
première définition
seconde définition
Terme 3
et Quatre
Une définition commune

Démonstration de "blockquote"

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. Deveaux

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.

Aides à la mise en page

Ces plugins apportent une aide pour faire une mise en page sophistiquée de la zone «contenu» des pages du wiki.

Plugin "wrap"

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.

Des styles locaux ont été crées dans le fichier conf/userstyle.css pour supporter, outre la classe exemple utilisée dans cette page, une classe prof (ici) et une classe correct ci-dessous :
On peut réfléchir à d'autres extensions utiles.
Voir le code source

Plugins obsolètes "note" et "box"

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 .

Démonstration des plugins "Spanstyle" et "Divstyle"

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/.

Voir le source

Donne :

Du texte avec une liste
  • item 1
  • item 2

Un texte bien mis en valeur avec un lien dedans.

Blah ….. blah ….. blah Blah ….. blah ….. blah Blah ….. blah ….. blah Blah ….. blah ….. blah Blah ….. blah ….. blah

Boîte incluse

Ca marche :-D

Le but est quand même de se rendre compte si on peut faire du tricolonnes proprement dans dokuwiki avec un truc simple comme le plugin «DivStyle» …. avec des liens dedans http://pouevretseu.net et des smileys ;-).

<color green>La réponse est OUI</color>.

Note: On peut utiliser à la fois les attributs «class» et «style» dans la définition d'une «DivStyle».
divstyle dans wrap-box cette fois

On va bien voir

Un texte en double boîte !!

Démonstration de "iframe"

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>

Démonstration de "include"

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.

Démonstration de "spoiler"

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>
Cliquez "show" pour ouvrir

Présentation de média

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.

Plugin "medialist"

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>
Démo de medialist

Plugin "gallery"

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.

Plugin "mp3play"

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

Plugin "youtube"

Ceci est un simple exemple ; il y a aussi des plugins pour accéder à DailyMotion ou à DailyMotion VideoZap.

{{ youtube>small:OsIQnLQ3ADk }}

Fonctionnalités complexes

La suite blog

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 :

  • billets avec commentaires,
  • newsletter archivée
  • forums
  • ….

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.

Plugin Goblin

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é.

Services divers

Ces services généraux sont inclassables dans les sections précédentes mais présentent une utilité certaine.

Plugin "htmlcomments"

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.

Plugin superACL

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.

wiki/exemples.txt · Dernière modification: 2009/10/04 06:28 (édition externe)

Informations sur la pratique du Wiki -- Mention légale
Copyright © 2005-07 UBS - IUT de Vannes - Dept Informatique
Creative Commons License Valid XHTML 1.0 Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed