•  » Utilisation
  •  » [wiki] Documentation - Remarques en tous genres

#1 2009-12-23 00:00:18

Gotcha
Ex Equipe Piwigo
Pierrelatte (26)
2007-03-14
13331

[wiki] Documentation - Remarques en tous genres

Fait suite au sujet: [Forum, topic 10840] [WIKI] Refonte (v2.1) 22 Déb. 2009
Ancien titre : [wiki v2.1] Remarques en tous genres



Bonjour à tous,

Ca y est, le wiki nouveau, tel un cadeau du Papa Noël est enfin arrivé en ligne pour la joie de petits et surtout des grands !

Ce wiki (documentation) s'est vu enrichi de nouveaux plugins lui aussi et son contenu est en train d'être revu entièrement. Des discussions sont en cours afin de savoir si la documentation très technique ne passera pas dans un wiki dédié à la technique pure.

La version de ce wiki est estampillée v2.1 Ce n'est pas du tout en rapport avec la version de Piwigo. C'est juste qu'un premier remaniement du wiki (Juillet 2009) était intervenu et que là encore, un gros coup de pinceau et une bonne dose de patience ont été nécessaire pour vous proposer la présente documentation.

Encore une fois, les auteurs de la documentation c'est VOUS et toute l'équipe de Piwigo se joint à moi pour remercier les anciens contributeurs ainsi que les futurs volontaires. Un paragraphe vous est consacré.

A présent, je vous laisse la parole afin de recueillir vos impressions.

Merci.


Ayez comme premier réflexe de consulter le wiki.
Ensuite, veuillez effectuer une recherche sur le forum avant de poser votre question.

LE FAIRE EST LE REVELATEUR DE L'ETRE

Hors ligne

#2 2009-12-23 00:19:48

Gotcha
Ex Equipe Piwigo
Pierrelatte (26)
2007-03-14
13331

Re: [wiki] Documentation - Remarques en tous genres

L'ancien wiki a était conservé en archive et sera consultable plus tard.

Liste non exhaustive des opérations réalisées:


Encore une fois, une bonne documentation c'est très important. Le défis étant que ce soit complet mais consultable du plus grand nombre.
- La première évolution est d'ordre esthétique avec un changement important de la page d'accueil => meilleur découpage.
- Le wiki est désormais affiché sur une colonne centrale d'une dimension fixe de 960px (standard) afin que les utilisateurs d'une résolution de 1024px ne soient pas pénalisés avec un affichage tout bizarroïde.
- Le "fil d'Ariane" est remplacer par un affichage hiérarchique plus compréhensible (il me semble...). Il suffit de remonter de niveaux.
- Meilleurs découpage des différents "thèmes".
- Mélange judicieux de menus à accès rapide et de menus complets.
- A part les dernières page de rang bas, les autres pages devront disposer en bas de page d'un menu automatique (appelé aussi "mini-sommaire")
- Les pages peuvent désormais afficher des colonnes.
- Des "box" d'informations, exclamation, de questionnement, d'avertissement etc sont disponibles.
- Mise à jour des core (script) du Dokuwiki et des plugins.
|- Une amélioration des possibilités d'écriture. Plus de choix.
|- Bonne nouvelle, les liens qui étaient commentés maintenant détectent si le lien est brisé ou non. Avant, dès que l'on écrivait [[www.ceci_est_un_lien.com|son commentaire]]. Le lien apparaissait systématiquement comme valide ce qui rendait compliqué le travail de vérification.
- La grande nouveauté va résider aussi dans le fait que je prévois d'expliquer le fonctionnement de sa galerie suivant si l'on se place coté administrateur et coté visiteur. Nombreux screenshot pour expliquer les réglages et renvoi vers la documentation détaillées pour en expliquer le principe même des différentes fonctions. En somme, j'explique simplement dans ces pages les réglages sans trop rentrer dans les tenants et les aboutissants.
- Suppressions des anciennes révisions. Oui... j'ai telement remanier le wiki que les pages anciennes n'ont plus grand chose à voir avec les nouvelles. Les anciens liens se retrouvant brisées, et les nouvelles pages pouvant déjà apparaître avec 200 révisions par ma seule personne, j'ai opté pour partir sur une base saine. J'ai néanmoins ajouté un mot à l'attention des contributeurs (passés et futurs).
- La structure des pages à étaient totalement revue pour mieux coller avec l'affichage de la page d'accueil.
- Une "fiche" est désormais présente en en-tête de certaines pages qui prévenir les lecteurs.
- Un système de "backlinks" est mis en place. Dès qu'une page est cité dans une autre, le système collectera tout ces liens.
- Ajout d'un plugin pour les vidéo de Dailymotion (deviner pourquoi lol).
- Ajout d'un plugin "lightbox" pour les captures d'écran qui le nécessitent.
- Ajout d'un plugin de purge du cache et des purge des révisions.
- Ajout d'un plugin qui affiche les révisions réalisées par un membre (choix parmis toute la liste, donc intérêt moindre à moins de ciblé la personne).
- Ajout d'un plugin de liens "backlinks"

