Forum CMS Made Simple FR
Histoire d'un bébé fork : User's guide. - Version imprimable

+- Forum CMS Made Simple FR (https://forum.cmsmadesimple.fr)
+-- Forum : Annonces (https://forum.cmsmadesimple.fr/forum-5.html)
+--- Forum : Annonces (https://forum.cmsmadesimple.fr/forum-17.html)
+--- Sujet : Histoire d'un bébé fork : User's guide. (/thread-2372.html)

Pages : 1 2 3


Histoire d'un bébé fork : User's guide. - jissey - 18/11/2012

Bonjour à tous,
à chaque création de site, j'explique aux utilisateurs le fonctionnement de leur site: PDF, animations parfois, le tout personnalisé.

J'avais essayé le module OwnersManual il a quelques temps mais je le trouvais trop basique.
C'est un module qui permet au webmaster de saisir des instructions, de l'aide, etc... pour l'utilisateur.
J'espérais que le Dev le fasse évoluer comme indiqué dans son Roadmap, mais que nenni.
Je l'ai donc fait évolué à titre perso, et évidemment, j'ai fini par ré-écrire les 9/10èmes.
Une fois terminé, je lui ai proposé ma version pour qu'il la publie. Comme je n'ai pas suivi son Roadmap, en tout cas dans le design, il a rejeté mon offre : lui part sur une table des matières avec des liens, et moi j'ai fait des onglets...
Bon, j'ai hésité à le publier, mais après tout, si ça peut servir à quelqu'un, j'ai fait un fork,sachant que OwnersManual va bientôt être publié dans sa nouvelle version.
Vous pouvez le trouver ici :
http://dev.cmsmadesimple.org/projects/usersguide
Enjoy.


Histoire d'un bébé fork : User's guide. - bess - 18/11/2012

J'aime !

Je suis en train de l'utiliser et j'ai déjà plein de features à te faire ajouter Big Grin (si tu les souhaites évidement)

-Remanier la page des options, j'ai du faire des tests avant de comprendre à quoi servaient les deux options, je pensais à tord qu'elles étaient liées d'ailleurs ... Un petit texte descriptif serait le bienvenue je penses.

-Proposer l'édition d'une page DANS la page et non pas dans un onglet à part, ça aussi ça m'a perturbé (10'). Ce serait aisé de mettre un bon gros bouton "édition" dans le haut d'une page pour accéder directement à son édition.

-Proposer l'onglet dans lequel afficher le module (CMS par défaut actuellement), ainsi j'ai mon utilisateur qui va aller uniquement dans Contenu, j'ai tout intérêt à le laisser dedans Smile

Très bon petit module en tout cas, et je n'en ai pas fait le tour encore (Smarty notamment)


Histoire d'un bébé fork : User's guide. - Jean le Chauve - 18/11/2012

Je vais tester tout de suite car j'utilise normalement des news comme manuel (ce qui n'est certes pas la meilleure solution).


Histoire d'un bébé fork : User's guide. - Jean le Chauve - 18/11/2012

Hum, je n'ai pas encore compris comment afficher ce guide :p
Il faut mettre une tag quelque part ?


Histoire d'un bébé fork : User's guide. - jissey - 18/11/2012

Tu vas dans le menu CMS.


Histoire d'un bébé fork : User's guide. - Jean le Chauve - 18/11/2012

Oui, j'avais vu Smile
Il manquait les permissions pour l'éditeur.


Histoire d'un bébé fork : User's guide. - bess - 18/11/2012

d'ailleurs ca serait bien une permission "voir tous les onglets" Wink

+ L'ordre serait logiquement un truc entre 1 et le nombre de page, pas zéro -> nbPage -1 Smile je n'ai pas réussit à change l'ordre des pages a ce propos (??)

++ une petite erreur php type notice (rien d'affolant) :

Notice: Undefined index: tab_error in /var/www/forma/www/cms/modules/UsersGuide/action.defaultadmin.php on line 41

+++ une erreur plus chiante par contre : l'insertion d'image déconne car la base url est /admin ce qui donne /admin/uploads/.... et du coup aucune image s'affiche Sad


Histoire d'un bébé fork : User's guide. - Jean le Chauve - 18/11/2012

C'est exactement ce dont j'avais besoin Smile
Il manque la possibilité d'intégrer une feuille css.

Excellent le titre du post, je n'avais pas saisi tout de suite :lol:


Histoire d'un bébé fork : User's guide. - bess - 18/11/2012

+1 pour la feuille CSS, notamment pour faire démonstration des style h1 - h2 - quote - ...

J'ai du pour contourner ce point réaliser une capture écran Smile


Histoire d'un bébé fork : User's guide. - Philipppe - 18/11/2012

Tiens, tiens ... du nouveau ... !
Moi, je commence bêtement par me demander au nom de quel fichu principe il faut que je me farcisse de déchiffrer le mode d'emploi en anglais .... ?
Y aurait-il encore un truc ... que je n'ai pas compris ?


Histoire d'un bébé fork : User's guide. - jissey - 18/11/2012

Désolé, Phil, comme je l'ai dit, c'est un fork.Déjà de re-ecrire le code....pfff...pardon, je n'ai pas traduit l'aide...
Pour tout le monde, j'étais dans mon "truc", je n'ai pas ajouté d'aide par rapport au module initial.
C'est juste histoire de partager les modifs que j'ai faites.


Histoire d'un bébé fork : User's guide. - Philipppe - 19/11/2012

jissey a écrit :Désolé, Phil, comme je l'ai dit, c'est un fork.Déjà de re-ecrire le code....pfff...pardon, je n'ai pas traduit l'aide...
Pour tout le monde, j'étais dans mon "truc", je n'ai pas ajouté d'aide par rapport au module initial.
C'est juste histoire de partager les modifs que j'ai faites.
Décidément, je suis le roi des gaffeurs !

J'ai le chic pour couper l'enthousiasme là !
...je vais m'occuper de la traduction ...., et vous, continuez à tester et faire évoluer !


Histoire d'un bébé fork : User's guide. - jissey - 19/11/2012

Merci tout le monde d'avoir testé.

- Chez moi, pas de problème avec les images : Microtiny 1.2.3. Les url sont absolues.
- Pour les CSS, dans les paramètres de Microtiny comme dans TinyMce, on peut gérer des styles. Ca n'est pas suffisant?
- Pour l'ordre, je commencerai ma boucle à 1, promis! Pourquoi yarien qui marche chez Bess? D'autres ont constatés un problème avec l'ordre des onglets?
- j'ai noté le Notice.

Bess a écrit :1 -Remanier la page des options, j'ai du faire des tests avant de comprendre à quoi servaient les deux options, je pensais à tord qu'elles étaient liées d'ailleurs ... Un petit texte descriptif serait le bienvenue je penses.

2 -Proposer l'édition d'une page DANS la page et non pas dans un onglet à part, ça aussi ça m'a perturbé (10'). Ce serait aisé de mettre un bon gros bouton "édition" dans le haut d'une page pour accéder directement à son édition.

3 -Proposer l'onglet dans lequel afficher le module (CMS par défaut actuellement), ainsi j'ai mon utilisateur qui va aller uniquement dans Contenu, j'ai tout intérêt à le laisser dedans smile

1 : Oui, ça manque d'explication.
2 : Oui si plus de demandes.
3 : Oui, bonne idée.

Prochaine release avec plus d'aide...OwnerManual étant ultra simple, il n'y avait rien.


Histoire d'un bébé fork : User's guide. - Jean le Chauve - 19/11/2012

Salut Jissey,
Le problème des css est que le module se réfère à la css du thème, située dans admin et pas celle du frontend.
Et donc, si un user change ses préférences et passe sous ncCleanGrey au lieu de oneEleven, tu l'as dans l'os (sans parler des upgrades du thème).
MicroTiny a bien des styles, mais ils correspondent aux feuilles de styles du frontend, et donc sont inutilisables à moins d'ajouter ces styles dans la css de l'admin.
Pour ma part, je n'ai pas de problème avec l'insertion d'images, le chemin est correct.


Histoire d'un bébé fork : User's guide. - bess - 19/11/2012

je revérifie l'ordre et les images au boulot aujourd'hui Wink

Jean le Chauve a bien expliqué le soucis de CSS, merci à lui


Histoire d'un bébé fork : User's guide. - jissey - 19/11/2012

ok, alors ajout d'une zone de saisie pour les CSS (puisque vous ne voulez pas vous servir des possibilités du WYSIWYG :p Big Grin ). Noté.


Histoire d'un bébé fork : User's guide. - bess - 19/11/2012

si si on veut utiliser le WYSIWYG ! le pb n'est pas là.

Exemple je veux montrer à mon utilisateur la différence entre h1 et h2 du point de vue rendu.

j'écris le texte

<h1>ceci est une balise h1</h1>
<h2>ceci est une balise h2</h2>

Le WYSIWYG me l'affiche en vert foncé de grande taille et vert clair de plus petite taille (css du front, tout est ok)

[Image: 2012-11-18_131226.png]

L'ennui est que une fois dans le module, pour voir le texte saisit, le CSS du front disparait ce qui donne des balises h1 et h2 tout noir...

Pour les images j'ai toujours un soucis. Le code est : <img width="255" height="291" alt="" src="uploads/quattro/2012-11-18_125946.png" style="float: left;"> ce n'est pas du tout absolu mais je ne penses pas que le soucis vienne de ton module...


Histoire d'un bébé fork : User's guide. - jissey - 19/11/2012

Ha! OK! Désolé, un peu lourd sur le coup!


Histoire d'un bébé fork : User's guide. - Philipppe - 19/11/2012

Heu ... j'ai fait la traduction en regardant le grand prix de F1 cette nuit ..., et je l'ai envoyé à @jissey par mel direct !
Si tu peux le joindre au module @jissey !
Dis, j'ai traduit "fork" pr "double" ..., mais ce n'est pas juste ! une autre idée ? merci.

Vous pouvez aussi le charger ici !.

Me "reste" à traduire la licence (je vais copier une traduc !), et créer les entrées de traduction de ce qui ne figue pas encore dans le fichier de langue.
Suite ce soir !

Et puis, re merci @jissey : j'ai l'utilité de ce module dès aujourd'hui ... pour faire un mode d'emploi d'utilisation d'une table de la base de données d'un site !
à suivre.


Histoire d'un bébé fork : User's guide. - jissey - 19/11/2012

Merci Philippe, bien reçu.
Il est sur le SVN.
Je vais le mettre sur la forge aussi.
J'ai remis fork, c'est un terme "intraduisible"...fourche, branche...vu que c'est le créateur du site qui l'installe, s'il ne connais pas le terme, ça sera l'occasion pour lui de se cultiver...non, JCE, ne frappe pas...nooooonnnnnn!


Histoire d'un bébé fork : User's guide. - jissey - 19/11/2012

ps: pas la peine de traduire la licence, ne t'embête pas avec ça. Il y en a plein en ligne.


Histoire d'un bébé fork : User's guide. - bess - 19/11/2012

fork est intraduisible effectivement. De même la licence s'adresse au webmaster, pas au user final, donc pas besoin de traduction (dans un module)

Pour rappel, et je grossit volontairement les faits, une traduction vite fait n'a aucune valeur juridique. Pire, elle peut engager la responsabilité du traducteur si celui ci ne mentionne pas clairement qu'il faut se référer à la licence d'origine.

Traduire une licence pour en avoir une française "officielle" est un processus très long (et très ingrat). C'est pour cela que l'on précise en général : "prenez cette tradu en l'état, mais n'oubliez pas que seule l'originale vaut quelque chose".

Il y a encore quelques années (2 tout au plus) le site de creative commons ne traduisait pas officiellement la licence anglaise en français et se contentait d'une traduction sommaire avec un gros gros warning... pour vous dire Smile


Histoire d'un bébé fork : User's guide. - Jean le Chauve - 19/11/2012

Citation :Pour les images j'ai toujours un soucis. Le code est : <img width="255" height="291" alt="" src="uploads/quattro/2012-11-18_125946.png" style="float: left;"> ce n'est pas du tout absolu mais je ne penses pas que le soucis vienne de ton module...
Effectivement, si on écrit ce code sans le wysiwyg, l'adresse de l'image est précédée du chemin de la css du thème admin, et cela ne fonctionne donc pas. Par contre, si on utilise le bouton image du wysiwyg, l'adresse est correcte.


Histoire d'un bébé fork : User's guide. - Jean le Chauve - 19/11/2012

fork : (Anglicisme) (Informatique) Projet ou logiciel issu d'une scission avec un projet initial unique, et qui partage avec lui une part de son code source.
Il n'a donc pas à être traduit ou on peut utiliser son synonyme : ramification.


Histoire d'un bébé fork : User's guide. - bess - 19/11/2012

je comprend pas Jean Le Chauve, je suis passé par le bouton image :/

J'ai l'impression que c'est mon install qui déconne car j'ai un autre soucis récurrent qui me fait disparaitre le WYSIWYG dès que j'ajoute une page/un onglet du module de Jissey, un vidage de cache me le restaure à chaque fois... bref c'est totalement Hors Sujet ...