Skip to main content

Historique: Guide d édition Wiki

Afficher la page publiée Réduire en sessions d'édition

Aperçu de cette version: 467

Aide Auteur Wiki
La documentation wiki du site est constituée de plus de 2200 pages (au 09 avril 2016), dont plus de 600 dédiées à des logiciels et plus de 450 dédiées à des matériels. Elle se construit depuis 2005 grâce aux 7196 utilisateurs les inscrits et connectés au site, dont bientôt toi nous l’espérons ! Chacun est libre de modifier les pages, que ce soit pour corriger une faute de frappe ou pour ré-écrire une page complète. Voici comment.



É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 connecté, puis passe en mode « édition » en cliquant sur l'icône « Éditer cette page »Éditer cette page en haut à droite d'une page wiki ou sur le bouton du même nom en bas de page.

 Astuce
Il est aussi possible d'éditer une section particulière d'une page. Pour cela, clique sur l'icône « Modifier cette section »Modifier cette section en face du titre du paragraphe visé.
Pour plus d'informations voir doc.tiki.org/Édition par section. Image



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. Image Elle décrit à la fois le contenu de la page ainsi que sa mise-en-page.

Voici quelques exemples de balises Wiki :
-
Code :
Copy to clipboard
Un texte sans mise en forme

Rendu :

Un texte sans mise en forme

-
Code :
Copy to clipboard
__Un texte en gras__

Rendu :

Un texte en gras

-
Code :
Copy to clipboard
===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 :

toolbar.PNG



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 :

textegras.PNG



Nous n'allons pas détailler plus avant le fonctionnement de la barre d'édition car celle-ci s'explique d'elle-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éeImage de la barre d'outils.

 note
Pour supprimer une balise Wiki, il faut l'effacer à la main.



 astuce
Utilise la fonction « Aperçu » pour vérifier ta syntaxe Wiki avant d'enregistrer une page ! Tu peux aussi tester ta syntaxe dans le bac-à-sable Wiki.




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


Code :

Copy to clipboard
Cette __page type__ est un exemple de page Wiki.

{img src="img/linuxmao/logo_linuxmao.png"}
{maketoc}