Ce qu'il reste à faire :
- S'assurer que les couleurs passent bien pour tout le monde.
- Continuer à compléter la documentation.
- Revoir l'affichage des icônes du plugin indexmenu


Ayez comme premier réflexe de consulter le wiki.
Ensuite, veuillez effectuer une recherche sur le forum avant de poser votre question.

LE FAIRE EST LE REVELATEUR DE L'ETRE

Hors ligne

#3 2009-12-23 02:18:44

plg
Équipe Piwigo
Nantes, France, Europe
2002-04-05
12672

Re: [wiki] Documentation - Remarques en tous genres

Déjà dit en privé à Gotcha, mais ce serait parfaitement injuste de ne pas le répéter en public : Gotcha, c'est ENORME ce nouveau wiki. Du très beau boulot, on repart sur une base beaucoup plus 1) propre 2) structurée 3) présentable que l'ancien wiki. Pour ceux qui ont oublié l'ancien wiki, ça ressemble au wiki anglophone, qui fait tellement miteux à côté du wiki francophone que je ne donne volontairement pas le lien !

Le "Vous êtes ici" (fil d'ariane hierarchique plutôt qu'historique) je trouve ça nettement mieux après quelques jours d'utilisation. Nettement mieux.

L'affichage par colonne, miam. Les box WRAP, miam. Les couleurs des box, un peu moins miam, mais miam quand même (on a bossé dessus Gotcha et moi la nuit dernière et ce soir).

Les "fiches", je ne suis pas encore convaincu (ni dans un sens ni dans l'autre).

Le "pour aller plus loin" (ou mini-sommaire, va falloir être clair sur le vocabulaire, que tout le monde se comprenne), j'étais interrogatif la première fois que je l'ai vu, Gotcha m'a expliqué, et maintenant je trouve ça très bien.

La colonne centrale à largeur fixe, j'adore (ok, je triche, c'est moi le demandeur)

Merci père Noël :-)


Les historiens ont établi que Pierrick était le premier utilisateur connu de Piwigo.

Hors ligne

#4 2009-12-23 02:22:08

plg
Équipe Piwigo
Nantes, France, Europe
2002-04-05
12672

Re: [wiki] Documentation - Remarques en tous genres

Astuce pour ceux qui veulent faire d'autres propositions de couleur pour les boîtes WRAP :

1. lancez Firefox
2. installez Firebug
3. allez sur http://fr.piwigo.org/doc
4. ouvrez Firebug (F12)
5. cliquez sur l'icône "Click an element in the page to inspect"
6. cliquez sur la boîte
7. dans la zone "Style" de Firebug, changez la couleur (oui comme ça, en live, ça va s'appliquer à la page, c'est magique)
8. faites nous un retour de votre expérience :-)


Les historiens ont établi que Pierrick était le premier utilisateur connu de Piwigo.

