Documentation "Wiki" Trisquel GNU/Linux

28 replies [Last post]
Mimmo_D.DN

I am a translator!

Offline
Joined: 02/24/2013

Bonjour à tou'te's

Juste un petit ping a propos de la documentation Trisquel.

Depuis quelques mois (déjà) un groupe de personnes (qui se reconnaîtront ;)) de la branche francophone se sont coordonné pour amorcer une refonte de la documentation.

Comme vous le savez très certainement, une doc nécessite une somme assez conséquente (pour ne pas dire monstrueuse) de travail, des personnes compétentes, des outils adaptés... Au même titre qu'un site Web la documentation est une vitrine pour les personnes venant de l'extérieur, négliger ces aspects aura pour conséquence de faire glisser le projet tout entier vers la marginalisation, or Trisquel est l'un des rares systèmes entièrement libre et accessible aux néophytes et à ce titre il doit trouver la place qu'il mérite.

Malgré la somme de travail déjà fournie en contributions, le projet est actuellement en standby, et pour cause, le constat qu'on atteint vite les limites de toutes sortes, causes, effets, peut-être tout simplement combler le manque de nivellement sur un base commune acceptables par tous.

À ce titre un pad ouvert est disponible pour avis, en vrac il dépouille un peu les pistes possibles → https://mypads.framapad.org/p/trisquel-info-wiki-cr-projet-58gfj7h6

Bien librement.

PS : Bonne année ^_^

Diomede
Offline
Joined: 01/11/2017

Salut, merci pour cet état des lieux. Je suis d'accord sur l'importance d'une documentation de qualité et d'une distribution entièrement libre. Comment peut-on aider ?

Je n'ai malheureusement pas beaucoup de temps libre mais si je peux faire quelques traductions je me porte volontaire :-)

Mimmo_D.DN

I am a translator!

Offline
Joined: 02/24/2013

Merci pour ton offre d'aide qui sera très certainement apprécie par toutes les équipes contribuant aux différents projets Trisquel GNU/Linux.

Concernant les disponibilités, pas d'impératifs si ce n'est l'envie de participer, après, les contributions c'est selon les moyens/disponibilités de chacun.

