Refonte de la documentation

Répondre


Cette question est un moyen d’empêcher des soumissions automatisées de formulaires par des robots.
Smileys
:rireroule: :calin: :smak: :sifflote: :plusun: :thomas: :lol: :nico5: :prr: :papy: :tropfort: :cavachier: :penseur: :applaudis: :tchin: :igo: :ptdr: :angry: :faux: :furax: :cool: :boude: :confus: :sad: :run: :azn: :embarrassed: :smiley: :murbric: :grin: :laugh: :evil: :fccpu: :tuxwin: :jap: :love: :coucou: :hello: :cdmalad: :bienvenue:
Voir plus de smileys

Les BBCodes sont activés
[img] est activé
[flash] est désactivé
[url] est activé
Les smileys sont activés

Revue du sujet
   

Étendre la vue Revue du sujet : Refonte de la documentation

Re: Refonte de la documentation

par McDoul » 16 novembre 2011, 03:26

Oui XTypo c'est bien si c'est bien (et peu) utilisé, sinon la page devient plus un arc-en-ciel qu'autre chose. Les notes de bas de page ont leur utilisée aussi mais c'est pas très important.

Sinon pour l'exemple j'ai refais la page https://libristes.boinc-af.net/pour-les ... linux.html

J'ai enlevé tous les styles, mis à jour les parties du texte qui n'avait pas de raison d'être (genre des liens vers des tuto "à venir") et ensuite j'ai formaté très très sommairement en mettant les titres en style Titre 1 et Titre 2. Rien de plus, rien de rien.
Bon le résultat est assez triste actuellement mais avec une feuille de style plus attrayante ça sera déjà un bon pas en avant vers la clareté et la cohérence visuelle. Du moment que le code des pages est bien carré, le style peut venir après sans que ça pose problème. :tuxwin:

Des avis?

Re: Refonte de la documentation

par jip » 15 novembre 2011, 21:20

McDoul a écrit :Ok ok.
Une autre solution sinon?

Je pense que les pré-requis sont :
- titres et sous-titres bien formattés.
- liens internes et externes propres (avec si possible un indicateur sur la langue de la page cible)
- table des matières
- aperçu / sauvegarde du brouillon
- un moyen pour virer le style de tout le texte pour qu'il redevienne vierge de tout formatage (pour la période de reconstuction des pages)
- éventuellement les notes de bas de page, mais on peut toujours mettre des gros bandeaux colorés comme là par exemple : https://libristes.boinc-af.net/calcul-p ... linux.html

toutes les autres fonctions servent à avoir Word dans son navigateur, c'est un peu too much vu ce qu'on en fait.

l'éditeur intégré JCE permet de créer des groupes pour lesquels on définit les boutons disponibles ou non.

pour ce qui est des styles type "bandeau", c'est l'utilisation du plugin XTypo qui est déjà intégré au portail, dont il est question là : https://libristes.boinc-af.net/utilisat ... ticle.html (qu'il faudrait remanier, enrichir, afin de fixer des règles plus précises) et là https://libristes.boinc-af.net/utilisat ... xtypo.html

malheureusement il n'y a plus, pour cette version de joomla, l'extension permettant d'ajouter des boutons à l'éditeur pour faciliter l'utilisation.

Pour forcer des modèles plus rigides et uniformes il y a des solutions là : http://extensions.joomla.org/extensions ... nstruction (jseblod, flexicontent, k2, etc ...).

Re: Refonte de la documentation

par McDoul » 15 novembre 2011, 09:06

Ok ok.
Une autre solution sinon?

Je pense que les pré-requis sont :
- titres et sous-titres bien formattés.
- liens internes et externes propres (avec si possible un indicateur sur la langue de la page cible)
- table des matières
- aperçu / sauvegarde du brouillon
- un moyen pour virer le style de tout le texte pour qu'il redevienne vierge de tout formatage (pour la période de reconstuction des pages)
- éventuellement les notes de bas de page, mais on peut toujours mettre des gros bandeaux colorés comme là par exemple : https://libristes.boinc-af.net/calcul-p ... linux.html

