Contributions au wiki et traductions

From Resonite Wiki
Revision as of 22:35, 3 June 2024 by FuzzyBot (talk | contribs) (Updating to match new version of source page)

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.

If you have more questions about our wiki's moderation, ask in our Discord!

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 avons quelques lignes directrices pour écrire sur ce wiki:

  • Utiliser du Francais standard.
  • Créez des liens vers d'autres articles
    • Évitez l'utilisation de "cliquez ici", "ici" ou "page", utilisez des liens naturels comme:
  • Utilisez des titres, cela sépare la page en sections, cela aide avec la lisibilité
    • Commencez les titres au second niveau (== Mon Titre ==) étant donné que le titre de la page est déjà le premier
  • Utilisez des listes
  • Utilisez les tableaux pour des données ou des textes simples
  • Faites des phrases correctes et utilisez le style Wiki
    • Évitez le surplus de majuscules.
    • Écrivez pour le lecteur, n'utilisez pas "moi", utilisez "vous" ou "nous" à la place
    • Ne démarrez pas un page avec "Salut, aujourd'hui on va voir ce qu'est X"
    • Évitez les phrases dans les titres. "ProtoFlux" est mieux que "Qu'est-ce que ProtoFlux" étant donné que la page "ProtoFlux" expliquerais ce que ProtoFlux est dans son introduction
    • Évitez d'avoir un titre "Introduction", les premiers paragraphes de la page sont l'introduction
    • Évitez d'utiliser "Note" ou "Notez", à la place, utilisez le modèle de notes

Dans le doute, visitez Wikipedia et voyez comme les articles sont écris.

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