Concernant la doc, sur un autre fil MagicBananan a pointé [ https://trisquel.info/fr/forum/nouvel-utilisateur-0#comment-109346 ] la remontée d'incident concernant le moteur wiki qui génère la documentation, dans l'attente d'une résolution, nous sommes un peu en standby.

Bien librement.

Magic Banana

I am a member!

Offline
Joined: 07/24/2010

David a plus ou moins résolu e problème il y a plus de deux semaines : https://trisquel.info/issues/21410

Seules quelque balises ne sont pas interprétées, notamment la balise "image".

Mimmo_D.DN

I am a translator!

Offline
Joined: 02/24/2013

En effet, il serait d'ailleurs utile que le ou les web hacker's (une fois résolu) nous fassent savoir ce qui a bien pu générer ce type de comportement. D'autant plus étrange que, effectivement, si on bascule sur le balisage à chevrons tout semble se remettre en ordre, images comprises... *¿*

Magic Banana

I am a member!

Offline
Joined: 07/24/2010

https://trisquel.info/issues/21410 explique que l'interpréteur de syntaxe Wiki a dû être désactivé fin novembre car son code, défaillant, posait "d'autres problèmes sur le site" (pas plus de détails, en tout cas dans ce rapport de bogue). L'interpréteur de syntaxe Wiki traduit cette syntaxe en HTML que le navigateur Web comprend. Une page écrite en HTML est servie telle quelle au navigateur (sauf que certaines balises sont supprimées pour des raisons de sécurité). Il est donc normal que ces pages-là n'aient jamais posées problème.

Bref, David est donc parti à la recherche d'un autre module Drupal (le "système de gestion de contenu" utilisé sur ce site) pour interpréter la syntaxe Wiki. Le premier testé, début décembre, cassait le rendu de nombreuses pages. La solution aujourd'hui en place (depuis plusieurs semaines) est un module générique de traduction d'une syntaxe quelconque vers une autre. Il faut donc y définir des filtres qui interprètent chacun des éléments du langage Wiki. David a trouvé une telle implémentation (qui modifie aussi marginalement le module) où la seule balise importante qui manque est "image".

Mimmo_D.DN

I am a translator!

Offline
Joined: 02/24/2013

En fait ici c'est l'implémentation d'un nouveau cadre, puis de lui appliquer les filtres nécessaires aptes à (re)structurer le tout dans le but de restituer un rendu correct...

N'ayant pas les mains dans le moteur, question à tempérer donc, y a-t-il une raison particulière qui fait que la partie documentation n'est pas scindé, un peu comme les listes, les packages, code. Un sous domaine quoi...

Magic Banana

I am a member!

Offline
Joined: 07/24/2010

Je ne sais pas pas. Mais bon, ça marchait bien jusqu'à novembre et ça remarche plutôt pas mal depuis quelques semaines. Créer un wiki.trisquel.info demanderait du travail qui n'en vaut probablement pas la peine.

Mimmo_D.DN

I am a translator!

Offline
Joined: 02/24/2013

C'est certain que si ça doit rester cantonné pour éviter d'éparpiller les taches de maintenances ça se comprend, mais en même temps lorsqu'on regarde ;

packages.trisquel.info/
devel.trisquel.info/
listas.trisquel.info/

la question interpelle un peu, pourquoi ne pas se doter d'un https://wiki.trisquel.info/

Mangy Dog

I am a member!

I am a translator!

Offline
Joined: 03/15/2015

Tout ce que je vois c'est quasiment tout le travail que nous avons fournis a simplement disparus et cela depuis bientot 3 mois!

c'est a dire que pendant 6 mois on contribuent et tout juste finis cela disparait pendant 3 mois!

Bref..j'en passe car j'ai bien d'autres préocupations actuellement

c'est pas une blague
mais la trop c'est trop....!

Basta cosi!

et je rejoins l'analyse de Salman

Trisquel-devel] you're killing contributors' motivation,
https://listas.trisquel.info/pipermail/trisquel-devel/2017-January/001034.html

Mimmo_D.DN

I am a translator!

Offline
Joined: 02/24/2013

En effet, il y a des latences assez incompréhensibles et des conséquences difficilement mesurables.

Concernant la doc pe, peut-être aurait-il été utile de pouvoir exporter le bloc documentation ailleurs, le temps de la maintenance, même si aucunes interactions ne sont plus possibles pendant cette période, au moins la doc resterait accessible le temps nécessaire.

Mais bon ici c'est une question organisationnelle, les réponses doivent très certainement en résulter...

Mangy Dog

I am a member!

I am a translator!

Offline
Joined: 03/15/2015
Mimmo_D.DN

I am a translator!

Offline
Joined: 02/24/2013

C'est clair que ce "bug" ne pouvait tomber à plus mauvais moment.
On peut dire que les discussions que nous avions entamés il y a quelques temps sur le Vox ont tendance à se vérifier. :[

Le projet semble avancer en mode "au gré des vents" comme dirait Jean-Louis Étienne ^o^

Ceci dit, hier j'ai reformulé les marqueurs (wiki → html) pour les images de la page Logo (histoire de rendre quelques pages essentielles présentables), et cela semble concluant, d'ici à imaginer reformuler toutes les entrées du wiki, doc...

Mangy Dog

I am a member!

I am a translator!

Offline
Joined: 03/15/2015

Certo Mimmo!

Je veux préciser que pour toute personne souhaitant consulter la doc de Trisquel ceci est possible via la page
Par ordre Alphabétique
https://trisquel.info/fr/wiki/liste-des-manuels-par-ordre-alphabétique

ou tous les manuels sont disponiblent malheureusement les captures d'écran ne s'affichent pas

Par contre la page
https://trisquel.info/fr/wiki/manuel
n'offre plus la possibilité de consulter les manuels dans leur integralité comme par exemple "Système d'exploitation"ou une bonne 20 ou 30 pages de "sous"manuels ne s'affichent pas ..mais bien d'autres manuels ne s'afichent pas aussi

David a commenter que cela était résolu en partie...! oui du coté Anglophone tel que
https://trisquel.info/en/wiki/full-disk-encryption-install

Mais pas la doc Francaise!..qui pourtant a le plus grand nombre de captures d'écran entre 150 a 250 images et une organisation en sous manuels

Mimmo_D.DN

I am a translator!

Offline
Joined: 02/24/2013

Si, ma comme je le disait plus haut, le formatage html fonctionne, tests concluants, c'est ce qui a été fait dans ton exemple pour https://trisquel.info/en/wiki/full-disk-encryption-install tout comme dans https://trisquel.info/fr/wiki/logo ...

Mais les principaux contenus de la doc utilise du wikicode, tu te voit convertir ça en balisage html ?

Mangy Dog

I am a member!

I am a translator!

Offline
Joined: 03/15/2015

Très Bonne nouvelle et un grand ouf..le bogue est résolue, la documentation est désormais accessible comme il y 3 mois!

https://trisquel.info/fr/wiki/manuel
les sous manuel avec toutes les captures sont visiblent! ;-)
https://trisquel.info/fr/wiki/système-dexploitation

