Éditer une page

Avant de lire cette page, prenons le temps de lire la courte page : La documentation Wiki.

Passer en mode édition

Pour éditer une page, il te faut être inscrit et identifié, puis passe en mode « édition » en cliquant sur l'icône « Éditer cette page » en haut à droite d'une page wiki ou sur le bouton du même nom en bas de page.

Syntaxe Wiki

Dans l'éditeur Wiki apparaît le « Code source » de la page, écrit en syntaxe Wiki qui est un langage de balisage léger. Elle décrit à la fois le contenu de la page ainsi que sa mise-en-page.

Voici quelques exemples de balises Wiki :

---

Code :

Un texte sans mise en forme

Rendu :

Un texte sans mise en forme

---

Code :

__Un texte en gras__

Rendu :

Un texte en gras

---

Code :

===Un texte souligné===

Rendu :

Un texte souligné

---

Édition avec les balises

Les balises peuvent être écrites à la main (si tu les connais), ou peuvent être rajoutées grâce aux outils disponibles dans la barre d'outils en haut de l'éditeur. Voici à quoi ressemble la barre d'outil d'une page Wiki :





Pour mettre en forme un bout de texte, il suffit généralement de le sélectionner, puis de cliquer sur l'icône correspondante à l'outil souhaité. Par exemple pour mettre en gras la ligne « Un texte en gras » de l'exemple précédent :





Nous n'allons pas détailler le fonctionnement de chacun des éléments de la barre d'édition car ceux-ci s'expliquent d'eux-même. Passe ta souris au dessus des icônes pour voir apparaître un descriptif de chaque outil. À noter que toutes les balises Wiki ne sont pas présentes dans la barre d'outils car elles sont trop nombreuses. Certaines balises devront donc être écrites à la main, mais tu verras qu'avec un peu d'habitude ceci ne pose pas problème. En cas de doute, tu peux te référer au système d'aide intégré en cliquant sur l'icône associée de la barre d'outils.



Quelques balises bien utiles :

• balise de lien interne : (code : {img src="img/icons/page_link.png"})
• balise de lien externe : (code : {img src="img/icons/world_link.png"})
• balise de désactivation de l'interprétation de la syntaxe wiki (code : {img src="img/icons/noparse.png"})
• balise de caractères spéciaux : (code : {img src="lib/ckeditor_tiki/ckeditor-icons/specialchar.gif"})
• balise d'image (code : {img src="img/icons/picture.png"})
• balise de citation (code : {img src="img/icons/quotes.png"})

Un exemple est plus parlant qu'un long discours, voici donc sans plus attendre un exemple complet de page wiki regroupant certaines des balises les plus couramment utilisées :

Exemple page type

Explications

Nous avons déjà vu plus haut certaines des balises utilisées dans cet exemple et, tu auras compris, l'utilisation d'autres balises telle que le point d'exclamation pour le titre d'un paragraphe ou les doubles apostrophes pour mettre un texte en italique.



Mais nous voici aussi face à un autre type de balises spéciales, celui {entre accolades}. Ce type de balise est appelé « Plugiciel ». Les plugiciels Wiki permettent d'étendre la syntaxe pour afficher des éléments spéciaux qui peuvent être des images, différents type de boîtes, des listes automatiques, etc...

Dans notre exemple, les plugiciels sont utilisés pour afficher une image et un sommaire (créé automatiquement). Le fonctionnement des plugiciels est ⇓ décrit plus bas.

Autre nouveauté, les liens hypertexte. Ceux-ci se trouvent sous la forme de liens Wiki entourés de ((doubles parenthèses))  ou bien de liens externes entourés de  [crochets] . Davantage d'explications sur les liens et la manière de les insérer ⇓ un peu plus bas.



Autre nouveauté encore, la balise ~hs~. Celle-ci créé un espace insécable.