toutes les autres fonctions servent à avoir Word dans son navigateur, c'est un peu too much vu ce qu'on en fait.

Re: Refonte de la documentation

par jip » 12 novembre 2011, 10:54

Bon quelques tests ce matin vite fait sur l'extension JB Type sur serveur local.

JB type en lui même a l'air de pas trop mal fonctionner.

Par contre l'essentiel a l'air de se situer du coté du plugin JCE : "JCE JB Type plugin" ( http://docs.joomlabamboo.com/item/742-j ... umentation )

Il a quelques dysfonctionnements dans la construction de la liste de la combo, sur le rafraichissement après avoir appliquer un choix, sur l'application de plusieurs style au même texte, et pas mal de manque coté élément de la liste par rapport aux possibilités de tags de "JB Type".

De plus, il n'est pas encore compatible avec la dernière version de JCE (JCE2). Là c'est encore JCE1.5 max (certes c'est la version que l'on a sur notre portail, mais bon ...).

C'est du javascript. Donc si y'en a qui se sente de pondre une version déverminée et plus complète ....

Mais là, en l'état, je le vois pas trop sur notre portail pour le moment.

Re: Refonte de la documentation

par McDoul » 12 novembre 2011, 03:58

Ok, ça presse pas de toute façon. Pendant ce temps je trafique un peu les articles actuels.

Re: Refonte de la documentation

par jip » 11 novembre 2011, 18:54

McDoul a écrit :Alors l'idée du statu quo est retenue?
Même pas d'extension wiki?
non pas forcément, mais faut voir avec elgrande pour ouvrir un espace sur son serveur et tester une solution wiki ...

tu pourras nous y montrer la personnalisation graphique, la récupération du contenu, et on pourra tester tout ça en réel après ...

si ça remporte l'adhésion, y'a pas de raison de ne pas adopter.

mais faudra prendre une décision pour limiter les espaces à gérer ensuite de toute façon.

on est toujours pas dimensionné pour gérer 3 espaces. déjà avec 2, des fois, on rame ...

Re: Refonte de la documentation

par jip » 11 novembre 2011, 18:47

Bon petit pb d'install de l'extension "jb type" ...

va falloir que je vois la question avec elgrande du coté serveur ...

et ensuite, quand ce sera régler pour l'installation, faudra que je teste le bon fonctionnement ...

c'est pas encore gagné cette affaire ...

Re: Refonte de la documentation

par jip » 11 novembre 2011, 13:55

donc j'implante l'extension et après tu gère, vu que t'as été bombardé rédacteur direct ???

Re: Refonte de la documentation

par McDoul » 11 novembre 2011, 13:39

C'est joli tout ça :love:

J'en profite pour redire que je suis volontaire pour le nettoyage et la remise en forme (et en valeur) des infos de la doc.

Re: Refonte de la documentation

par jip » 11 novembre 2011, 13:24

coté mise en forme, j'envisage de remplacer XTypo avec lequel il faut connaitre les balises et les saisir manuellement.

j'ai vu quelque chose de similaire et plus accessible (et déjà compatible avec 3 version différentes de joomla) : http://extensions.joomla.org/extensions ... R5bGUnIjt9 , http://docs.joomlabamboo.com/item/742-j ... umentation

par contre si je fais ça, ça va obliger à reprendre les articles utilisant XTypo avec le nouveau plugin ... y'aura des volontaires ?

Re: Refonte de la documentation

par jip » 11 novembre 2011, 13:16

ben peut-être déjà retravailler l'existant avant tout autre chose, non ?

Re: Refonte de la documentation

par McDoul » 11 novembre 2011, 13:06

jip a écrit :@mcdoul : depuis que je t'ai passé rédacteur (droit Publieur, dans ce tableau : https://libristes.boinc-af.net/utilisat ... icles.html), tu es en mesure, de corriger, fusionner, dépublier, déplacer, les articles. donc si quelque chose te choque ou te vient à l'idée, tu es à présent en mesure de l'appliquer.

L'idéal, serait de faire comme ici et de monter une petite équipe de rédacteurs pour gérer le contenu du portail (les admins en principe gèrent la partie technique, mais peuvent participer).
Ok ça marche.
Alors l'idée du statu quo est retenue?
Même pas d'extension wiki?

Exprimez-vous :run:

Re: Refonte de la documentation

par jip » 11 novembre 2011, 10:54

@mcdoul : depuis que je t'ai passé rédacteur (droit Publieur, dans ce tableau : https://libristes.boinc-af.net/utilisat ... icles.html), tu es en mesure, de corriger, fusionner, dépublier, déplacer, les articles. donc si quelque chose te choque ou te vient à l'idée, tu es à présent en mesure de l'appliquer.

L'idéal, serait de faire comme ici et de monter une petite équipe de rédacteurs pour gérer le contenu du portail (les admins en principe gèrent la partie technique, mais peuvent participer).

Re: Refonte de la documentation

par Gillou40 » 07 novembre 2011, 07:20

2/ Pour le forum une idée qui marche ailleurs c'est d'archiver ce qui est un peu dépassé. Ca permet de garder des sections suffisament à jour sans perdre de l'info. L'utilisateur qui consulte les archives sait que les infos ne sont plus forcément à jour mais peut toujours essayer d'appliquer ce qu'il y lit ou s'en servir de base pour poser des questions.


C'est justement ce qui est en cours... On a pas mal purgé la BDD, et archivé des infos d'intérêt général.

On est en train de nettoyer les recoins (ou quand modérateur rime avec aspirateur) :igo:

Re: Refonte de la documentation

par McDoul » 07 novembre 2011, 02:38

Gillou40 a écrit :Bonjour :hello:

Mon avis là dessus:

1/ Le portail. L'idée du wiki est une sorte de mélange des genres. Il est utile, mais est-ce notre rôle ? Il est vrai que le portail, je n'y vais pas très souvent, mais il contient des infos très utiles à tous. A mon avis, le portail doit exister, contenir des infos attractives (difficile), et vivre (le plus dur). Après, les admins du portail, les modos du forum ont un rôle à jouer pour un seule entité, la MT Libristes. Les actions de chacun doivent aller (et vont) dans une direction unique, la promotion de notre MT.

2/ Le forum (qui est en cours de "nettoyage") doit être un espace actif de dialogue et de convivialité. C'est beaucoup de boulot pour l'équipe, avec les contraintes de temps de chacun. Tout le monde est motivé pour le faire évoluer, c'est l'objet de discussions en cours, pas simples mais qui avanceront avec le temps. Pour moi, le forum est un acteur important de notre promotion et de nos actions. Il doit être remodelé (on y travaille) et actualisé (ce qui est fait par la contribution des acteurs "actifs").

Loin d'une révolution, même si le terme est exagéré, on doit consolider et faire vivre les outils que nos chers libristes utilisent en coopération. La discussion est ouvert, j'ai toujours considéré que la critique reste constructive, utilisons là pour faire évoluer les choses.

:penseur:


1/ C'est sûr que les infos sont de qualité et utiles, l'idée est juste de les mettre en valeur le mieux possible en les rendant claires et organisées.
2/ Pour le forum une idée qui marche ailleurs c'est d'archiver ce qui est un peu dépassé. Ca permet de garder des sections suffisament à jour sans perdre de l'info. L'utilisateur qui consulte les archives sait que les infos ne sont plus forcément à jour mais peut toujours essayer d'appliquer ce qu'il y lit ou s'en servir de base pour poser des questions.

Haut