Contribuer au Wiki
Un article de Wiki de la communauté Mandriva.
[modifier] Comment suivre les modifications du Wiki et y participer ?
Pour vous informer sur ce Wiki et participer directement à son évolution, nous vous recommandons de vous abonner à la Liste de diffusion qui a été créée pour cela : Wiki-discuss. Vous recevrez ainsi par courrier électronique les échanges de la communauté mondiale qui participent à l'amélioration du Wiki Mandriva. Compte tenu du caractère international du Wiki, c'est la langue de Shakespeare qui est de rigueur :
Si vous souhaitez vraiment utiliser un canal français, vous pouvez utiliser :
- Le forum documentation du forum français pour y poser toutes vos questions ;
- La liste de diffusion contrib-club-fr (mais il ne s'agit pas du canal dédié, donc nous n'y parlons pour ainsi dire jamais Wiki)
[modifier] Comment écrire un article ou participer à son écriture ?
Avant de vous lancer dans une des tâches suivantes, veuillez lire les documents suivants :
[modifier] Créer des articles
Pour créer un article, d'abord vérifier qu'il n'existe pas. Pour créer un article, il y a plusieurs possibilités :
- Cliquer sur un lien rouge et éditer la page
- Consulter les pages les plus demandées et cliquer sur les liens rouges : ce sont des pages qui n'existent pas mais un ou plusieurs articles y font référence
- Taper dans la barre d'adresse du navigateur "http://wiki.mandriva.com/fr/Article" en remplaçant "Article" avec le titre de l'article que l'on souhaite créer
- Consultez l'article Écrire dans ce Wiki
[modifier] Compléter des articles
Il existe des articles encore trop courts. Les articles les plus courts de ce wiki sont visibles ici
[modifier] Révision et relecture des articles
La révision consiste à vérifier la justesse d'une page par rapport à trois critères :
- La traduction correcte s'il s'agit d'une page traduite
- La justesse du contenu
- La forme de l'article
Pour chacun de ces types, il y a une catégories associée qu'il convient d'indiquer lorsque l'on souhaite qu'un relecteur travaille sur une page. Le travail du relecteur en est ainsi facilité car il lui suffit d'aller sur la page des catégories pour savoir quelles pages requièrent son attention. Ces catégories sont :
- Catégorie: Page à réviser (traduction)
- Catégorie: Page à réviser (contenu)
- Catégorie: Page à réviser (forme)
Il est bien entendu possible de combiner plusieurs de ces catégories pour une même page.
[modifier] Ajout de contenu graphique
De nombreux articles nécessitent des illustrations, principalement des captures d'écran. C'est une tache fastidieuse que peu de contributeurs font. Néanmoins, c'est aussi une des taches qu'il est possible de réaliser sans connaissances techniques particulières.
[modifier] Synchronisation des articles avec leur version originale
Synchroniser consiste à traduire et à maintenir la traduction fidèle à l'original en permanence.
Il y a principalement deux méthodes pour synchroniser :
- Au moment de la synchronisation, on compare la VO (version originale) et la VF (version en français) et l'on traduit toutes les différences (s'il y en a). C'est un moyen efficace de garder les deux pages synchronisées, mais peut être lourd pour les pages longues et fréquemment mises à jour.
- Au moment de la synchronisation, on compare la VO et la VF et l'on copie/colle les paragraphes qui n'ont pas été traduits (directement dans la langue d'origine). Plus tard, on effectuera la traduction de ces paragraphes (ainsi, d'autres personnes peuvent participer à la traduction). Cela permet d'avoir une page VF au maximum à jour mais a l'inconvénient de laisser une page avec un contenu mixte français/anglais pendant un petit temps.
Le suivi des pages se révèle très efficace dans les deux cas. En effet, l'email reçu comporte un lien vers la différence entre la page au moment de la dernière visite et la page au moment de la réception de l'email.
Pour vérifier que la synchronisation est correcte, on peut comparer la table des matières des deux pages. Ce moyen n'est pas très fiable (s'il y a un changement à l'intérieur d'un chapitre, on ne le verra pas) mais est rapide.
[modifier] Importer des articles
Diverses sources sur le net peuvent devenir des mines d'informations pour le wiki. Certains contributeurs proposent même des liens vers des pages qu'ils aimeraient retrouver sur le wiki. Plus d'information sur les pages à importer...
[modifier] Traduire des articles
C'est un moyen de contribuer au Wiki très facile et rapide (mais néanmoins très utile !). Plus d'informations sur comment traduire...
[modifier] Migrer des articles depuis l'ancien wiki cooker (twiki)
Le contenu de l'ancien wiki cooker a été migré vers ce wiki, mais uniquement pour la partie anglophone (pourquoi ? mystère...). La partie francophone reste donc à migrer à la main. L'ancien wiki semble en lecture seule, mais il suffit de rajouter ?raw=on à la fin de l'URL pour pouvoir éditer une page (l'idéal étant de la faire pointer vers le nouveau wiki quand la migration est achevée). Les différents articles situés sur l'ancien wiki et ceux qui restent à migrer sont listés sur cette page.
[modifier] Migrer des articles depuis l'ancienne base de connaissances
La base de connaissances contient de nombreux articles intéressant, mais certains requiert une sérieuse mise à jour et certains sont même complètement obsolètes. Il faudrait donc copier ces articles dans ce wiki et en profiter pour les mettre à jour.
Actuellement, ce processus se fait manuellement. Il est préférable de copier de code source de la page wiki sur la base de connaissances, de le coller dans ce wiki dans une page au titre explicite, puis d'éditer le format. On peut utiliser cette page pour retrouver l'ensemble des pages importées depuis la base de connaissance. Veuillez vous assurer que le bandeau Modèle:Import_base_de_connaissances est bien présent lorsqu'un article est importé : cela permettra de le retrouver plus facilement par la suite.
Table de correspondance de quelques marques de mise en forme entre l'ancien wiki (xwiki) et le nouveau (mediawiki) :
| Formattage | XWiki | MediaWiki |
|---|---|---|
| Gras | *Gras* | '''Gras''' |
| Titre niveau 1 | 1 Titre niveau 1 | =Titre niveau 1= (à ne pas utiliser dans ce wiki, commencer la numérotation à partir des titres de niveau 2 |
| Titre niveau 2 | 1.1 Titre niveau 2 | ==Titre niveau 2== |
| Puce | * Puce | * Puce |
| Lien interne | [Lien interne>URL_du_lien] | [[URL_du_lien Lien interne]] |
| Lien externe | [Lien externe>URL_du_lien] | [URL_du_lien Lien externe] |
| Table des matières | #toc (2 2 true) | Affichage automatique fonction de la longueur de la page |
Un script a été réalisé pour migrer le contenu d'un wiki tournant sous "Twiki" vers "Mediawiki", il a servi à migrer quelques articles depuis l'ancien wiki de cooker. En l'adaptant, il est certainement possible de réaliser une conversion XWiki vers Mediawiki.
[modifier] Maintenir une page
Certaines pages dans ce Wiki sont considérées comme essentielles et il est important qu'elles soient à jour. C'est pourquoi nous avons choisi de mettre un système de mainteneur en place pour ces pages : son rôle sera de garder une page (qu'il a choisit) à jour (ou synchronisée, s'il s'agit d'une traduction : voir le paragraphe plus-haut). Pour plus d'informations sur le rôle du mainteneur, comment le devenir et comment procéder, voir la section Maintenir une page du Wiki.
[modifier] Suggérer des idées d'amélioration du wiki
- Liste de diffusion "wiki-discuss" à laquelle vous pouvez souscrire ici
- Editer la page "discussion" de ce présent article.
- Le forum documentation de Mandriva est aussi ouvert et comprend un certain nombre de fils pour débattre de l'organisation de ce Wiki.