Enfin, tu auras remarqué sur l'image que la page possède un titre et que celui-ci n'est pas écrit dans le code de la page !
Le titre (en réalité la description) peut-être différent du nom de la page (qui apparaît lui dans l'adresse URL de la page, ainsi généralement que dans la barre de fenêtre du navigateur). Cette description est accessible et modifiable lors de l'édition de la page, dans le deuxième onglet « Propriétés », au dessus de l'éditeur :

Syntaxe avancée

La liste des possibilités est énorme, réfère toi à la documentation officielle pour plus de détails :

• doc.tiki.org/Éditer une page
  • doc.tiki.org/Mise en forme du texte
  • doc.tiki.org/Listes
  • doc.tiki.org/Séparateurs
  • doc.tiki.org/Tableaux
  • doc.tiki.org/Caractères spéciaux
  • doc.tiki.org/Mise en forme avancée du texte

Insérer un lien

Il existe deux types différents de liens hypertextes, associés à deux outils différents de la barre d'outils :

Les liens Wiki (également appelés "liens internes")

Ces liens pointent vers une autre page Wiki du site. Ils sont représentés entourés de ((doubles parenthèses)).

Pour insérer un lien Wiki, utilise l'outil « Lien Wiki ». Cet outil affiche ce mini-formulaire :



Dans le champ « Créer un lien vers cette page », tape le nom de la page Wiki visée. Une fonction de complètement automatique propose une liste de pages correspondantes, sélectionne la bonne à la souris.


Éventuellement, ajoute dans le champ « Afficher ce texte » le nom qui s'affichera pour le lien (si non-renseigné, il s'agira du nom de la page), ou encore, ajoute dans le champ « Balise » le nom de la balise correspondant à un paragraphe précis de la page visée.



Quelques exemples de liens Wiki :

---

Code :

((Cue2toc))

Rendu :

Cue2toc

---

Code :

((Ardour|ce logiciel))

Rendu :

ce logiciel

---

Code :

