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.
Table des matières
Référence rapide
Lien... | Syntaxe par défaut | Syntaxe optionnelle1 |
---|---|---|
Externe | [http://www.unsite.org] ou [http://www.unsite.org|unsite] |
http://www.unsite.org (AutoLinks3) |
Sur une autre page wiki | ((Nom de la page)) ou ((Nom de la page|Étiquette alternative)) |
Nom de la page (WikiWords2) |
Sur une page wiki d'un autre site Tiki | ((Nom du site: Nom de la page)) | Nom du site: Nom de la page (WikiWords2) |
- Tiki offre deux options qui modifie la syntaxe par défaut des liens : WikiWords and Autolink.
- 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. - 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.
Pour... | Syntaxe | Résultat | Commentaire |
---|---|---|---|
Spécifier une étiquette différente | ((PluginVersions|Plugiciel Versions)) | Plugiciel Versions | Séparez le lien de l'étiquette par une barre verticale |
Lier sur une balise ou un titre de paragraphe (avec étiquette) | ((Plugiciels Wiki|#Syntaxe_des_plugiciels|Syntaxe des plugiciels)) | Syntaxe des plugiciels | Tiki créé automatiquement des balise sur les titres de paragraphes. Recopiez la balise derrière le signe # et remplacez les espaces et accents par des tirets _ |
idem | [Plugiciels Wiki#Syntaxe_des_plugiciels|Syntaxe des plugiciels] | Syntaxe des plugiciels | |
Lier sur une balise dans la même page | [#Pages_li_es|Pages liées] | Pages liées | Notez le caractère # et les tirets pour remplacer les espaces et caractères accentués |
Lier sur un onglet spécifique dans une page | [PluginImg&cookietab=3 #Parameters' | Params Tab3] (sur une seule ligne) |
Params Tab3 | Fonctionne sur les ongles de tiki et ceux des modules PluginTabs. Cette exemple créé un lien sur un titre de paragraphe |
Spécifier une couleur d'affichage | ((Syntaxe Wiki|~~#ff0000:La syntaxe Wiki~~)) | La syntaxe Wiki | La couleur par defaut est définie par le thème tiki (CSS). Voir texte coloré pour plus d'infos |
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 :
Type de page | Syntaxe | Résultat |
---|---|---|
Nouvelle (n°19) | [tiki-read_article.php?articleId=19] | tiki-read_article.php?articleId=19 |
Nouvelle (n°19) | [tiki-read_article.php?articleId=19|Des nouvelles de doc.t.o !] | Des nouvelles de doc.t.o ! |
Galeries | [tiki-galleries.php|Galleries] | Galleries |
Fichier | [tiki-download_file.php?fileId=284|Télécharger le fichier PDF] | Télécharger le fichier PDF |
FAQ (n°8) | [tiki-view_faq.php?faqId=8|FAQ Images] | FAQ Images |
Popup shadowbox | [http://doc.tiki.org/tiki-print.php?page=Wiki-Syntax+Links|Voir ici|shadowbox;title=shadowbox exemple;] (La fonctionalité shadowbox doit être activée) |
Voir ici |
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
Premier onglet
Second onglet
Troisième onglet
Quatrième onglet
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 :
Description | Syntaxe | Résultat |
---|---|---|
Lien sur une page externe | [http://www.wiki-translation.com] | http://www.wiki-translation.com |
Avec une étiquette alternative | [http://www.wiki-translation.com|Traduction Wiki] | Traduction Wiki |
Avec l'option AutoLinks (si la fonctionalité est activée) |
http://www.wiki-translation.com | http://www.wiki-translation.com |
Avec une couleur alternative | [http://www.tiki.org|~~#ff0000:tiki.org~~] | tiki.org |
Ouvre une nouvelle fenêtre (si la fonctionalité est activée) |
[http://tiki.org||tiki.org|target] | tiki.org |
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 a>
Passez votre pointeur au dessus du lien pour voir l'info-bulle apparaitre. Voici les réglages importants pour cette fonctionnalité :
- JQuery doit être activé
- Réglez class="tikihelp"
- La première partie du paramètre title est le titre de l'info-bulle, et ce qui suit les deux points est le corps
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