Hors ligne

#5 2009-12-23 07:34:25

tosca
Former Piwigo Team
Cévennes (Gard)
2006-09-23
3818

Re: [wiki] Documentation - Remarques en tous genres

Gotcha a écrit:

Des discussions sont en cours afin de savoir si la documentation très technique ne passera pas dans un wiki dédié à la technique pure.

Ca ne serait effectivement pas une mauvaise chose de séparer un peu plus clairement "doc utilisateur" et "doc technique/développeur/niveau avancé".
Je ne sais pas si il vaut mieux 2 wikis séparés, ou si une bonne structuration suffit. A partir d'un certain volume, on ne peut de toute manière plus se contenter d'une liste de rubriques non hiérarchisée ; il faut un vrai plan de document, avec chapitres, rubriques, etc. auquel rattacher les pages existantes et futures.

Hors ligne

#6 2009-12-23 07:42:42

tosca
Former Piwigo Team
Cévennes (Gard)
2006-09-23
3818

Re: [wiki] Documentation - Remarques en tous genres

Gotcha a écrit:

- Suppressions des anciennes révisions. Oui... j'ai telement remanier le wiki que les pages anciennes n'ont plus grand chose à voir avec les nouvelles. Les anciens liens se retrouvant brisées, et les nouvelles pages pouvant déjà apparaître avec 200 révisions par ma seule personne, j'ai opté pour partir sur une base saine. J'ai néanmoins ajouté un mot à l'attention des contributeurs (passés et futurs).

+1
On ne peut pas être et avoir été ... Les nouveaux arrivants, ceux qui ont le plus besoin de la doc, s'y retrouveront nettement mieux, sans avoir à retirer les toiles d'araignée au préalable ;)

plg a écrit:

ça ressemble au wiki anglophone, qui fait tellement miteux à côté du wiki francophone que je ne donne volontairement pas le lien !

Je vais peut-être me remettre celui en français alors ; parce que je me trouvais, moi aussi, beaucoup plus à l'aise sur l'anglais.

Hors ligne

#7 2009-12-23 08:16:29

VDigital
Former Piwigo Team
Montpellier (FR)
2005-05-04
15127

Re: [wiki] Documentation - Remarques en tous genres

