Dans cette page vous apprendrez comment inclure des liens hypertextes dans vos pages Wiki, incluant les liens "internes" sur d'autres pages wiki du même site et liens "externe" sur le web.

Référence rapide

Notes :

1. Tiki offre deux options qui modifie la syntaxe par défaut des liens : WikiWords and Autolink.
2. Pour activer WikiWords :
   À partir de l'onglet "fonctionnalités" de la page d'administration du wiki, activez l'option Mots Wiki
   Si cette option est désactivée, vous devez utiliser la syntaxe en doubles parenthèses pour les liens sur des pages wiki.
3. Pour activer AutoLinks :
   À partir du premier onglet de la page d'administration des outils d'édition, activez l'option Liens automatiques.
   Si cette option est désactivée, vous devez utiliser la syntaxe entre crochets pour les liens externes.

Liens internes

Sur des pages wiki

Si l'option WikiWords est activée, Tiki détectera automatiquement les noms de page wiki et les interprétera comme hyperliens.

Les méthodes suivantes sont possibles pour créer des liens sur des pages wiki à l'intérieur de votre site :

• MaPage
  Le nom de page ne doit pas contenir d'espace et la fonctionnalité WikiWords doit être activée
• ((Ma Page))
  Entourez le nom d'une page de doubles parenthèses (espaces autorisés)
• Ma Page
  Utilisez la première valeur (token) pour créer des liens sémantiques (comme les Alias ou pour appliquer une classe à un lien).

Ce tableau recense les méthodes suplémentaires pour créer des liens internes.

Help !

