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.
Toutes les contributions sont les bienvenues. Éditez!
Démarrer
Pour démarrer a éditer le wiki, vous aurez besoin:
- De créer un compte sur le wiki de Resonite
- Vérifier votre courriel
- Être "Automodéré"
Créer un comte sur le wiki de Resonite
Un compte sur le wiki de Resonite est gratuit et rapide a créer. Juste visitez la page de création de compte et remplissez le formulaire. Vous n'avez pas besoin d'entrer votre nom réel. Ce champ est pour un nom d'affichage.
Vous aurez aussi a compléter un captcha qui devrait être simple. Si il ne l'est pas, regardez au bas du site. Ce captcha est ici pour protéger le wiki contre le spam.
Vérifier votre courriel
Après vous être inscrit, nous vous enverront un courriel pour confirmer votre adresse. Vérifiez vos courriels pour un venant de "wiki@resonite.com". Si vous le trouvez, cliquez sur le lien pour confirmer votre compte.
Être "Automodéré"
Initialement, votre compte wiki ne pourra pas éditer de pages. Vos éditions irons dans une queue de modération. Ce processus évite le spam et le vandalisme.
Pour sortir de la queue de modération, vous devez devenir automodéré. C'est un processus dans lequel un membre de l'équipe de modération du wiki vous ajoute dans un groupe qui vous permet de passer outre la queue de modération.
Si vous avez plus de questions sur la modération du wiki, demandez sur notre Discord!
Lignes directrices d'édition
Avant de commencer, il y a quelques lignes directrices a garder a l'esprit.
Brouillons/Commentaires etc
- Juste éditez le wiki! Vous n'avez pas besoin d'un statut spécial, approbation ou permission pour éditer le wiki.
- Ne nous envoyez pas vos brouillons, juste éditez.
- N'utilisez pas Google Docs pour rédiger un brouillon. Écrire directement sur le wiki vous permet de penser comme un éditeur de wiki.
- 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:
- "Il y a un article qui explique plus" ou "Vous pouvez envoyer des commandes au Resonite Bot."
- É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
- Commencez les titres au second niveau (
- 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
- Cassez le contenu en paragraphes. Les murs de texte sont impossibles a lire.
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.
- Évitez d'utiliser des tags HTML anciens.
- Au lieu de
<b>utilisez'''. - Au lieu de
<i>utilisez''. - Ne jamais utiliser
<div><p>dans les articles.
- Au lieu de
- 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.
- Attention avec les modificateurs de textes comme le gras ou l'italique:
- Si tout est en gras, rien n'est en gras.
- Voir le guide de formatage de Wikipedia pour plus d'informations sur le gras et l'italique.
- Ici, sur le wiki de Resonite, le gras et italiques sont interchangeables. Cela pourrait changer dans le futur.
- Ne jamais utiliser
<u>pour mettre un accent sur une partie du texte. Cela peut être confondu pour un lien.
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>}}
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:
- Surlignez les informations importantes avec un éditeur d'image comme les boutons ou zones de saisie sur lesquelles l'utilisateur devrait se concentrer.
- Téléversez de grandes images et utilisez WikiText pour les redimensionner.
- 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