!Informations
Site web officiel~hs~: [http://linuxmao.org]
Plateforme~hs~: ((GNU Linux))

!Description
Cette __page type__ donne un aperçu de ''l'agencement'' et de la ''mise en page'' d'une page Wiki standard.
Elle permet aussi de se familiariser avec la syntaxe Wiki.

!Utilisation
Cliques sur l'icône d'édition ===en haut à droite=== pour éditer une page Wiki.

!-Installation
Paragraphe rétractable.

!Liens et commentaires
~tc~ insère ici liens vers des docs (internes ou externes), vers des tutos ou autres pages liées ~/tc~
*((Accueil))
*((Manuel du site))
Rendu :

pagetype.PNG





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



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 le 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 Image 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 :

editpageproprietes.PNG




Syntaxe avancée


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



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 Image 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.
 astuce
Pour trouver le nom de la balise correspondant à un paragraphe précis, navigue sur la page visée et clique sur le nom du paragraphe dans le sommaire de la page. Recopie ensuite ce qui suit le signe dièse (#) dans l'URL de la page



Quelques exemples de liens Wiki :


Code :
Copy to clipboard
((Ardour 3))


Rendu :

Ardour 3


Code :
Copy to clipboard
((Ardour 3|Ardour))


Rendu :

Ardour


Code :
Copy to clipboard
((Ardour 3|#Installation|Ardour 3, paragraphe Installation))


Rendu :

Ardour 3, paragraphe Installation


Code :
Copy to clipboard
((c|#Compresseur|Définition d'un compresseur))


Rendu :

Définition d'un compresseur


Les liens externes


 note
Lorsque cela est possible, préfère l'utilisation de liens Wiki !

Pour insérer un lien hypertexte visant une page web externe au site, utilise l'outil « Lien externe » Image 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 :
Copy to clipboard
[http://ardour.org/]


Rendu :

http://ardour.org/


Code :
Copy to clipboard
[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 :
Copy to clipboard
{DIV(class=wikilink)}[http://www.mon_lien.org/]{DIV}

Exemple avec le lien webchat linuxmao :


Code :
Copy to clipboard
{DIV(class=wikilink)}[http://webchat.freenode.net/?channels=linuxmao|webchat linuxmao]{DIV}


Rendu :

webchat linuxmao



 note
Une bonne pratique pour les liens externes est d'ajouter un drapeau indiquant s'il s'agit d'un lien menant vers une page en français ou en anglais. Pour ceci, vous pouvez utiliser les balises :
  • {fr}  qui donneront -> Image
  • {en}  qui donneront -> Image



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 :
Copy to clipboard
[#Ins_rer_une_image|__⇓__ Insérer une image]


Rendu :

⇓ Insérer une image


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




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 :
Copy to clipboard
{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 :
Copy to clipboard
{BOX(width=50%)}mon contenu{BOX}

 Rendu :

mon contenu


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

Code :

Copy to clipboard
{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 :
Copy to clipboard
{maketoc}

 Rendu :




Avec des paramètres :

Code :

Copy to clipboard
{maketoc maxdepth=1}

 Rendu :




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 :
Copy to clipboard
{maketoc maxdepth=1}


{CODE()}sudo apt-get install zynaddsubfx{CODE}

Plugiciel accessible via la barre d'édition (Image ). En savoir plus sur ce plugiciel...
Copy to clipboard
sudo apt-get install zynaddsubfx




{CODE(caption="Installer zynaddsubfx")}sudo apt-get install zynaddsubfx{CODE}

Plugiciel accessible via la barre d'édition (Image ). En savoir plus sur ce plugiciel...
Installer zynaddsubfx
Copy to clipboard
sudo apt-get install zynaddsubfx



Copy to clipboard
{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 (Image ). En savoir plus sur ce plugiciel...
Confucius écrit:
Je ne cherche pas à connaître les réponses, je cherche à comprendre les questions.



Copy to clipboard
{maketoc maxdepth=1}
En savoir plus sur ce plugiciel...


Copy to clipboard
{BOX()}boîte{BOX}
En savoir plus sur ce plugiciel...


boîte



Copy to clipboard
{img fileId=1322 thumb=popup width=100px title="Cliquer pour agrandir"}

Voir ⇓ le paragraphe dédié : Insérer une image.
 01_pingouin_micro.png




Plugiciels perso linuxmao


Plugiciels uniques au site linuxmao.org
Copy to clipboard
%clear%
force un retour à la ligne (après une image par exemple)
Copy to clipboard
[http://linuxmusicians.com/|linuxmusicians.com] {en}
linuxmusicians.com Image
Copy to clipboard
[http://kokopelli-semences.fr/|retrouver la vie, la vraie] {fr}
retrouver la vie, la vraie Image
Copy to clipboard
fin d'un paragraphe {retour}
fin d'un paragraphe
Copy to clipboard
{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é

Copy to clipboard
{INFO()}Il va pleuvoir ce soir, penses à prendre ton parapluie~hs~!{INFO}
 info
Il va pleuvoir ce soir, penses à prendre ton parapluie !

Copy to clipboard
{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 😎


Copy to clipboard
{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




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 »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 :
Copy to clipboard
{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.


[+]


Insérer des pastilles numérotées dans vos images :

N'hésite pas à adjoindre des pastilles numérotés à tes copies d'écran ou tes schémas via le script-fu présent dans la page http://www.gillesmaire.com/tiki-index.php?page=draw-numbers. En un clic souris, tu choisis le nombre de pastilles et leur couleur et tu n'as plus qu'à les positionner dans l'image pour en faire une légende plus précise.



Pour encore plus d'infos, voir :


Insérer une vidéo


Note : des exemples de pages où se trouvent des insertions de vidéo : spectrum3d, miditouch, midiball, Yamaha Studio Manager et Praxis Live.


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
Copy to clipboard
{HTML()}<iframe frameborder="0" width="480" height="210" src="..."></iframe>{HTML}

 note
L'utilisation du plugin HTML nécessite d'être validée par un admin Wiki.
.


Daily Motion


Quand vous récupérez le code pour l'exporter sur un blog ou un site, voici comment il est écrit :
Copy to clipboard
<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 :
Copy to clipboard
"src="http://www.dailymotion.com/embed/video/xxxxxxx"


Et le coller après /swf/ de la ligne suivante :
Copy to clipboard
{FLASH(movie=http://www.dailymotion.com/swf/xxxxxxx,width=>425,height=>350,quality=>high)}{FLASH}



Youtube


Avec une URL du type :
Copy to clipboard
[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 :
Copy to clipboard
{youtube movie="Z_TkiYHkGmw" width="425" height="350" quality="high" allowFullScreen="y"}



Attention

Que ce soit avec le dailymotion ou youtube, le plugin :
  • n'est pas visible en mode Aperçu,
  • n'est pas actif sur les page personnelles des membres.

 astuce
Tu peux faire des tests avec ce plugin dans le bac à sable.


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



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



[+]

Historique

Information Version
Wed 01 Jan 2025 18:52 olinuxx 515
Afficher
Sat 20 Jan 2024 14:41 olinuxx 514
Afficher
Sat 17 Dec 2022 10:28 olinuxx 513
Afficher
Sun 27 Feb 2022 11:25 olinuxx 512
Afficher
Sun 27 Feb 2022 11:25 olinuxx 511
Afficher
Sun 27 Feb 2022 11:21 olinuxx 510
Afficher
Mon 08 Nov 2021 23:11 sub26nico changement du lien IRC 509
Afficher
Mon 08 Nov 2021 23:09 sub26nico 508
Afficher
Fri 09 Apr 2021 13:35 olinuxx mise à jour 2021 507
Afficher
Thu 11 Jun 2020 14:22 olinuxx 506
Afficher
Thu 23 Apr 2020 15:40 olinuxx mise à jour 505
Afficher
Wed 01 Jan 2020 17:48 olinuxx 504
Afficher
Mon 16 Sep 2019 14:36 olinuxx 503
Afficher
Wed 11 Sep 2019 23:23 olinuxx 502
Afficher
Wed 11 Sep 2019 14:59 jseb remplacement du lien publicitaire par un lien plus cohérent avec le thème du site. 501
Afficher
Wed 31 Jul 2019 14:02 olinuxx + image 500
Afficher
Mon 14 Jan 2019 03:23 olinuxx 499
Afficher
Mon 26 Nov 2018 18:28 olinuxx + 1 page contenant une vidéo + ponctuations 498
Afficher
Sat 29 Sep 2018 13:11 olinuxx mise à jour des 3 images du téléchargement d'image 497
Afficher
Sat 10 Feb 2018 19:29 VoiceOverTroubledWater Remplacé "le page" par "la page". 496
Afficher
Sat 11 Nov 2017 16:26 olinuxx mie à jour du paragraphe d'intro 495
Afficher
Sat 11 Nov 2017 16:08 olinuxx 494
Afficher
Sat 11 Nov 2017 16:07 olinuxx 493
Afficher
Sat 11 Nov 2017 16:05 olinuxx 492
Afficher
Sat 11 Nov 2017 16:04 olinuxx + paragraphe "réduire un lien-forum" 491
Afficher
Sat 09 Sep 2017 23:34 olinuxx 490
Afficher
Sat 13 mai 2017 15:02 olinuxx 489
Afficher
Fri 12 mai 2017 21:48 Kausal 488
Afficher
Fri 12 mai 2017 21:33 Kausal 487
Afficher
Fri 12 mai 2017 16:03 Kausal 486
Afficher
Fri 12 mai 2017 15:58 Kausal 485
Afficher
Fri 12 mai 2017 15:18 Kausal 484
Afficher
Sat 29 Oct 2016 16:42 olinuxx 483
Afficher
Tue 10 mai 2016 21:31 olinuxx 482
Afficher
Tue 10 mai 2016 21:28 olinuxx 481
Afficher
Tue 10 mai 2016 21:28 olinuxx + lien vers le forum 480
Afficher
Sun 24 Apr 2016 19:24 olinuxx 479
Afficher
Mon 18 Apr 2016 20:38 olinuxx 478
Afficher
Mon 18 Apr 2016 20:37 olinuxx 477
Afficher
Mon 11 Apr 2016 00:58 olinuxx 476
Afficher
Mon 11 Apr 2016 00:57 olinuxx intégration d'une info 475
Afficher
Mon 11 Apr 2016 00:36 olinuxx intégration d'une info 474
Afficher
Mon 11 Apr 2016 00:31 olinuxx amélioration 473
Afficher
Mon 11 Apr 2016 00:29 olinuxx cohérence 472
Afficher
Mon 11 Apr 2016 00:28 olinuxx cohérence 471
Afficher
Mon 11 Apr 2016 00:27 olinuxx cohérence 470
Afficher
Mon 11 Apr 2016 00:25 olinuxx cohérence 469
Afficher
Mon 11 Apr 2016 00:23 olinuxx 468
Afficher
Mon 11 Apr 2016 00:22 olinuxx cohérence 467
Afficher
Mon 11 Apr 2016 00:20 olinuxx intégration d'une info 466
Afficher