• Si vous voyez une point d'interrogation apparaitre à la place de votre lien, vérifiez le nom de la page grace au module de recherche.
• Si vous utilisez la fonctionnalité "mots wiki", Tiki convertira tous les mots se rapportants à un nom de page en lien wiki. Si vous souhaitez l'éviter, utilisez les doubles parenthèse inversées pour signifier qu'un mot n'est pas un "mot wiki". Par exemple :
  ))accueil(( ne sera pas un lien

Liens wiki sémantiques

Il est possible d'ajouter un "qualificatif sémantique" sur les liens Wiki.
Utilisez la syntaxe suivante~hsé:

(nom-du-qualificatif(Page))

• le qualificatif peut contenir des lettre minuscules et des tirets.
• le qualificatif sera ajouter à la classe CSS du lien pour pouvoir modifier son affichage.
• les relations sémantiques peuvent être configurée par les administrateurs à partir de Semantic Admin. Elle peuvent être affichées aussi via le module semantic_links.

Sur des Articles, Blogs, Forums et autres pages du site

Pour tous les types de pages autres que page wiki, il est possible d'utiliser une adresse raccourcie entre crochets. Voici quelques exemples :

Note: Utilisez [[foo] pour afficher [foo]

Sur des images et autres attachements

Pour créer un lien sur un fichier attaché à une page wiki, utilisez les plugiciels Attach ou File.
Si vous souhaitez qu'une image se comporte comme un lien sur une page, utilisez le paramètre link du plugiciel Img.

Lien sur une image dans un popup

Ce code Tiki :

[img/php.png|Cliquez ici pour voir l'image dans une fenêtre popup|shadowbox]

S'affichera dans une page ainsi :
Cliquez ici pour voir l'image dans une fenêtre popup

Afficher un onglet spécifique

Si le plugiciel Tabs est utilisé dans une page, on peut créer un lien sur un onglet spécifique de ce plugiciel ainsi :

{HTML()}<a href="#tab2" onclick="tikitabs(2); return false;">Onglet 2</a>{HTML}

{HTML()}<a href="#tab2" onclick="tikitabs(2,4,1); return false;">Onglet 2</a>{HTML}

Voici les particularités de cette syntaxe :

• tikitabs(2) (avec version 7) ou tikitabs(2,4,1) (versions précédentes) :
  • 2 signifie que le second onglet sera affiché
  • 4 signifie qu'il y a 4 onglets au total (versions inférieures à 7)
  • Utilisez toujours 1 comme troisième chiffre (versions inférieures à 7)
• href="#tab2" - Cette valeur peut être n'importe quoi, à condition qu'elle commence par le caractère #
• Onglet 2 - Ce texte sera l'étiquette affichée du lien

Voici un exemple :
Onglet 2

Liens de navigation

Voici quelques plugiciels permettant de créer des liens de navigation :

• PluginAname - Créé une balise dans une page wiki.
• PluginAlink - Créé un lien sur une balise (à utiliser en conjonction avec le plugiciel Aname.
• PluginBack - Créé un lien pour revenir à la page précédente.
• PluginBacklinks - Affiche toutes les pages wiki pointants vers une page wiki.
• PluginRedirect - Redirige les liens sur une pagec sur une autre page.

Liens sur d'autres sites wiki

Si la fonction est activée, il est possible de créer des liens raccourcis sur des pages wiki de sites externes. Vous devez alors connaitre le surnom que l'administrateur à défini pour cette fonctionnalité - cette information peut être documentée dans un manuel de style ou demandez à l'administrateur. Voir Wiki externe pour plus de détails et la liste des surnoms de wiki externes utilisables sur ce site.

Liens sur des pages web externes

Il est possible de créer des liens sur n'importe quelle URL externe valide. Par defaut, Tiki garde une copie de la page liée en cache, ce qui permet de la voir même si le site visé est hors-service. Voici quelques exemples de syntaxe Tiki :

Voir la Référence rapide ci-dessus pour comment régler et activer l'option AutoLinks. De plus, voici 2 autres options d'administration liées :

• Pour ouvrir les liens externes dans un nouvel onglet :
  Allez sur Admin Home > Text Area > Features section, sélectionnez Open external links in new window et validez la modification. Sinon les liens externes s'ouvre dans l'onglet actuel.
  
• Pour désactiver l'icone dédiée aux liens externe ( ) :
  Allez sur Admin Home > Editing and Plugins > General Settings > External links and images, déselectionnez External link icon et validez la modification. Cette icone se place normalement derrière un lien externe pour notifier les utilisateurs qu'ils vont être dirigé vers un autre site.

Important : Si vous créez un lien sur un fichier PDF, un fichier multimédia ou n'importe quoi d'autre qu'une page HTML, veuillez ajouter l'option nocache comme dans les exemples suivants :

• [http://www.unsite.org/docs/chapitre1.pdf|nocache]
• [http://www.unsite.org/docs/chapitre1.pdf|chapitre 1|nocache]

Aide!

• Si le lien ne fonctionne pas, essayez de copier l'URL directement dans vore navigateur. Si la page existe, vérifiez votre syntaxe. Avez-vous correctement placé les crochets ?

Dans des popups semi-transparents (colorbox)

Vous devez ajouter "|box" (ou peut-être "|shadowbox" dans les versions précédentes si box ne fonctionne pas pour vous) après l'étiquette de votre lien externe. Il est aussi possible d'ajouter d'autres paramètres si besoin, séparés de points-virgule.

Exemple 1 :

Pour afficher une vidéo en plein écran dans un popup semi-transparent :

[http://www.youtube.com/v/KBewVCducWw&autoplay=1|Vidéo utilisant le lecteur de Youtube|box]

Résultat :
Vidéo utilisant le lecteur de Youtube

Exemple 2 :

Pour afficher une vidéo dans une fenêtre popup plus petite :

[http://www.youtube.com/v/KBewVCducWw&autoplay=1|Vidéo utilisant le lecteur de Youtube|shadowbox;width=405;height=340;]

Résultat :
Vidéo utilisant le lecteur de Youtube

Liens sur une adresse email

Pour créer une lien sur une adresse email, entourez le mailto:email de crochets.
Ce lien, une fois cliqué, ouvrira le client email de l'utilisateur.
Exemples :

• Tapez ceci : [mailto:martin@quelquepart.com]
  Pour obtenir : mailto:martin@quelquepart.com
  
• Tapez ceci : [mailto:martin@quelquepart.com|martin]
  Pour obtenir : martin

Échapper la syntaxe des liens externes

Pour afficher un texte entre crochets sans créer de lien, utilisez la syntaxe suivantes :

• Le code : [[[texte]
• s'affichera ainsi : [texte]

Infos-bulles

Tiki possède une classe intégrée (appelée tikihelp) qui permet de créer des info-bulles formatée sur un lien, comme suit :

Le code Tiki suivant :

{HTML()} <a href="HomePage" class="tikihelp" title="Page d'accueil:Cliquez ici pour revenir à la page d'accueil de doc.tiki.org">Home Page</ a>{HTML}

S'affiche ainsi dans une page :
Home Page

Pages liées

• AutoLinks - option de syntaxe simplifiée pour les liens externes
• External Wikis - créer des liens raccourcis sur d'autres site wiki
• Plugiciel Alink - créer un lien sur une balise.
• Plugiciel Aname - créer une balise
• Plugiciel Attach - créer un lien sur un fichier attaché
• Plugiciel Back - créer un lien pour revenir à la page précéde
• Plugiciel Backlinks - afficher toutes les pages pointant vers une page
• Plugiciel File - similaire au Plugiciel Attach
• Plugiciel Img - transformer une image en lien
• Plugiciel Redirect - rediriger les liens vers une page sur une autre