Majin Buu
Offline
Joined: 11/05/2016

Tranquil, le projet va lent mais solide. Je crois que Trisquel 8 se lancera en avril.

Mimmo_D.DN

I am a translator!

Offline
Joined: 02/24/2013

Bien disons que le projet Trisquel GNU/Linux avance au grée des annonces ponctuelles via la liste [Trisquel-devel], dernière en date, Freedom fridays update, Feb 3 → https://listas.trisquel.info/pipermail/trisquel-devel/2017-February/001043.html sort tout juste du pétrissage...

Mais ici cela concerne plutôt le site, le wiki de la doc côté front (et un peu back aussi) qui n'a pas tout à fait les mêmes contraintes ni la même portée ;)

Sasaki
Offline
Joined: 08/11/2014

Salut,

je profite de ce post pour apporter une petite considération qui me semble importante.
J'en ai déjà parlé ailleurs mais après avoir vainement tenté de contacter la personne en charge par mp j'en reparle ici.

Il me semble que copier-coller des pans entiers de la doc ubuntu fr serait d'une grande aide au projet de wiki car :

-le système est basé sur ubuntu et bon nombre de bugs, solutions, aplications sont similaires et très bien documentées dans la doc ubuntu. Je m'en sers tout le temps quand je ne trouve pas dans la doc trisquel, pur l'instant très spécifique aux questions de grands débutants. Bien que très complète à ce sujet, elle ne couvre pas bon nombre de sujets déjà documentés ailleurs, sous licence libre.

- la raison d'être de trisquel étant de fournir une ubuntu débarassée des logiciels propriétaires, je vois mal pourquoi ne pas faire exactement la même chose pour la doc : la reprendre en la modifiant pour la purger de toutes ses mentions à des logiciels privateurs. On obteindrait ainsi une base dicumentaire efficace pour voir "ce qui manque" à un système libre pour fonctionner au mieux.

Vient se poser le problème des licences apparemment incompatibles et la difficulté de contacter des responsables à ce sujet. Je ne crois pas que cela soit insurmontable à partir du moment où l'avis que j'exprime ci-dessus est partagé par les autres membres de ce forum, nous devrions pour voir mettre en place des solutions.

Magic Banana

I am a member!

Offline
Joined: 07/24/2010

Je pense que (presque ?) personne ici ne voit d'inconvénient à réutiliser le travail de la communauté Ubuntu (sauf références au logiciel privateur)... du moment que l'on respecte les licences que les auteurs ont choisies. Nous avons déjà eu cette conversation : https://trisquel.info/forum/utiliser-du-contenu-dautres-manuels-dans-la-doc-trisquel

Dois-je comprendre, de ta seconde phrase, que tu as contacté David mais qu'il ne t'as pas répondu ?

Sasaki
Offline
Joined: 08/11/2014

Oui, comme je l'ai indiqué dans le sujet cité. Je sais pas trop quoi faire du coup...

Mangy Dog

I am a member!

I am a translator!

Offline
Joined: 03/15/2015