((glossairec|#Compresseur|Définition d'un compresseur))

Rendu :

Définition d'un compresseur

---

Les liens externes

Pour insérer un lien hypertexte visant une page web externe au site, utilise l'outil « Lien externe » de la barre d'édition. Les liens externes sont représentés entourés de [crochets].

Un formulaire similaire à celui des liens Wiki apparaît. Rempli dans le champ « Créer un lien vers cet URL » l'adresse complète, et éventuellement ajoute dans le champ « Afficher ce texte » le nom qui s'affichera pour le lien (si non renseigné, il s'agira de l'URL complète).



Quelques exemples de liens externes :

---

Code :

[http://ardour.org/]

Rendu :

http://ardour.org/

---

Code :

[http://ardour.org/|Site officiel d'Ardour]

Rendu :

Site officiel d'Ardour

---

Si, pour une raison ou pour une autre (comme en page d'accueil par exemple), vous souhaitez qu'un lien externe qui s'affiche normalement en bleu (couleur des liens externes) soit affiché en orange (couleur des liens internes), vous pouvez appliquer la syntaxe de code suivant :

{DIV(class=wikilink)}[http://www.mon_lien.org/]{DIV}

Exemple avec le lien webchat linuxmao :


Code :

{DIV(class=wikilink)}[https://web.libera.chat/#linuxmao|webchat linuxmao]{DIV}

Rendu :

---

Autres types de liens

On notera particulièrement la possibilité de créer des liens permettant la navigation à l'intérieur même d'une page, sans avoir à recharger celle-ci. Ces liens pointent vers des balises de paragraphes (voir les liens Wiki) et doivent être écrits à la main.

---

Code :

[#Ins_rer_une_image|__⇓__ Insérer une image]

Rendu :

⇓ Insérer une image

---

Il peut être utile de faire un lien vers un sujet du forum :

---

Code :

[forumthread68770]

(en remplaçant 68770 par le numéro du forum)

Rendu :

forumthread68770

---

La même chose avec une définition personnalisée :

---

Code :

[forumthread68770|une définition personnalisée]

(toujours en remplaçant 68770 par le numéro du forum)

Rendu :

une définition personnalisée

---

Pour plus de détails et de possibilités, voir doc.t.o/Liens.

Réduire un lien-forum

Lorsqu'on insère un lien vers le forum, on fait souvent un simple copié/collé. De ce fait, l'adresse entière (avec le http) fait que le lien apparaît en bleu (bleu = lien externe) et pas en orange (orange = lien interne).

La "bonne" pratique et de ne conserver que la partie utile du lien, par exemple : sur le lien [http://linuxmao.org/tiki-view_forum_thread.php?comments_parentId=82529&forumId=46|méta-fil], ne conserver que [forumthread82529|méta-fil]. Il faut donc juste prendre le numéro après le comments_parentId et l'ajouter à la fin de forumthread.

Ce lien sera tout aussi fonctionnel et présente des avantages (entre autres) :

• si un jour, pour une raison ou une autre, le site change d'adresse (si par exemple on passe de http://linuxmao.org à http://machin.org), alors les liens seront toujours fonctionnels
• si un fil est déplacé d'une section à une autre par un modérateur des forums (passant par exemple de la section 46 du forum à la section 1), alors le lien est toujours fonctionnel

Les administrateurs ont tendance à éditer ce type de liens pour tout le monde, ce qui prend du temps. Moins il y en a à faire, mieux ils se portent !

Les plugiciels

Nous pouvons séparer les plugiciels en deux catégories : ceux pour lesquels nous devons préciser un contenu, et ceux dont le contenu est créé automatiquement.

---

Prenons le plugiciel BOX. Celui-ci créé une boîte et a donc besoin que nous lui précisions un contenu à afficher à l'intérieur. Nous utiliserons alors une syntaxe dite "en majuscule", avec deux balises délimitant le début et la fin du contenu.

Code : {BOX()}mon contenu{BOX}

Rendu : mon contenu

Les deux balises sont le nom du plugiciel (en majuscules) entourées d'accolades. La balise de début contient une section de paramètres du plugiciel, entre les deux parenthèses.

---

En effet, il est possible de spécifier des paramètres variés en fonction du plugiciel. Par exemple la documentation officielle nous apprend que le plugiciel BOX possède un paramètre width définissant la largeur de la boîte.

Code : {BOX(width=50%)}mon contenu{BOX}

Rendu : mon contenu

---

Si le paramètre contient des espaces, il faudra l'entourer de guillemets.

Code : {BOX(width=90% title="Mon titre")}mon contenu{BOX}

Rendu : Mon titre mon contenu

---

Le deuxième type de plugiciel, celui qui n'a pas besoin de contenu, s'écrit en minuscules, et ne possède qu'une balise.

Code : {maketoc}

Rendu : Table des matières Éditer une page Passer en mode édition Syntaxe Wiki Édition avec les balises Exemple page type Explications Syntaxe avancée Insérer un lien Les liens Wiki (également appelés "liens internes") Les liens externes Autres types de liens Réduire un lien-forum Les plugiciels Plugiciels communs Plugiciels perso linuxmao Insérer une image Insérer un fichier audio Insérer une vidéo HTML FLV Daily Motion Youtube Divers Pages verrouillées Signature Échappement de l'interprétation Tiki

---

Avec des paramètres :

Code : {maketoc maxdepth=1}

Rendu : Table des matières Éditer une page Syntaxe avancée Insérer un lien Les plugiciels Insérer une image Insérer un fichier audio Insérer une vidéo Divers

---

Tu trouveras dans la suite de cette page des exemples de plugiciels couramment utilisés. Pour une liste plus complète (mais parfois en anglais) et plus de détails sur les plugiciels, voir la documentation officielle : doc.t.o/Plugiciels Wiki.

Plugiciels communs

Plugiciels les plus couramment utilisés :

Code :	Rendu :
{maketoc maxdepth=1}	Table des matières Éditer une page Syntaxe avancée Insérer un lien Les plugiciels Insérer une image Insérer un fichier audio Insérer une vidéo Divers
{CODE()}sudo apt-get install zynaddsubfx{CODE} Plugiciel accessible via la barre d'édition ( ). En savoir plus sur ce plugiciel...	sudo apt-get install zynaddsubfx
{CODE(caption="Installer zynaddsubfx")}sudo apt-get install zynaddsubfx{CODE} Plugiciel accessible via la barre d'édition ( ). En savoir plus sur ce plugiciel...	Installer zynaddsubfx sudo apt-get install zynaddsubfx
{QUOTE(replyto="Confucius")}Je ne cherche pas à connaître les réponses, je cherche à comprendre les questions.{QUOTE} Plugiciel accessible via la barre d'édition ( ). En savoir plus sur ce plugiciel...	Confucius écrit : Je ne cherche pas à connaître les réponses, je cherche à comprendre les questions.
{maketoc maxdepth=1} En savoir plus sur ce plugiciel...	Table des matières Éditer une page Syntaxe avancée Insérer un lien Les plugiciels Insérer une image Insérer un fichier audio Insérer une vidéo Divers
{BOX()}boîte{BOX} En savoir plus sur ce plugiciel...	boîte
{img fileId=1322 thumb=popup width=100px title="Cliquer pour agrandir"} Voir ⇓ le paragraphe dédié : Insérer une image.

Plugiciels perso linuxmao

Plugiciels uniques au site linuxmao.org

%clear%	force un retour à la ligne (après une image par exemple)
[http://linuxmusicians.com/|linuxmusicians.com] {en}	linuxmusicians.com
[http://linuxmao.org|linux musicien] {fr}	linux musicien
fin d'un paragraphe {retour}	fin d'un paragraphe
{ATTENTION()}Documentation en cours d'écriture [forums|voir ce fil de forum lié]{ATTENTION}	attention Documentation en cours d'écriture voir ce fil de forum lié
{INFO()}Il va pleuvoir ce soir, penses à prendre ton parapluie~hs~!{INFO}	info Il va pleuvoir ce soir, penses à prendre ton parapluie !
{ASTUCE(close=y)}On peut rajouter une croix pour fermer ces trois boîtes (:cool:){ASTUCE}	astuce On peut rajouter une croix pour fermer ces trois boîtes
{navigation dossier="Le home studio" niveaux=1} Le paramètre "dossier=" est le nom de la page souhaité. Le paramètre optionnel "niveaux=" défini le nombre de sous-niveaux de l'arborescence affiché.	Le home studio Principes de l audionumerique Enregistrer Éditeurs audio Effets Le mixage Le mastering Greffons

Insérer une image

Pour insérer une image quelque part sur le site (page wiki, forum, article,...), suis la procédure suivante :

0 / Donne à ton image un nom de fichier explicite, pour faciliter les recherches dans les galeries de fichiers sur le site.

Exemple : « Ardour3_réglages_MIDI.png ».


1 / Place le curseur à l'endroit où tu souhaites que ton image apparaisse, puis clique sur l'icône « Choisir ou télécharger une image » de la barre d'édition




2 / Une fenêtre surgissante apparaît, dedans clique sur le bouton « Parcourir... » pour envoyer une image.



Notes :

1. si l'image est destinée à être affichée dans un forum, clique d'abord sur le bouton « liste des galeries », navigue dans le répertoire « Images > Forum » puis clique sur « Envoyer un fichier' » Une fenêtre similaire apparaît alors.
2. si l'image est déjà sur le site, clique à la place sur le bouton « Parcourir la galerie ». Sélectionne l'image et passe à l'étape 5.
   

3 / Une fois l'image sélectionnée sur ton disque dur, son nom s'affiche à coté du bouton « Parcourir... » :



Clique alors sur « Télécharger le(s) fichier(s) »



4 / Quelques secondes plus tard apparaît la fenêtre ci-contre. Clique sur le lien :





5 / La fenêtre surgissante se referme et te voici de retour dans l'éditeur. Un bout de code wiki est apparu, il ressemble à ceci :

{img fileId=1583 thumb=popup title="Cliquer pour agrandir"}

Et voilà ! Enregistre la page (ou envoi ton message de forum) et l'image apparaît. Si tu souhaites personnaliser la manière dont elle s'affiche, cliques sur la croix ci-dessous et continue à lire.


[+]

• Paramètres du plugiciel img
  
  
  Rappel : le fonctionnement général des plugiciels est ⇑ décrit plus haut.
  
  Le plugiciel img accepte les paramètres suivants :
  
  

  Paramètre	Valeur	Résultat	Exemple
  thumb	popup	un clic sur l'image la fait apparaître en taille réelle dans un nouvel onglet ou une nouvelle fenêtre	thumb=popup
  width	un nombre de pixels	la largeur de l'image sera limitée au nombre de pixels indiqué *	width=200px
  title	un titre	une info-bulle contenant le titre indiqué s'affichera lors d'un survol de l'image par la souris	title="Ardour, fenêtre principale"
  src	une URL	la source de l'image sera l'URL indiquée (dans ce cas supprimer le paramètre fileId) voir aussi Insérer un lien	src=img/linuxmao/logo_lmao_2013.png
  link	une URL	un clic sur l'image enverra sur l'URL indiquée (dans ce cas le paramètre thumb ne sera pas pris en compte) voir aussi Insérer un lien	link=Accueil
  imalign	left ou right	alignera l'image sur le coté indiqué et permet ainsi d'écrire du texte à coté d'une image. truc : ajoute le code %clear% après le texte pour revenir à la ligne sous l'image	imalign=left
  alt	un texte	le texte indiqué sera affiché à la place de l'image si celle-ci ne peut s'afficher (pour les navigateurs en mode texte par exemple)	alt="Fenêtre principale de mon logiciel"

  
  
  note

  Tous les paramètres ci-dessus sont facultatifs. Le seul paramètre obligatoire est la référence à l'image elle-même (fileId ou src).
  
  
  note

  * Note sur la taille des images : Dans tous les cas, une image est limitée à 400 px de large dans une page wiki et 120px dans un forum pour un affichage correct sur les petits écrans. Inutile d'essayer de la faire s'afficher plus grand ça ne fonctionnera pas !

Pour encore plus d'infos, voir :

• doc.t.o/Plugiciel Img
• doc.t.o/Insérer des images

Insérer un fichier audio

Pour insérer un fichier audio au format mp3 :

{mediaplayer mp3="http://chemin/vers/et/repertoire/de/la/source.mp3"}

Insérer une vidéo

HTML

Pour insérer une vidéo :

• copier le code HTML proposé par les sites d'hébergement comme Dailymotion ou YouTube via l'option Intégrer cette vidéo (parfois signalé avec le code </>)
• le coller dans un plugiciel HTML

{HTML()}<iframe frameborder="0" width="480" height="210" src="..."></iframe>{HTML}

.

FLV

Pour insérer une vidéo au format flv :

{mediaplayer flv="http://cheminvers/et/repertoire/dela/source.flv"}

Daily Motion

Quand vous récupérez le code pour l'exporter sur un blog ou un site, voici comment il est écrit :

<iframe frameborder="0" width="425" height="350" src="http://www.dailymotion.com/embed/video/xxxxxxx"></iframe><br /><a href="http://www.dailymotion.com/video/xxxxxxx_nomdelavideo" target="_blank">nomdelavideo</a> <i>par <a href="http://www.dailymotion.com/auteur" target="_blank">auteur</a></i>

Récupérez le code id de la vidéo sur la ligne suivante :

"src="http://www.dailymotion.com/embed/video/xxxxxxx"

Et le coller après /swf/ de la ligne suivante :

{FLASH(movie=http://www.dailymotion.com/swf/xxxxxxx,width=>425,height=>350,quality=>high)}{FLASH}

Youtube

Avec une URL du type :

[http://www.youtube.com/watch?v=Z_TkiYHkGmw|Au piano]

Récupérez le code youtube.com/watch?v=Z_TkiYHkGmw= et le coller après movie=lecode :

{youtube movie="Z_TkiYHkGmw" width="425" height="350" quality="high" allowFullScreen="y"}

Davantage d'informations : https://doc.tiki.org/PluginYouTube.

Divers

Pages verrouillées

Certaines pages sont verrouillées à l'écriture pour les utilisateurs comme par exemple :

• la page d'accueil, ceci dû a du spam sur cette page. Vous pouvez y laisser un commentaire (en bas de page).
• la page Toutes les MAJ.

Signature

(utilisé sur la page d'accueil)

Code :

{DIV(class=signature)}L'équipe linuxmao{DIV}

Rendu :

Échappement de l'interprétation Tiki

Plusieurs caractères réservés sont interprétés par le moteur de Tiki. Lorsque l'on veut simplement en obtenir l'affichage littéral, il est parfois nécessaire d'échapper à l'interpréteur en le(s) plaçant à l'intérieur d'une balise appelée « np ».

Par exemple « ~np~[ceci n'est pas un lien]~/np~ » affichera « [ceci n'est pas un lien] » (sans la balise « np », l'interpréteur afficherait « ceci n'est pas un lien »).

Il est également possible d'utiliser le nom d'entité HTML d'un caractère, par exemple « ~lt~ » pour obtenir « < », ou encore le code décimal du caractère précédé d'un zéro, par exemple « ~091~ceci n'est pas un lien non plus~093~ » pour « [ceci n'est pas un lien non plus] ».


[+]

• Autre nom de cette page :
  SITE_fonctionnement_wiki_editer - ancien nom de page
  Guide d'édition Wiki - ancien nom de page
  astuces wiki - ancien nom de page