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: 396

Aide Auteur Wiki
La documentation wiki du site est constituée de plus de 1200 pages (au 16 juillet 2012), dont plus de 400 dédiées à des logiciels.
Le wiki se construit depuis 2005 grace à tous les utilisateurs inscrits au site, dont bientôt toi nous l'esperons ! Chacun est libre de le modifier, que ce soit pour corriger une faute de frappe ou ré-écrire une page complète. Voici comment...


Éditer une page

Rappel : Voir Comment naviguer et utiliser les pages Wiki.

Passer en mode édition

Pour éditer une page, passe en mode « édition » en cliquant sur l'icône « Editer cette page »Editer cette page en haut à droite d'une page wiki ou le bouton du même nom en bas de page.
 note
Il faut être inscrit et connecté pour pouvoir éditer une page.
 astuce
Il est aussi possible d'éditer une section particulière d'une page. Pour cela clique sur l'icône « Afficher les icônes d'édition »Image en haut de page, puis clique sur l'icône « Modifier cette section »Image en face du titre du paragraphe visé.
Pour plus d'informations voir doc.tiki.org/Édition par section.


Syntaxe Wiki

Dans l'éditeur Wiki apparait le « Code source » de la page, écrit en syntaxe Wiki.
La syntaxe Wiki est un langage de balisage léger, elle décrit à la fois le contenu de la page ainsi que sa mise-en-page.
L'éditeur possède un mode de coloration syntaxique donnant une idée de la mise-en-page attendue pour chaque balise.
 note
Le mode de coloration syntaxique possède un inconvénient. Il n'est pas possible avec d'utiliser les contrôles de champ texte standards des navigateurs, tel que coller avec un clic du bouton du milieu de la souris ou ton correcteur orthographique. Tu peux le désactiver en cliquant sur « Toggle Highlighter ».

Voici quelques exemples de balises Wiki :

Exemple de code :

Copy to clipboard
Un texte sans mise en forme
__Un texte en gras__
===Un texte souligné===

 Rendu :

Un texte sans mise en forme
Un texte en gras
Un texte souligné


Edition avec les balises

Les balises peuvent être écrites à la main (si tu les connais), ou peuvent être rajoutées grace aux outils disponibles dans la barre d'outils en haut de l'éditeur.
Voici à quoi ressemble la barre d'outil complète d'une page Wiki (elle est plus réduite dans les forums) :
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

 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.

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 apparaitre un descriptif de chaque outil.
 note
Pour supprimer une balise Wiki, il faut l'effacer à la main.

Toutes les balises Wiki ne sont pas représentées dans la barre d'outil car celles-ci 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.

Un exemple est plus parlant qu'un long discours, voici donc sans plus attendre un exemple complet de page wiki regroupant les 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 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 balise spécial, 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. Ces éléments 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))
  • de liens externes, entourés de [crochets]
