Forum

Bonjour,
L'équipe de documentation de Mageia ouvre le chantier d'écrire la documentation des outils spécifiques de Mageia, à savoir ceux qui sont accessibles par le MCC.
Cette documentation sera écrite en anglais, puis un fois validée, traduite dans les autres langues.
Toutefois, je pense que si vous faites un article en français dans le wiki MLO, on trouvera bien quelqu'un pour traduire et tranférer vers l'anglais.
Cette page récapitule l'état d'avancement.
A vos claviers ! Les volontaires, lever le doigt.

Ah c'est une bonne nouvelle ça. Il est en effet important de fournir une documentation. Cela dit je viens de regarder la page du wiki et il n'y a pas beaucoup d'informations. Par exemple, comme ça se passe pour écrire une documentation ? On l'écrit de notre côté from scratch et on l'envoie à quelqu'un après (à qui ?) ? Y-a-'til un squelette égénral à suivre pour écrire cette doc ? Par exemple, pour qu'il y ait une certaine cohérence, je verrai bien un paragraphe « Description générale » pour chaque doc qui décrirait de manière générale la fonction du logiciel. Puis une section « Divers » qui indiquerait par exemple que si on trouve un bogue il faut faire un rapport sur le bugzilla, etc. Également, quel est le language dans lequel on écrit la doc ? Est ce qu'on écrit avec un logiciel spécial, est ce qu'on écrit un simple .txt avec une mise en page grossière, ...
Bref, je n'ai pas vraiment cherché (je n'ai vu que la page que tu as mentionné) donc désolé si ça existe. Sinon il faudrait clarifier ceci.

Je dis ça mais je ne pourrais probablement pas m'investir dans l'écriture pour le moment (je traduit déjà les interfaces et la doc de quelques logiciels KDE en plus d'autres choses).

Bonjour,

Ceux qui le pratiquent peuvent rédiger ces docs directement en anglais en utilisant Calenco. Son utilisation est décrite ici pour traduire l'aide de drakinstall, elle est valable pour écrire l'aide des draktools :
https://wiki.mageia.org/en/Translation_with_Calenco_and_xxe
Les non anglophones peuvent l'écrire en français, où ils veulent, l'important est de le dire ici.

L'écriture est à faire "from scratch" bien sur en s'inspirant de ce qui existe (aide Mandriva ou Fedora, wikis, etc...) Pour le style voir l'aide de drakinstall :
http://doc.mageia.org/
On retiendra principalement, écrire au présent et à la troisième personne.
Pour toute question ou suggestion, l'action est coordonnée sur la ml doc-discuss pour les anglophones, sinon s'exprimer ici, on transmettra.

Bonsoir,

Le problème, c'est que le canevas du Wiki de Mageia n'a rien à voir avec celui de MLO ...

Cela ne va pas simplifier la tâche

Édité par gusyear Le 18/07/2012 à 22h37

Coucou



Je suis utilisatrice MOI ! pas outilleuse

Est-ce que le wiki de MLO est prévu pour être multilangue ? ( anglais français ) ou juste français ?

Je veux bien essayer de traduire des trucs de MLO du français à anglais.

As-tu vu dans le wiki de MLO des "choses" intéressantes pour ce projet ?



Est-ce qu'une fois que les doc des "outils" seront faites, il y aura des docs pour les logiciels ?

ou au moins une grande liste avec la liste de logiciels et un lien vers la doc "officielle" de chacun si elle existe ?



J'espère que pour mener à bien ce projet il y aura un dialogue qui se fera entre les listes "doc" et "i18n", du genre les "doc" envoient un petit mail au "i18n" pour leur dire qu'ils ont de la trad à faire



Je ne connais pas Calenco, mais ça à l'air bien lourd à utiliser avec des trucs à installer... du coup, pas facile de traduire dès que l'on n'est plus sur "son" PC...

On ne peut pas se contenter d'un simple pad pour les trad ? ( comme on fait pour trad les articles du blog )

Je t'attendais



Oui,

La page "imprimante", je l'ai faite.

Je vois :

http://www.mageialinux-online.org/wiki/gestionnaire-d-amorcage-grub-et-multiboot

http://www.mageialinux-online.org/wiki/configurer-sa-cle-usb-3g-3g-sur-mageia à voir s'il faut regrouper avec d'autres parties de la configuration des réseaux.

http://www.mageialinux-online.org/wiki/le-wifi-sur-mageia

http://www.mageialinux-online.org/wiki/installer-les-pilotes-proprietaires-nvidia-et-ati-sur-mageia



Il existe aussi des pages en anglais sur le wiki de mageia.org, je n'en pas encore fait le bilan.





Je ne crois pas que ce soit déjà à l'ordre du jour. J'ai cru comprendre que si tous les outils de Mageia étaient documentés pour la sortie de Mageia 3, ce serait déjà beau.

Pour les logiciels, je crois que pour l'instant, le bon endroit est MLO.



Je crois que l'idée avec Calenco est que la documentation soit disponible sous plusieurs formats (Html, PDF....). Une part du travail concerne la mise en page, les liens, l'insertion des copies d'écran. Ce travail ne peut pas être fait avec un pad.

Pour la traduction de la documentation d'installation, je n'ai pas utilisé l'éditeur externe, mais directement la page sous java. On va directement dans le code, mais ce n'est pas problématique, la structure est déjà là.

Pour l'écriture "from scratch", il est préférable de passer par l'outil d'édition du XML.

Non, cela n'est pas prévu, c'est considéré devant être à la charge de l'équipe upstream





Tu devrais t'abonner à la ml doc-discuss. Concernant la doc des Draktools, tu peux dès maintenant aller sous Calenco traduire les pages anglaises en français.





Il y a juste le rpm xxe

https://wiki.mageia.org/en/Translation_with_Calenco_and_xxe





Calenco permet aussi de gérer l'édition "officielle" sur http://doc.mageia.org/ dans toutes les langues. Il n'y a pas de mises à jour sur le blog.



Bon courage

Merci pour ces précieuses informations





Ok.



Dommage, ça veut dire que lorsque je ne suis pas chez moi ( et donc dispo ) et que je n'ai sous la main que du windows où je ne peux rien installer... je ne peux rien faire





J'en ai un peu marre de m'abonner à des mailing-liste où 99% des messages ne m'interessent pas pour le cas où éventuellement peut-être il y aurait quelqu'un qui aurait besoin de trad. Je perds déjà beaucoup trop de temps à faire le ménage dans ma mail box



Merci à vous pour vos réponses

Au travail mammig

http://bn.parinux.org/p/They_make_Mageia__Claire_Robinson_aka_MrsB