Je viens de supprimer les textes de toutes ces pages de wiki que j'avais crées il ya tout juste un an
elles était sous licences double ( CC et GNU donc incompatibe avec notre documentation) je n'ai laissé que les capture d'écran maison et les liens qui pointe vers ...la doc KDE.

Voici la liste des page dont jai supprimé le texte :
a partir du manuel https://trisquel.info/fr/wiki/éducation

Artikulate application d'apprentissage de langue qui aide à améliorer les compétences de prononciation dans différentes langues
Blinken Jeu d'entrainement de la mémoire
Cantor interface KDE pour des logiciels de mathématique
KAlgebra une calculatrice avec des fonctions d'affichage symboliques et d'analyse en 2D et 3D
Kalziumun programme qui montre un tableau périodique des éléments
Kanagram jeu amusant de casses-tête avec anagrammes
KBruch un petit programme pour pratiquer le calcul fractionnaire et les pourcentages
KGeography apprentissage de la géographie
KHangMan le jeu du pendu pour enfants, adapté pour KDE
Kig un programme de géométrie interactive
Kiten un outil KDE de référence pour apprendre les kanjis (caractères Japonais)
KLettres pour apprendre l'alphabet et puis lire des syllabes en différentes langues
KmPlotun traceur de courbes mathématique
KStars un planétarium l'observation du ciel nocturne vu de n'importe quel endroit sur Terre, soit jusqu'à 100 millions d'étoiles et la voie lactée.
KTouch un programme pour apprendre la dactylographie
KTurtleun environnement éducatif de programmation
KWordQuiz un programme d'apprentissage de vocabulaire pour KDE
Marble un globe virtuel Atlas,OpenStreetMap, Vue satellite, La Terre de nuit, Carte historique de 1689, Lune, Carte brute, Précipitations (décembre), Précipitations , Températures.
Parley un entraîneur de vocabulaire

Et
Abiword un logiciel de traitement de texte très léger et performant

Dans les jours a venir je supprimerais le contenu texte d'autre pages qui doivent elles aussie être en dual-license

Magic Banana

I am a member!

Offline
Joined: 07/24/2010

La double-licence signifie que tu choisis quelle licence s'applique. Ce ne sont pas les deux en même temps.

Je ne sais pas de quelle licence GNU tu parles. Si il s'agit de la licence GNU FDL (la licence appropriée aux manuels), alors il n'y a pas d'incompatibilité puisque c'est la licence utilisée par ce site. Aussi, les licences CC-BY ou CC-0 sont compatibles avec la GNU FDL.

Mangy Dog

I am a member!

I am a translator!

Offline
Joined: 03/15/2015

Justement la doc de KDE est en 2-dual License : Creative Commons License SA 3.0 and the GNU Free Documentation License 1.2 sauf mention contraire.

Un exemple de documentation pas encore supprimé(partiellement)
https://trisquel.info/fr/wiki/karbon

Tu avait déja répondu de cette question : https://trisquel.info/fr/forum/utiliser-du-contenu-dautres-manuels-dans-la-doc-trisquel#comment-105579

;-)

@plus

Magic Banana

I am a member!

Offline
Joined: 07/24/2010

Anéfé : la GNU FDL 1.2 est incompatible avec la GNU FDL 1.3.

Mangy Dog

I am a member!

I am a translator!

Offline
Joined: 03/15/2015

J'en profite pour te remercier de l'aide précieux que tu amène aux utilisateurs de Trisquel sur ce Forum, il m'arrive parfois de me demander que serait Trisquel sans l'apport des tes connaissances et compétences très élargies, et évidemment le temps que çela implique!

Je continuerais à faire le ménage dans les (quelques) pages qui sont en incompatibles..

Magic Banana

I am a member!

Offline
Joined: 07/24/2010

Merci. Mais tu exagères beaucoup ma petite contribution !

Ker Tris
Offline
Joined: 05/27/2016

Non !

(Merci aussi, en passant)

Mangy Dog

I am a member!

I am a translator!

Offline
Joined: 03/15/2015

Le texte en CC avec comme source Wikipedia, a été supprimé de

Celestia un simulateur spatial pour explorer le système solaire et l'univers en 3D