Je suis assez surpris que personne ne remonte en tout premier point "la lisibilité" (déjà à l'honneur récemment).

"Avant de vous lancer tête la première dans une administration hasardeuse de votre galerie, ..."

Gris clair sur gris pas foncé... => Plus de contraste.

Un wiki pour être lu doit avant tout être lisible.

(Le fond #111 doit rester pour l'homogénéité du site, mais le texte en couleur #999, doit #être #en #ccc au moins).
Et les couleurs bizarroïdes, non chartées bien entendu, sont à éviter elles ne facilitent pas la lecture. Elles font fuir le malheureux lecteur (déjà que sa vue baisse, on ne l'aide pas à trouver et à vouloir revenir chercher).

Je suis un peu cassant, je sais, mais si je ne le dis pas ainsi, cela ne fait pas réfléchir.

Merci pour la restructuration, il y en avait vraiment besoin.


Vincent -« Plus vidéaste averti que photographe amateur... »
La galerie - Le blog   

Piwigo est une application libre de gestion de photos en ligne.

Hors ligne

#8 2009-12-23 08:28:19

tosca
Former Piwigo Team
Cévennes (Gard)
2006-09-23
3818

Re: [wiki] Documentation - Remarques en tous genres

VDigital a écrit:

Je suis assez surpris que personne ne remonte en tout premier point "la lisibilité" (déjà à l'honneur récemment).

"Avant de vous lancer tête la première dans une administration hasardeuse de votre galerie, ..."

Gris clair sur gris pas foncé... => Plus de contraste.

Un wiki pour être lu doit avant tout être lisible.
...

Je suis un peu cassant, je sais, mais si je ne le dis pas ainsi, cela ne fait pas réfléchir.
...

Je n'ai pas souhaité en remettre en couche, ayant déjà eu l'occasion de m'exprimer sur le sujet par ailleurs.
Mais c'est clair que ... j'ai beaucoup de mal à lire/analyser du texte dans ces conditions. Ca ne concerne d'ailleurs pas que le wiki : même problème sur les pages d'extensions par exemple, mais on y passe a priori moins de temps.

Hors ligne

#9 2009-12-23 12:26:52

Gotcha
Ex Equipe Piwigo
Pierrelatte (26)
2007-03-14
13331

Re: [wiki] Documentation - Remarques en tous genres

Décidément, les couleurs ne sont pas à la fête :-(

Il ne faut pas hésiter, comme l'a fait VDigital à faire des remarques. Ce sujet est là pour ça !


Ayez comme premier réflexe de consulter le wiki.
Ensuite, veuillez effectuer une recherche sur le forum avant de poser votre question.

LE FAIRE EST LE REVELATEUR DE L'ETRE

Hors ligne

#10 2009-12-23 12:33:33

tosca
Former Piwigo Team
Cévennes (Gard)
2006-09-23
3818

Re: [wiki] Documentation - Remarques en tous genres

Gotcha a écrit:

Décidément, les couleurs ne sont pas à la fête :-(

Il ne faut pas hésiter, comme l'a fait VDigital à faire des remarques. Ce sujet est là pour ça !

J'ai crois avoir tout dit ici -> [Forum, topic 15028] Mes yeux n'ont plus 20 ans ...

VDigital a écrit:

Un wiki pour être lu doit avant tout être lisible.

+15 (au moins !)

Hors ligne

#11 2009-12-23 15:00:13

plg
Équipe Piwigo
Nantes, France, Europe
2002-04-05
12672

Re: [wiki] Documentation - Remarques en tous genres

extrait brut de notre conversation quelques secondes avant la mise en prod avec Gotcha:

(10:07:14 PM) plg: ok, bon ben on y va comme ça ?
(10:07:35 PM) plg: on verra l'avis des utilisateurs et on ajustera pour les couleurs éventuellement ?
(10:07:46 PM) Gotcha: juste un dernier essai pour voir avec une écrire plus blanche encore
(10:07:53 PM) Gotcha: (pour le confort de certains)
(10:07:54 PM) plg: ah oui pardon, j'ai changé en local
(10:08:24 PM) plg: #777 c'est déjà bien, et #888 c'est bien lisible
(10:08:49 PM) Gotcha: et donc pas #999 ?
(10:09:06 PM) plg: carrément ? j'essaie pour voir
(10:09:44 PM) plg: sur le fond #111 je ne vois pratiquement pas la différence entre le texte #888 et #999
(10:10:55 PM) Gotcha: alors il vaut mieux prendre #999
(10:11:06 PM) Gotcha: si toi tu ne le vois pas, d'autres peuvent le voir
(10:11:14 PM) plg: partons comme ça alors
(10:11:38 PM) Gotcha: (un spécialiste nous répondra si c'est bien ou pas)
(10:11:55 PM) Gotcha: donc tu valides mes couleurs atténuées ? :$
(10:12:42 PM) plg: je valide pour gagner du temps oui :-)
(10:13:29 PM) plg: et je dis : faisons confiance aux retours des utilisateurs, ils ne manqueront pas de donner leur avis. Et à nous d'être souples pour adapter à leur demande
(10:13:53 PM) plg: (et pas les forcer comme on a fait un peu brutalement avec le thème sylvia sur piwigo.org)
(10:14:51 PM) Gotcha: Oui, Tosca à eu raison de faire une picure de rapel
(10:15:10 PM) plg: tout à fait
(10:15:25 PM) plg: (faut que je lui réponde à propos de Digikam d'ailleurs)

Bref... on a "allumé" la lumière en passant le texte de #666 ) #999 déjà. Si vous voulez qu'on pousse encore, suffit de demander :-)

Et voilà, c'est en #ccc. Moi je trouve ça un peu trop blanc, mais j'attends vos avis.


Les historiens ont établi que Pierrick était le premier utilisateur connu de Piwigo.

Hors ligne

#12 2009-12-23 15:14:31

tosca
Former Piwigo Team
Cévennes (Gard)
2006-09-23
3818

Re: [wiki] Documentation - Remarques en tous genres

Je me sens un peu obligée de répondre ;)
Je n'ai pas regardé dans le détail, juste "scanné" rapidement quelques pages pour voir. Un exemple ci-dessous : pourquoi y a-t-il deux nuances pour le texte, l'un très (un chouilla de trop ?) contrasté, l'autre pas tout à fait assez. S'il n'y a pas d'intérêt particulier à avoir les deux teintes, j'opterais pour une qui soit à mi-chemin entre les deux.

J'aime beaucoup la couleur des fiches, sobres et très lisibles.

Et je reste une irréductible réfractaire à ce rose corail ... que j'apprécie beaucoup lorsqu'il s'agit d'une fleur, mais trouve très fatigant (flashy ?) à lire sur fond sombre.

Hors ligne

#13 2009-12-23 15:33:17

plg
Équipe Piwigo
Nantes, France, Europe
2002-04-05
12672

Re: [wiki] Documentation - Remarques en tous genres

tosca a écrit:

Je n'ai pas regardé dans le détail, juste "scanné" rapidement quelques pages pour voir. Un exemple ci-dessous : pourquoi y a-t-il deux nuances pour le texte, l'un très (un chouilla de trop ?) contrasté, l'autre pas tout à fait assez.

Mais parce que j'ai fait une erreur :-) tout simplement. Corrigé, tout est passé en #ccc (enfin j'espère). Si tu trouves ça trop, et que #999 ne l'était pas assez, je peux passer en #aaa ou #bbb (pour n'utiliser que les 16 nuances principales de gris, après on peut faire encore plus fin évidemment)


Les historiens ont établi que Pierrick était le premier utilisateur connu de Piwigo.

Hors ligne

#14 2009-12-23 15:47:25

tosca
Former Piwigo Team
Cévennes (Gard)
2006-09-23
3818

Re: [wiki] Documentation - Remarques en tous genres

En fait, ça n'est pas/plus la couleur de la police qui est gênant, mais le background de certains blocs qui est un peu trop clair, et ne ménage pas suffisamment de contraste.
Par exemple, le bloc ci-dessous, mais j'ai beau faire, je n'arrive pas à changer sa couleur avec Firebug :/
C'est bien .wrap_box en #222 ... mais quoi que je fasse, il ne veut pas se modifier ...

Hors ligne

#15 2009-12-23 15:56:23

Neutre
Membre
Les Vans (Ardèche)
2009-06-14
449

Re: [wiki] Documentation - Remarques en tous genres

Allez, je met mon grain de sel (de Guérande, bien sûr).

Bravo pour les fiches. le contraste va mieux maintenant.

Reste le thème général avec son fond noir (et ses caractères corail et orange, voire rouge) qui une fois passé le coté sympa de la nouveauté, rend le texte un peu pénible à lire (trop de contraste global sûrement). Les textes sur fond gris, il y en a paraissent en regard beaucoup plus reposant pour mes vieux yeux

Bon, mais tout cela n'est rien au regard du travail de remise en forme et de la capacité à accéder facilement aux informations utiles pour les "jeunes" Piwigistes

Merci Gotcha, toujours sur la brèche et toujours prêt à donner un coup de main !

Jean


Jean et sa galerie Piwigo... Les Photographies de Jean
et puis aussi la météo des Vans La Météo des Gras de Naves

Hors ligne

  •  » Utilisation
  •  » [wiki] Documentation - Remarques en tous genres

Pied de page des forums

Propulsé par FluxBB

github twitter newsletter Faire un don Piwigo.org © 2002-2024 · Contact