Refonte de la documentation

Une opinion, une idée, quelque chose à améliorer ? Exprimez vous ici
Avatar du membre
McDoul
Zone privée MT Libristes
Zone privée MT Libristes
Messages : 71
Enregistré le : 12 février 2009, 20:46

Re: Refonte de la documentation

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

Avatar du membre
jip
Administrateur
Administrateur
Messages : 2607
Enregistré le : 22 février 2008, 21:00
Localisation : Toulouse
Contact :

Re: Refonte de la documentation

Messagepar jip » 11 novembre 2011, 13:16

ben peut-être déjà retravailler l'existant avant tout autre chose, non ?
Un synonyme, c'est un mot qu'on écrit pour remplacer celui dont on ne connait pas l'orthographe. (source inconnue). L'imagination est plus importante que le savoir. (Albert Einstein)

Image


BoincLibristes, FreeTorrent, Ma brute

Avatar du membre
jip
Administrateur
Administrateur
Messages : 2607
Enregistré le : 22 février 2008, 21:00
Localisation : Toulouse
Contact :

Re: Refonte de la documentation

Messagepar 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 ?
Un synonyme, c'est un mot qu'on écrit pour remplacer celui dont on ne connait pas l'orthographe. (source inconnue). L'imagination est plus importante que le savoir. (Albert Einstein)

Image


BoincLibristes, FreeTorrent, Ma brute

Avatar du membre
McDoul
Zone privée MT Libristes
Zone privée MT Libristes
Messages : 71
Enregistré le : 12 février 2009, 20:46

Re: Refonte de la documentation

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

Avatar du membre
jip
Administrateur
Administrateur
Messages : 2607
Enregistré le : 22 février 2008, 21:00
Localisation : Toulouse
Contact :

Re: Refonte de la documentation

Messagepar 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 ???
Un synonyme, c'est un mot qu'on écrit pour remplacer celui dont on ne connait pas l'orthographe. (source inconnue). L'imagination est plus importante que le savoir. (Albert Einstein)

Image


BoincLibristes, FreeTorrent, Ma brute

Avatar du membre
jip
Administrateur
Administrateur
Messages : 2607
Enregistré le : 22 février 2008, 21:00
Localisation : Toulouse
Contact :

Re: Refonte de la documentation

Messagepar 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 ...
Un synonyme, c'est un mot qu'on écrit pour remplacer celui dont on ne connait pas l'orthographe. (source inconnue). L'imagination est plus importante que le savoir. (Albert Einstein)

Image


BoincLibristes, FreeTorrent, Ma brute

Avatar du membre
jip
Administrateur
Administrateur
Messages : 2607
Enregistré le : 22 février 2008, 21:00
Localisation : Toulouse
Contact :

Re: Refonte de la documentation

Messagepar 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 ...
Un synonyme, c'est un mot qu'on écrit pour remplacer celui dont on ne connait pas l'orthographe. (source inconnue). L'imagination est plus importante que le savoir. (Albert Einstein)

Image


BoincLibristes, FreeTorrent, Ma brute

Avatar du membre
McDoul
Zone privée MT Libristes
Zone privée MT Libristes
Messages : 71
Enregistré le : 12 février 2009, 20:46

Re: Refonte de la documentation

Messagepar McDoul » 12 novembre 2011, 03:58

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

Avatar du membre
jip
Administrateur
Administrateur
Messages : 2607
Enregistré le : 22 février 2008, 21:00
Localisation : Toulouse
Contact :

Re: Refonte de la documentation

Messagepar 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.
Un synonyme, c'est un mot qu'on écrit pour remplacer celui dont on ne connait pas l'orthographe. (source inconnue). L'imagination est plus importante que le savoir. (Albert Einstein)

Image


BoincLibristes, FreeTorrent, Ma brute

Avatar du membre
McDoul
Zone privée MT Libristes
Zone privée MT Libristes
Messages : 71
Enregistré le : 12 février 2009, 20:46

Re: Refonte de la documentation

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

Avatar du membre
jip
Administrateur
Administrateur
Messages : 2607
Enregistré le : 22 février 2008, 21:00
Localisation : Toulouse
Contact :

Re: Refonte de la documentation

Messagepar 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 ...).
Un synonyme, c'est un mot qu'on écrit pour remplacer celui dont on ne connait pas l'orthographe. (source inconnue). L'imagination est plus importante que le savoir. (Albert Einstein)

Image


BoincLibristes, FreeTorrent, Ma brute

Avatar du membre
McDoul
Zone privée MT Libristes
Zone privée MT Libristes
Messages : 71
Enregistré le : 12 février 2009, 20:46

Re: Refonte de la documentation

Messagepar 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?