Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
utilisateurs:yoboy:sandbox [Le 17/07/2009, 23:49]
Ner0lph ajout de mes commentaires
utilisateurs:yoboy:sandbox [Le 04/03/2023, 12:19] (Version actuelle)
moths-art [détecté par wiki-corrector] Aucun intérêt de supprimer le cache. Raison : https://forum.ubuntu-fr.org/viewtopic.php?pid=22655419#p22655419
Ligne 1: Ligne 1:
 ====== De l'​évolution de la documentation ====== ====== De l'​évolution de la documentation ======
  
-Un constat que je fais depuis un certain temps déjà est que la documentation devient de plus en plus difficile à maintenir, et que le nombre de pages qui vont devenir vétustes par manque de temps ou par manque de nécessité de les mettre à jour (programmes simples à utiliser ou ne n'​ayant pas eu de mise à jours / nouvelles fonctions par exemple). De plus on oublie souvent le fait que l'on n'​écrit pas uniquement de la documentation pour l'​environnement Gnome, mais également xFce, KDE 4.x et UNR/Moblin. Je ne suis pas utilisateur KDE, mais je pense qu'ils doivent se sentir un peu "​isolés"​ dans la documentation,​ malgré leurs thèmes spécifiques. 
  
 +===== À Faire =====
 +  * Supprimer le plugin Cloud
 +  * Garder le plugin "page move" à l'​esprit
 +  * Refaire les minitutos.
  
-===== Environnements et versions ​=====+===== Réflexions ​=====
  
 ==== Le bon environnement ==== ==== Le bon environnement ====
Ligne 10: Ligne 13:
 En fait c'est simple et compliqué à la fois, il serait marrant/​intéressant/​idéal que lorsque l'on se trouve sous doc.ubuntu-fr.org on ne retrouve que le mot "​ubuntu"​ lorsqu'​il s'agit d'une référence à notre distribution,​ ce même mot serait remplacé automatiquement par "​kubuntu"​ sur doc.kubuntu-fr.org,​ et "​xubuntu"​ sur doc.xubuntu-fr.org . En fait c'est simple et compliqué à la fois, il serait marrant/​intéressant/​idéal que lorsque l'on se trouve sous doc.ubuntu-fr.org on ne retrouve que le mot "​ubuntu"​ lorsqu'​il s'agit d'une référence à notre distribution,​ ce même mot serait remplacé automatiquement par "​kubuntu"​ sur doc.kubuntu-fr.org,​ et "​xubuntu"​ sur doc.xubuntu-fr.org .
  
-Je ne sais pas si c'est réalisable et cela impliquerait de remplacer ces références "​ubuntu"​ par quelque chose du type {{distribution}} qui serait remplacé automatiquement.+Je ne sais pas si c'est réalisable et cela impliquerait de remplacer ces références "​ubuntu"​ par quelque chose du type %%{{distribution}}%% qui serait remplacé automatiquement.
  
 > Inutile si on se limite aux mots "​Ubuntu",​ Kubuntu"​ etc. Il faut élargir l'​idée a des paragraphes entiers (texte+captures),​ ce qui me parait une bonne idée à priori, mais compliquera la comprehension/​edition de la source des pages pour les nouveaux contributeurs. ​ --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37// > Inutile si on se limite aux mots "​Ubuntu",​ Kubuntu"​ etc. Il faut élargir l'​idée a des paragraphes entiers (texte+captures),​ ce qui me parait une bonne idée à priori, mais compliquera la comprehension/​edition de la source des pages pour les nouveaux contributeurs. ​ --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37//
  
 > C'est un doux rêve car compliquera les choses et diminuera les contributions. ​ --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45// > C'est un doux rêve car compliquera les choses et diminuera les contributions. ​ --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45//
 +
 +> je suis conscient qu'il faut que ça reste le plus simple possible pour que les contributeurs trouvent ça naturel. Pour ce qui est des blocs ce sera <ubuntu version> texte concerné </​ubuntu>,​ syntaxe facilement compréhensible. Pour ce qui est du nom de distribution c'est plus compliqué à appréhender,​ donc je sais pas... peut être réfléchir à une solution plus large (remplacement d'​occurrence automatiquement sauf si un certain tag %%~~ubuntuonly~~%% existe ou un truc du genre sur la page.  --- //​[[:​utilisateurs:​YoBoY|YoBoY]] 2009/07/21 09:48//
  
 ==== Le filtrage des versions ==== ==== Le filtrage des versions ====
Ligne 27: Ligne 32:
  
 ==== La validation rapide ==== ==== La validation rapide ====
-Cette fonction serait un bouton supplémentaire qui serait présent sur toutes les pages qui n'ont pas pour tag la dernière version d'​ubuntu (Jaunty ​en ce moment). Le principe serait de pouvoir lire une page, si elle est encore adéquate on valide juste avec ce bouton qui ajouterait le tag complémentaire sans besoin d'​éditer la page et de l'​enregistrer.+Cette fonction serait un bouton supplémentaire qui serait présent sur toutes les pages qui n'ont pas pour tag la dernière version d'​ubuntu (Karmic ​en ce moment). Le principe serait de pouvoir lire une page, si elle est encore adéquate on valide juste avec ce bouton qui ajouterait le tag complémentaire sans besoin d'​éditer la page et de l'​enregistrer.
  
 > ok, si cette fonction est accessible uniquement par un utilisateur enregistré. ​ --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37// > ok, si cette fonction est accessible uniquement par un utilisateur enregistré. ​ --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37//
  
-===== Automatisation et harmonisation ​=====+==== Automatisation et harmonisation ====
  
-==== Paquets des dépôts ​====+=== Paquets des dépôts ===
  
 Un autre point qu'il serait intéressant de rapprocher avec la doc c'est toute la documentation déjà existante et disponible sur notre système. Un autre point qu'il serait intéressant de rapprocher avec la doc c'est toute la documentation déjà existante et disponible sur notre système.
Ligne 39: Ligne 44:
 Les paquets d'​abords sont une source d'​information idéale (nom du paquet pour le nom de la page de documentation,​ description,​ nom du programme, site web officiel éventuellement). Il serait intéressant que les programmes accessibles par l'​installateur "​ajouter/​supprimer..."​ et qui n'ont pas de page de documentation en ait une générée automatiquement avec ces informations de base, une structure simple de page (installation,​ configuration,​ liens). Les paquets d'​abords sont une source d'​information idéale (nom du paquet pour le nom de la page de documentation,​ description,​ nom du programme, site web officiel éventuellement). Il serait intéressant que les programmes accessibles par l'​installateur "​ajouter/​supprimer..."​ et qui n'ont pas de page de documentation en ait une générée automatiquement avec ces informations de base, une structure simple de page (installation,​ configuration,​ liens).
  
-On pourrait même pousser le raisonnement plus loin en imaginant que toutes les pages, même celles existantes possèdent ce lien étroit avec les paquets, cela permettrait peut être d'​accélérer/​améliorer la traduction/​description de ces éléments. Cette structure complète pourrait être intégrée avec juste une balise du type {{official>​ nom_du_paquet}}+On pourrait même pousser le raisonnement plus loin en imaginant que toutes les pages, même celles existantes possèdent ce lien étroit avec les paquets, cela permettrait peut être d'​accélérer/​améliorer la traduction/​description de ces éléments. Cette structure complète pourrait être intégrée avec juste une balise du type %%{{official>​ nom_du_paquet}}%%
  
  
-==== Formulaires spécifiques ​====+=== Formulaires spécifiques ===
  
 On pourrait imaginer pour la création de nouvelles pages une série de questions pour orienter le rédacteur et créer automatiquement un squelette de page contenant déjà toutes les informations classiques "​titre,​ description,​ ...". On pourrait imaginer pour la création de nouvelles pages une série de questions pour orienter le rédacteur et créer automatiquement un squelette de page contenant déjà toutes les informations classiques "​titre,​ description,​ ...".
Ligne 51: Ligne 56:
  
 ===== Réglage divers ===== ===== Réglage divers =====
- 
-==== Les ACL ==== 
-Un énorme soucis avec la politique actuelle de tout mettre à la racine, relativement aux ACL, est que l'on ne peut pas empêcher la création de nouveaux namespaces. Je pense qu'il faut limiter la création aux personnes non connectées,​ ne serait-ce que pour un soucis de contact des primo autores des pages. et bon si les anonymes peuvent pas créer, et bien, on peut toujours taper sur les doigts des inscrits qui ont pas lu les règles 
- 
-> J'ai rien compris… 8-O  --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45// 
- 
-==== liens à gauche ==== 
- 
-Tout le monde est d'​accord pour ajouter un lien dans le menu de gauche vers la page expliquant comment participer à la doc. 
- 
-De même pour le remplacement du lien de l'​énorme archive du wiki par un lien vers la page qui parle de la documentation hors ligne, page à modifier en conséquence. 
- 
-> ok.  --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37// 
- 
-> OK aussi. ​ --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45// 
- 
-J'en profite pour rajouter un lien vers la page de téléchargement d'​ubuntu,​ après tout quand on cherche une info sur gnu/linux on tombe très souvent sur les pages de la documentation d'​ubuntu,​ autant inciter les gens à l'​essayer ;) 
- 
-> on devrait avoir le portail "​Telecharger Ubuntu"​ dans la nouvelle page d'​accueil de la Doc.  --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37// 
->> Effectivement,​ c'est mieux, mais moins direct cependant. ​ --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45// 
  
 ===== Module complémentaires ===== ===== Module complémentaires =====
-==== Déjà utilisé ==== 
- 
-  * ACL -- fournit par défaut, permet de gérer graphiquement les contrôles d'​accès sur les pages. Je pense qu'il est utile mais en même temps je pense qu'il ne faut surtout pas l'​utiliser et préférer l'​usage de l'​édition du fichier de conf directement que l'on commit/push avant d'​appliquer afin de garder une traçabilité. 
- 
-> En production, je suis d'​accord,​ mais en validation je ne vois pas pourquoi, si ça peut faciliter le paramétrage. Et après, on réintègre dans le GDS((gestionnaire de sources)). ​ --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45// 
- 
-  * [[http://​www.dokuwiki.org/​plugin:​backlinks2|backlinks]] -- permet de lister les pages qui pointent sur une page donnée. On garde, toujours utile pour les suppressions/​déplacement. Une évolution possible serait de permettre de lister les pages pointant sur une page non existante. 
- 
-> indispensable. ​ --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37// 
->> Oh oui… ​ --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45// 
- 
-  * [[http://​www.dokuwiki.org/​plugin:​cloud|cloud]] -- Permet de faire un nuage des mots les plus utilisés sur le wiki (on ne s'en sert pas), et surtout un nuage des tags utilisés également (mais est-ce qu'on s'en sert vraiment?​).\\ Perso je pense que ce plugin ne sert pas à grand chose actuellement et qu'on peux tout à fait s'en passer, même si il n'est pas gênant. 
- 
-> je n'en vois pas l'​interet non plus.  --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37// 
- 
-> inutilisé, et inintéressant actuellement ​ --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45// 
- 
-  * config -- fournit par défaut, permet de changer les paramètres de configuration avec une interface simple. Pareil que pour les ACL, ces paramètres doivent être gérée par du commit/push selon moi. 
- 
-> cf. supra  --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45// 
- 
-  * infos -- inclus, fournit des infos sur dokuwiki et les plugins installés 
-  * [[http://​www.dokuwiki.org/​plugin:​note|note]] -- Permet d'​insérer des bulles d'​infos. 
-  * [[http://​www.dokuwiki.org/​plugin:​orphanswanted|orphans wanted]] -- Affiche des listes de pages manquantes ou qui ne sont référencées sur aucunes pages. 
- 
-> il y a actuellement un problème de cache je crois  --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45// 
- 
-  * [[http://​www.dokuwiki.org/​plugin:​pagelist|page liste]] -- affiche dans un tableau une liste de pages, utilisés par d'​autres plugins. 
-  * [[http://​www.dokuwiki.org/​plugin:​pagemove|page move]] -- déplace une page, corrige les liens sur les autres pages. Utilisable uniquement par les admins. Est-ce qu'ils l'​utilisent vraiment? 
- 
-> on peut s'en passer grace aux backlinks. Mais ca peut etre pratique (si fiable). ​ --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37// 
- 
-> Ah bon, on l'a ?? Sinon on ne risquait pas de s'en servir vu les problèmes avec l'​authentification et qu'on utilise jamais l'​interface graphique… --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45// 
- 
-  * [[http://​www.dokuwiki.org/​plugin:​page_redirector|pageredirect]] -- applique une redirection vers une autre page sur une page existante. 
- 
-> indispensable. ​ --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37// 
->> je confirme, mais il ne faut pas en abuser car la redirection est permanente (et on l'​avait modifié avec Ju. à l'​époque où on l'​avait mise ne place pour mieux permettre cela)  --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 22:45// 
- 
-  * plugin -- inclus, gestion graphique des plugins 
-  * popularity -- inclus, permet d'​envoyer des stats d'​utilisation aux créateurs de dokuwiki, a ne pas utiliser sauf éventuellement si ils nous le demandent. 
-  * revert -- inclus, recherche et corrections de plusieurs pages dans le cas de spams. 
-  * [[http://​www.dokuwiki.org/​plugin:​tag|tag]] (déjà utilisé) gestion de tags 
- 
-> comme les tags sont tres majoritairement des pages existantes, et que les listes "pages contenant le tag xx" ne sont pas fiables, je me demande si on ne pourrait pas se passer du plugin... ​ --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37// 
- 
-> il faudrait surtout comprendre pourquoi on a ces problèmes avant de prendre une telle décision ​ --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45// 
- 
-  * usermanager -- inclus, gestion des utilisateurs,​ non utilisé vu qu'on se sert de punbb pour ça 
  
 ==== À tester ==== ==== À tester ====
-Il faut ajouter quelques plugins à notre cher dokuwiki pour améliorer l'​apparence des pages. C'est une volonté récurrente sur la liste, et cela rentrerai également dans le cadre du nouveau design. En vrac quelques plugins à tester. 
- 
-  * <​del>​[[http://​www.dokuwiki.org/​plugin:​addnewpage|addnewpage]]</​del>​ permet d'​ajouter sur une page un mini formulaire d'aide à l'​ajout d'une nouvelle page. On rempli le formulaire, on choisit le namespace dans un menu déroulant, et en appuie sur créer (exemple http://​doc.yoboy.fr/​wiki/​ajouter ) On peux filtrer les namespace non désirés dans la configuration,​ ou n'​afficher qu'un namespace. On ne peut avoir qu'un formulaire par page par contre. Pas super intéressant au final, et trop simple à mon avis, donc inutile. 
   * [[http://​www.dokuwiki.org/​plugin:​bookmarkme|bookmarkme]] -- liens vers les "​marques pages sociaux"​. Je trouve que c'est intéressant de pouvoir marquer simplement une page sur notre "​répertoire"​ de marques pages préférées. Donc je suis pour. Faudrait voir si ça ne perturbe pas les performances globales.   * [[http://​www.dokuwiki.org/​plugin:​bookmarkme|bookmarkme]] -- liens vers les "​marques pages sociaux"​. Je trouve que c'est intéressant de pouvoir marquer simplement une page sur notre "​répertoire"​ de marques pages préférées. Donc je suis pour. Faudrait voir si ça ne perturbe pas les performances globales.
-  * [[http://​www.dokuwiki.org/​plugin:​force_preview|force preview]] forcer l'​aperçu en grisant le bouton enregistrer tant qu'on a pas au moins fait un aperçu. Simple, efficace, et suffisant selon moi. 
- 
-> pour.  --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37// 
-> archi pour ! ☝  --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45// 
- 
-  * <​del>​[[http://​www.dokuwiki.org/​plugin:​htmlokay|htmlOKay]]</​del>​ permet l'​utilisation d'html dans les pages du wiki désirée. Pas super simple à utiliser, pas mis à jour depuis 2007, possibilité de failles de sécurité... on oubli. 
-  * <​del>​[[http://​www.dokuwiki.org/​plugin:​include|include]]</​del>​ -- inclus une page ou une section dans une autre. Semble intéressant à première vue, mais plus comme une base d'​étude pour la création de plugins persos... ​ 
-  * [[http://​www.dokuwiki.org/​plugin:​ondeniedlogin|on denied login]] -- Lorsqu'​un utilisateur tente d'​accéder à une action dont-il n'a pas le privilège, il est renvoyé sur la page de connexion. Si on durcie les ACL, ce serait un bon moyen de rappeler à l'​utilisateur de se connecter. 
- 
-> Si on ajoute un bouton "​Participer au wiki" dans le menu de gauche, on devrait pouvoir s'en passer. --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37// 
- 
-  * <​del>​[[http://​www.dokuwiki.org/​plugin:​tagentry|tag entry]]</​del>​ choisir les tags en cochant des cases.\\ Ne convient que pour un wiki avec peu de tags. Il nous faudrait en fait une autre façon de faire. 
-  * <​del>​[[http://​www.dokuwiki.org/​plugin:​snippets|snippets]]</​del>​ inclusion directement dans l'​éditeur de pages ou de morceaux de pages, idéal pour les "​modèles"​ éventuellement. Pas réussi à le faire marcher. 
- 
- 
-  * [[http://​www.dokuwiki.org/​plugin:​pagetemplate|pagetemplate]] à étudier, mais ça à l'air bancal 
-  * [[http://​www.dokuwiki.org/​plugin:​openid|OpenID]] idem 
-  * [[http://​www.dokuwiki.org/​plugin:​boxes|boxes]] après un rapide coup d'œil ça à l'ai super bancal 
- 
-> ils sont bancals en quoi ?  --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45// 
- 
-  * ... 
  
 ---- ----
Ligne 161: Ligne 72:
  
 > une petite dizaine? ​ --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37// > une petite dizaine? ​ --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37//
- 
-__Question 2:__ Que penseriez-vous de mettre les tags sur deux lignes, la première contenant les tags propres au contenu de la page, la deuxième contenant exclusivement les tags des versions concernés, comme par exemple:\\ 
-**Dapper Feisty Gutsy Hardy**\\ 
-**matériel réseau wifi** 
- 
-> bof. pas esthetique et fait perdre de la place. ​ --- //​[[:​utilisateurs:​YannUbuntu|YannUbuntu]] 2009/07/06 09:37// 
- 
-> Aucun intérêt, la différenciation est déjà réalisée grâce à la casse. De plus, qui connait le comportement du plugin lorsqu'​il est invoqué plus d'une fois dans la page ?  --- //​[[:​utilisateurs:​Ner0lph]] 2009/07/17 23:45// 
  
 ==== Versions d'​Ubuntu/​kubuntu/​xubuntu ==== ==== Versions d'​Ubuntu/​kubuntu/​xubuntu ====
Ligne 325: Ligne 228:
 **Le nuage de tags recense beaucoup de tags qui sont des erreurs ou qui ne devraient pas être utilisés** **Le nuage de tags recense beaucoup de tags qui sont des erreurs ou qui ne devraient pas être utilisés**
  
-~~NOCACHE~~ +~~TAGCLOUD:1000~~
-~~TAGCLOUD:500~~+
  • utilisateurs/yoboy/sandbox.1247867356.txt.gz
  • Dernière modification: Le 18/04/2011, 14:44
  • (modification externe)