[wiki] Avez-vous peur de la syntaxe ?

Olivier FAURAX

Bonjour,

Ce message s'adresse à ceux qui souhaiteraient aider pour le wiki, mais qui ne le font pas à cause de la syntaxe (trop compliquée, ou limitée, ou autre).

J'aimerai votre avis sur cette page :
http://wiki.mandriva.com/fr/Utiliser_le_Wiki
Quelles sont les sections les plus utiles ? Celles qui auraient plus leur place dans une aide "avancée" ?

Pouvez-vous donner un exemple de chose que vous vouliez faire sur le wiki et que vous n'êtes pas arrivé à faire, ou difficilement, à cause de la syntaxe ?

Pour vous, quel serait le mode de rédaction optimale ?

Je rappelle que ce message s'adresse à ceux qui ne rédigent pas encore sur le wiki : si vous avez déjà écrit 3 pages, attendez que la première page de ce fil de discussion soit remplie avant de répondre, pour ne pas influencer les réponses.

J'attends notamment des réponses de papajaac et jln95 (ouais, fredxx vous a dénoncé Wink

).
_________________
Aide instantanée : retrouvez-moi sur http://chat.jabberfr.org/muckl_int/?room=mandriva
Contact Jabber :
Web : http://ofaurax.free.fr/

AshLeDombos · Posted: Mon Aug 27, 2007 9:34 am Post subject:

Salut,

très bonne page !
pour les images il faudrait rajouter comment faire des vignettes (thumbs).

il faudrait aussi parler des balises ___TOC___ et___NOTOC___
_________________

Jabber^W XMPP : ashledombos (che) amessage (punto) be

PapaJaac · Posted: Mon Aug 27, 2007 3:40 pm Post subject:

janot · Posted: Wed Aug 29, 2007 8:07 am Post subject:

AshLeDombos · Posted: Wed Aug 29, 2007 9:44 am Post subject:

Fredxx · Posted: Wed Aug 29, 2007 10:58 am Post subject:

Je voudrais recentrer la conversation : Olivier demande si, par rapport au document qu'il a rédigé, ce qu'il a écrit vous semble simple, et si avec cela vous vous sentez capable de rédiger un document.

Sans pouvoir encore vous livrer le contenu de ma pensée (sinon, Olivier va encore me taper dessus Wink

), il s'agit bien de savoir :

1) si la syntaxe wiki basique qu'on utilise (son article) pour rédiger des articles, vous semble compliquée à manier ;

2) si vous vous sentez "bridés" avec la syntaxe proposée dans son document, qui reste "basique" : en clair, est-ce que esthétiquement, ça vous suffit, ou voudriez-vous pouvoir inclure du code pour faire de belles mises en page, sans pouvoir le faire en raison de la complexité de ce code.

3) Si la syntaxe wiki, même basique (son document) vous rebute au point de ne pas vouloir écrire le moindre article dans dans le wiki.

merci à tous.
_________________
http://www.reachsummit.com/FR/ | Le Vade Mecum | fredxx AT jabber-fr POINT net

PapaJaac · Posted: Wed Aug 29, 2007 11:37 am Post subject:

OK je pense avoir répondu alors. Pour résumer je vais contribuer par des articles de type rédactionnels, pas trop longs, en me servant de la barre d'outils en haut pour les attributs de texte. Cependant ne vous attendez pas à des images en pagaille ni à des tableaux, la procédure à suivre est trop lourde. Pour l'esthétique je persiste à penser que ce n'est pas le lieu approprié et je ne chercherai pas à en faire, mais bien évidemment le reste du monde est libre de faire preuve de plus créativité visuelle Wink

_________________
Quelques conseils judicieux...
"Le droit au rêve a pour pendant le devoir de vigilance" (H. Broch)

Olivier FAURAX · Posted: Wed Aug 29, 2007 12:10 pm Post subject:

