Wiki Contributions & Translations/fr: Difference between revisions

From Resonite Wiki
Created page with "MediaWiki ne supporte pas le Markdown, utilisez Wikitext à la place."
Updating to match new version of source page
Line 20: Line 20:


=== Style === <!--T:30-->
=== Style === <!--T:30-->
Nous n'avons pas de guide de style mais nous avons quelques lignes directrices:
 
<span class="mw-translate-fuzzy">Nous n'avons pas de guide de style mais nous avons quelques lignes directrices:</span>
 
* Utiliser du Francais standard.  
* Utiliser du Francais standard.  
* Créez des liens vers d'autres articles!
* <span class="mw-translate-fuzzy">Créez des liens vers d'autres articles!</span>
* Écrivez des phrases correctes avec une case correcte.
** <span lang="en" dir="ltr" class="mw-content-ltr">Avoid using "Click here", "here" or "page" when linking, use natural linking such as:</span>
** Évitez le surplus de majuscules.
*** <span lang="en" dir="ltr" class="mw-content-ltr">"[https://heyoka.medium.com/dont-use-click-here-f32f445d1021 There's an article] explaining more" or "You can send commands to the [[Resonite Bot]]."</span>
* Écrivez avec "vous" et non pour "moi".
* <span lang="en" dir="ltr" class="mw-content-ltr">Use headings to separate pages into sections, this helps readability</span>
* Évitez les phrases dans les titres d'articles. "ProtFlux" est mieux que "Qu'est-ce que ProtoFlux". ProtoFlux devrait contenir des information sur ce que c'est sans le dire dans le titre.
** <span lang="en" dir="ltr" class="mw-content-ltr">Start headings at the second level (<code>== My heading ==</code>) as the title of the page is already the first tile</span>
* Utilisez des titres. Ils aident avec la lisibilité.
* <span lang="en" dir="ltr" class="mw-content-ltr">Make use of lists</span>
* Utilisez des listes. C'est bien les listes.
* <span lang="en" dir="ltr" class="mw-content-ltr">Use tables for data or small amounts of text</span>
* Évitez de créer des tableaux pour des long paragraphes de texte.
* <span lang="en" dir="ltr" class="mw-content-ltr">Write proper sentences and use [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style Wiki Style]</span>
** Pour des données factuelles, des données numériques, etc, les tableaux sont corrects, mais on peut souvent voir des tableaux qui seraient mieux comme une collection de tableaux plus petits ou une liste.
** <span lang="en" dir="ltr" class="mw-content-ltr">No over capitalization</span>
* Évitez d'utiliser "Cliquez ici" ou "ici" ou "page"
** <span lang="en" dir="ltr" class="mw-content-ltr">Write for the reader, don't use "I", use "we" and "you" instead</span>
** A la place, essayez d'incorporer le lien ou le titre de la page dans la phrase.
** <span lang="en" dir="ltr" class="mw-content-ltr">Do not start a page with "Hello guys, today we're gonna see what is X"</span>
*** Cliquez [https://example.com ici] pour lire sur les commandes du bot => [https://example.com Les commandes du bot] vous permettent de faire des trucs cools.
** <span lang="en" dir="ltr" class="mw-content-ltr">Avoid sentences in article names. "ProtoFlux" is better than "What is ProtoFlux" as the page "ProtoFlux" would contain what it is in the introduction</span>
** [https://heyoka.medium.com/dont-use-click-here-f32f445d1021 Voici un article] qui en dit plus.
** <span lang="en" dir="ltr" class="mw-content-ltr">Avoid having an "Introduction" heading, the first paragraphs of the page are the introduction</span>
* Évitez "Introduction" dans vos titres. Les premières phrases de l'article sont l'introduction. Regardez Wikipedia pour des bons exemples.
** <span lang="en" dir="ltr" class="mw-content-ltr">Avoid using "Note" or "Please note", instead use the [[:Template:Note | note template]]</span>


=== Formattage === <!--T:32-->
=== Formattage === <!--T:32-->

Revision as of 19:40, 17 April 2024

Le wiki de Resonite est un projet communautaire. Merci pour toute votre aide et contributions! Nous sommes une petite équipe et le maintenir ne serait pas possible sans vous. Tout le monde, sans égard a leur status sur Resonite peut éditer le wiki et est encouragé a le faire. Éditez!

Modération du wiki

Pour chaque utilisateur, leur premières contributions seront placées dans une file d'attente de modération qui est généralement approuvée rapidement.

Une fois approuvée, les utilisateurs sont ajoutés au groupe "automoderated user" qui leur permet d'éditer le wiki librement.

Lignes directrices d'édition

Avant de commencer, il y a quelques lignes directrices a garder a l'esprit.

Brouillons/Commentaires etc

  1. Juste éditez le wiki! Vous n'avez pas besoin d'un statut spécial, approbation ou permission pour éditer le wiki.
  2. Ne nous envoyez pas vos brouillons, juste éditez.
  3. N'utilisez pas Google Docs pour rédiger un brouillon. Écrire directement sur le wiki vous permet de penser comme un éditeur de wiki.
  4. Suivez le principe d'amélioration progressive: "bon" -> "mieux" -> "meilleur"

Style

Nous n'avons pas de guide de style mais nous avons quelques lignes directrices:

  • Utiliser du Francais standard.
  • Créez des liens vers d'autres articles!
    • Avoid using "Click here", "here" or "page" when linking, use natural linking such as:
  • Use headings to separate pages into sections, this helps readability
    • Start headings at the second level (== My heading ==) as the title of the page is already the first tile
  • Make use of lists
  • Use tables for data or small amounts of text
  • Write proper sentences and use Wiki Style
    • No over capitalization
    • Write for the reader, don't use "I", use "we" and "you" instead
    • Do not start a page with "Hello guys, today we're gonna see what is X"
    • Avoid sentences in article names. "ProtoFlux" is better than "What is ProtoFlux" as the page "ProtoFlux" would contain what it is in the introduction
    • Avoid having an "Introduction" heading, the first paragraphs of the page are the introduction
    • Avoid using "Note" or "Please note", instead use the note template

Formattage

Étant donné que le wiki change en permanence et ses traductions, nous avons besoin d'un formatage précis.

Vous pouvez trouver un guide sur le formatage WikiText sur la documentation officielle MediaWiki.

MediaWiki ne supporte pas le Markdown, utilisez Wikitext à la place.
  • Évitez d'utiliser des tags HTML anciens.
    • <b>,<br>,<i>,<div> etc
      doivent être remplacés par leur équivalent WikiText.
    • Si vous voulez retourner à la ligne, juste retournez à la ligne.
  • Évitez de démarrer une page avec un titre étant une copie du titre de la page. Le titre de la page est le nom de la page, pas le premier titre.

Couleurs

  • Évitez d'appliquer des couleurs manuellement sur les pages. Cela peut casser les thèmes clairs et obscurs.
  • Utilisez les variables de couleur définies dans Mediawiki:Citizen.css.
  • Nous sommes en train de chercher comment utiliser notre thème pour les couleurs ce qui les feront fonctionner dans les thèmes clairs et obscurs.

Icônes

Vous pouvez utiliser des images SVG pour ceux-cis. Cela permet aux autres utilisateurs de les éditer plus facilement plus tard.

Descriptions de pages

Nous utilisons l'extension Short Description pour permettre d'avoir une description de page courte sur la page de recherche.

Pour ajouter une description a une page, utilisez: {{SHORTDESC:<description>}}

Fenêtre de recherche avec la description de page surlignée.

Trouver du contenu a éditer

Le wiki de Resonite est un environment évoluant rapidement. Cela peut rendre incertain ce qui peut être édité et amélioré.

Ébauches

Nous avons une bonne tonne de contenu demandant de l'attention appelés des ébauches. Vous pouvez trouver une liste de ces pages ci-dessous:

Regardez ces pages régulièrement pour une liste de pages a éditer.

Composants et nodes

Les utilisateurs de Resonite utilisent une tonne de nodes ProtoFlux et composants pour créer du contenu en jeu. Tous ceux-cis ont besoin de documentation.

Modèles

Nous n'avons pas de modèles pour les composants/nodes. Cette page sera mise à jour quand nous en auront.

Nodes ProtoFlux

Voyez la catégorie Category:ProtoFlux pour une liste de nodes ressemblant la liste de nodes présente en jeu. Chaque node a besoin de descriptions, éditions et mises à jour. Si vous en voyez une avec un lien rouge, cela veux dire qu'elle n'est pas documentée. Éditez a souhait!

Composants

Nous avons une liste des composants dans la catégorie Category:Components qui en manque beaucoup. Si vous trouvez un composant avec une documentation manquante, vous pouvez l'ajouter.

Changements majeurs

La règle générale du wiki est juste d'éditer. Il faut cependant faire attention en éditant des pages plus grosses comme la page d'accueil, Il y a une tonne de nuances et de subtilités qui doivent être prise en compte en éditant ces pages. Veuillez demander dans le chat Wiki sur le Discord avant de modifier ces pages. La réponse sera probablement "oui" mais il est mieux d'en discuter avant.

Aide a l'édition

La wiki de Resonite utilise MediaWiki comme logiciel de wiki et a beaucoup de documentation sur comment éditer des pages.

Tout le monde peut créer un compte sur le wiki et contribuer a des pages existantes et créer des nouvelles pages.

Catégories

Une catégorie est le meilleur moyen de rassembler des pages communes a un certain projet ou sujet. Utiliser une catégorie va créer automatiquement une page listant toutes les pages dans la catégorie. Regardez le guide de MediaWiki sur les catégories.

  • Les pages de catégories peuvent contenir plus d'informations pour expliquer ce que la catégorie est et ce qu'elle fait.
  • Des sous-catégories peuvent exister.
    • Pour créer une catégorie, ajoutez une page dans celle-ci.
    • Par exemple, Category:Animals peut contenir Category:Animals:Mammals.
    • Pour faire cela, soyez sûrs que Category:Animals:Mammals est nommé correctement et qu'il contiens [[Category:Animals]].
  • Une page peut être dans plusieurs catégories.
  • Évitez de créer des catégorie pour juste une seule page.
    • Faites attention quand vous imbriquez des catégories, les membres de la catégorie ne doivent pas être une catégorie eux-mêmes. Par exemple, Category:Vegetables est correct mais "Potato" ne peut pas être sa propre catégorie.

Traduire

Pour plus d'informations sur les traductions, lire Help:Translating.

Citations

Nous utilisons l'extension MediaWiki Cite pour vous permettre de citer des parties d'un article. Pour utiliser cette extension, voir la page d'aide MediaWiki Cite.

Pour un peut plus d'aide pour ce wiki en particulier:

  • Citer n'est pas obligatoire mais apprécié
  • Attention en créant un lien vers une source éphémère. Par exemple, les VOD Twitch peuvent expirer.
  • Exemples de sources fiables:
    • Messages Discord
    • Vidéos YouTube
    • Issues GitHub
    • Réseaux sociaux
    • Note de mise à jour, etc.

Accessibility

Images

Faites attention que vos images soient accessibles. Nos recommendations:

  1. Surlignez les informations importantes avec un éditeur d'image comme les boutons ou zones de saisie sur lesquelles l'utilisateur devrait se concentrer.
  2. Téléversez de grandes images et utilisez WikiText pour les redimensionner.
  3. Toujours avoir une description de l'image après son titre: [[File:bunny.png|Un lapin]].
    • Quand la description est placée après le titre, elle sera placée dans l'attribut HTML alt.
    • Si vous voulez faire un texte alt différent de la description, utilisez le paramètre alt.

Diagrammes

Voir Help:Diagrams

Ressources externes

Voir aussi