Plus d'explications sur les liens et la manière de les insérer ⇓ un peut 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 le page !
Le titre (en réalité la description) peut-être différent du nom de la page (qui apparait 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 l'onglet « Propriétés », au dessus de l'éditeur.
editpageproprietes.PNG

Syntaxe avançé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 grands types de liens hypertexte, associés à deux outils différents de la barre d'outils :

Les liens Wiki :

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

outillienwiki.PNG Pour insérer un lien Wiki, utilise l'outil « Lien Wiki »Image de la barre d'édition.
Cette outil affiche le mini-formulaire ci-contre :


outillienwikiselection.PNG Dans le champ « Link to this 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.


Eventuellement, ajoute dans le champ « Show this text » le nom qui s'affichera pour le lien (si non renseigné, il s'agira du nom de la page).
Eventuellement encore, ajoute dans le champ « Anchor » 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èze (#) dans l'URL de la page

Quelques exemples de liens Wiki :

Code :

 Rendu :
Copy to clipboard
((Ardour 3))

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

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

 Ardour 3, paragraphe Installation
Copy to clipboard
((c|#Compresseur|Définition d'un compresseur))

 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 apparait. Rempli dans le champ « link to this URL » l'adresse complète, et éventuellement ajoute dans le champ « Show this text » 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 :

 Rendu :
Copy to clipboard
[http://ardour.org/]

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

 Site officiel d'Ardour
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 :
 Rendu :
Copy to clipboard
[#Ins_rer_une_image|__⇓__ Insérer une image]

 ⇓ Insérer une image
Pour plus de détails et de possibilités, voir doc.t.o/Liens

Les plugiciels

On peut séparer les plugiciels en deux catégories : Ceux pour lequels on précise un contenu et ceux dont le contenu est créé automatiquement.

Soit le plugiciel BOX. Ce plugiciel créé une boite et a donc besoin qu'on lui précise un contenu à afficher dedans.
On utilisera 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ètre 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 boite.
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 courament 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 :
{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] {anglais}

 linuxmusicians.com 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 dans une page wiki ou un fil de forum, 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 ou 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

uploadpic1.PNG 2 / Une fenêtre surgissante apparait, dedans clique sur le bouton « Parcourir... » pour envoyer une image.

Note : Si l'image est déstiné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 apparait alors.

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


uploadpic2.PNG 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) »


uploadpic3.PNG 4 / Quelques secondes plus tard apparait 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 apparait.
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

[+]

Insérer une vidéo


HTML

[+]

Daily Motion

[+]

Youtube

[+]

Créer une page

voir Créer une page.


[+]

Historique

Information Version
Tue 09 Jun 2015 13:25 olinuxx 415
Afficher
Tue 09 Jun 2015 13:24 olinuxx 414
Afficher
Tue 09 Jun 2015 13:24 olinuxx 413
Afficher
Tue 09 Jun 2015 13:23 olinuxx 412
Afficher
Wed 11 Mar 2015 18:54 olinuxx +1 alias + lien court 411
Afficher
Sat 21 Feb 2015 01:26 olinuxx + 1 alias 410
Afficher
Wed 18 Feb 2015 01:48 olinuxx correction + mise en page 409
Afficher
Tue 30 Dec 2014 01:50 olinuxx correction 408
Afficher
Sun 05 Oct 2014 08:52 olinuxx + commentaire 407
Afficher
Thu 04 Sep 2014 07:08 olinuxx 406
Afficher
Thu 04 Sep 2014 07:07 olinuxx ajout du plugiciel {fr} 405
Afficher
Thu 04 Sep 2014 07:03 olinuxx 404
Afficher
Tue 02 Sep 2014 21:36 olinuxx Recherche et remplacement en masse 403
Afficher
Tue 02 Sep 2014 21:36 olinuxx Recherche et remplacement en masse 402
Afficher
Tue 02 Sep 2014 09:57 olinuxx 401
Afficher
Tue 26 Aug 2014 12:54 utilisateur_anonyme2 Remplacement d'une boite de remarque 400
Afficher
Sat 15 Mar 2014 09:19 af 399
Afficher
Mon 03 Feb 2014 14:01 olinuxx 398
Afficher
Sat 14 Dec 2013 08:13 utilisateur_anonyme2 397
Afficher
Sat 14 Dec 2013 08:04 utilisateur_anonyme2 396
Afficher
Fri 13 Dec 2013 13:03 utilisateur_anonyme2 Insertion youtube 395
Afficher
Wed 11 Dec 2013 09:31 utilisateur_anonyme2 393
Afficher
Wed 11 Dec 2013 09:29 utilisateur_anonyme2 Insertion d'une vidéo daily motion 392
Afficher
Sun 10 Nov 2013 10:26 romain_bar Nouvelle section : insérer une vidéo 391
Afficher
Sun 10 Nov 2013 09:59 romain_bar Création de sous-sections 390
Afficher
Fri 01 Nov 2013 09:54 pianolivier 389
Afficher
Tue 01 Oct 2013 16:06 pianolivier 388
Afficher
Tue 01 Oct 2013 15:42 pianolivier 387
Afficher
Fri 27 Sep 2013 13:46 pianolivier 386
Afficher
Fri 27 Sep 2013 13:45 pianolivier 385
Afficher
Fri 27 Sep 2013 13:45 pianolivier 384
Afficher
Fri 27 Sep 2013 13:42 pianolivier 383
Afficher
Fri 27 Sep 2013 13:35 pianolivier 382
Afficher
Fri 27 Sep 2013 13:34 pianolivier 381
Afficher
Fri 27 Sep 2013 13:26 pianolivier 380
Afficher
Fri 27 Sep 2013 13:26 pianolivier 379
Afficher
Fri 27 Sep 2013 13:25 pianolivier 378
Afficher
Fri 27 Sep 2013 13:23 pianolivier 377
Afficher
Thu 19 Sep 2013 00:50 xzu 376
Afficher
Mon 16 Sep 2013 14:23 pianolivier 375
Afficher
Mon 16 Sep 2013 14:18 pianolivier 374
Afficher
Mon 16 Sep 2013 14:18 pianolivier 373
Afficher
Sun 15 Sep 2013 19:20 pianolivier 372
Afficher
Sat 14 Sep 2013 22:00 pianolivier 371
Afficher
Sat 14 Sep 2013 21:30 pianolivier 370
Afficher
Sat 14 Sep 2013 21:26 pianolivier 369
Afficher
Sat 14 Sep 2013 21:24 pianolivier 368
Afficher
Sat 14 Sep 2013 21:23 pianolivier 367
Afficher
Sat 14 Sep 2013 21:14 pianolivier 366
Afficher
Sat 14 Sep 2013 21:13 pianolivier 365
Afficher