Je comprends que les tableaux ne soient pas simples (c'est difficilement simplifiable, aussi !).

Pour l'insertion d'images, ce n'est pas très dur, c'est expliqué en 10 lignes ici :
http://wiki.mandriva.com/fr/Utiliser_le_Wiki#Ins.C3.A9rer_des_images

Si quelque chose n'est pas clair, n'hésitez pas.
_________________
Aide instantanée : retrouvez-moi sur http://chat.jabberfr.org/muckl_int/?room=mandriva
Contact Jabber :
Web : http://ofaurax.free.fr/

jln95

lebarhon · Posted: Sun Sep 02, 2007 4:31 pm Post subject:

La méthode que j'utilise pour créer un tableau est de faire un copier/coller d'un tableau existant (les premières lignes uniquement). La modif pour adapter le nombre de colonnes est simple.
Il est très facile aussi de copier/coller des modèles qui sont ici. Penser à passer en mode édition.
_________________
Athlon 64 3500+ - VIAK8T800Pro - 1024 DDR - Nvidia FX 5200

Fredxx · Posted: Sun Sep 02, 2007 6:43 pm Post subject:

Olivier FAURAX · Posted: Wed Sep 05, 2007 9:37 pm Post subject:

Ça, c'est de la coloration syntaxique, pas du wysiwyg.

En tout cas, merci pour vos remarques sur la page du wiki.
J'espère que vous ne serez pas trop déçus de voir qu'elle a été scindée en 2 et "réorganisée" (bien malgré moi).
Avant pour créer sa première page, faire un plan et des liens, il fallait 3 sections et 25 lignes de doc.
Maintenant, c'est 5 sections et 60 lignes, réparties sur 2 pages.

Je suis désolé.
_________________
Aide instantanée : retrouvez-moi sur http://chat.jabberfr.org/muckl_int/?room=mandriva
Contact Jabber :
Web : http://ofaurax.free.fr/

Fredxx · Posted: Thu Sep 06, 2007 7:22 am Post subject:

Olivier FAURAX · Posted: Thu Sep 06, 2007 8:27 am Post subject:

J'ai pas dit que la coloration syntaxique c'était inutile, hein.

La coloration syntaxique aide à écrire du code correct.
La wysiwyg cache le code en permettant l'édition "graphique".

Vu la facilité avec laquelle papajaac à transcrit son tutorial pour gdm, je suis pas sûr que ça vaille le coup d'avoir du wysiwyg.

M'enfin bon, si c'est désactivable et qu'il y a des gens pour installer/maintenir l'extension, pourquoi pas.
Il faut voir aussi si un grand nombre de boutons n'est pas effrayant pour un débutant : "Houlà, y a pleins de trucs, je comprends pas à quoi ça sert".
_________________
Aide instantanée : retrouvez-moi sur http://chat.jabberfr.org/muckl_int/?room=mandriva
Contact Jabber :
Web : http://ofaurax.free.fr/

PapaJaac · Posted: Thu Sep 06, 2007 11:04 am Post subject:

Permettez-moi de redonner en vrac mon avis sur l'existant après ce premier essai :

- c'était un texte très court au plan simple donc la structuration a été rapide (mettre des = ça va vite)
- j'ai trouvé utilisable et même pratique la panoplie de boutons en haut car elle s'applique à la sélection, comme le BBCode des forums. Cependant je n'ai pas essayé tous les boutons.
- j'ai eu des soucis avec la numérotation : si je mets un retour à la ligne dans un paragraphe numéroté ça casse la numérotation du suivant
- je peux me passer du Wysiwyg pour des textes courts, mais j'aurais du mal avec un article un peu long (alterner saisie / visualisation / saisie c'est quand même une sacrée régression fonctionnelle par rapport à un bête traitement de texte)

P.S. ah oui, il me faut intégrer les notions de thèmes / catégories etc... Les explications sont claires, il me manque juste un peu de pratique.
_________________
Quelques conseils judicieux...
"Le droit au rêve a pour pendant le devoir de vigilance" (H. Broch)

Olivier FAURAX · Posted: Thu Sep 06, 2007 11:20 am Post subject:

Pour la numérotation : si tu reviens à la ligne, mediawiki pense que tu as terminé ta liste.

Si les retours à la ligne étaient inclu dans la numérotation, il n'y aurai aucun moyen de sortir d'une liste ! (ben ouais, tout le texte suivant un # ferait partie du dernier numéro)

Pour les textes longs, je conseille toujours de commencer par faire le plan.
Ainsi, plutôt que d'écrire un gros texte et de le visualiser en entier, tu peux utiliser les [modifier] dans les sections et sous-sections.
Cela permet d'écrire un gros texte, comme un ensemble de petits : la visualisation est plus rapide.

Et je te donne une petite astuce : dans le mode édition, alt+shift+p lance la prévisualisation (comme si tu avais cliqué sur sur "Prévisualiser").
Ça marche au moins avec Firefox, peut être avec Konqueror.
_________________
Aide instantanée : retrouvez-moi sur http://chat.jabberfr.org/muckl_int/?room=mandriva
Contact Jabber :
Web : http://ofaurax.free.fr/