Voir également : Guide de contribution au wiki d'osu!
Cet article décrit les aspects techniques ou administratifs du wiki d'osu!. Il couvre également les procédures de maintenance, qui sont nécessaires pour le garder à jour - peut-être pourrez-vous aider avec l'une d'entre elles. Pour toutes les discussions relatives au wiki, utilisez le channel #osu-wiki
du serveur Discord d'osu!.
Page principale : Liste des mainteneurs du wiki d'osu!
Les administrateurs sont des personnes ayant un accès collaborateur au dépôt ppy/osu-wiki
, où tous les articles et les news sont stockés. Ils peuvent trier et étiqueter les issues, gérer les pull request ouvertes et prendre des décisions concernant le présent et l'avenir du wiki d'osu!.
Les mainteneurs effectuent le review finale des pull requests et les merge. Si vous avez une contribution qui nécessite de l'attention, demandez à l'un d'entre eux dans le channel #osu-wiki
.
Le suivi des issues du wiki d'osu! contient des idées et des demandes d'améliorations possibles, tant pour les articles eux-mêmes que pour les parties du site web liées au wiki. Ouvrez un issue si vous avez une demande de fonctionnalité, ou si vous avez trouvé une erreur sur l'une des pages. Veuillez noter que cela ne concerne que le wiki d'osu! - si vous avez besoin d'aide pour d'autres projets officiels liés à osu!, utilisez leur propre système de suivi des issues :
Sur GitHub, les pull requests et les issues peuvent être étiquetées et classées en utilisant des tags, qui montrent différents aspects d'une pull request ou d'une issue. Les étiquettes sont informatives, définies par les mainteneurs du wiki, et sont généralement explicites. Bien qu'elles ne nécessitent aucune action de la part de l'utilisateur, les étiquettes rouges servent de rappel ou d'appel à l'action pour les autres mainteneurs :
rule change
: le changement affecte un ensemble de règles existant, comme les critères de classement, et doit être review par le propriétaire de la zone.blocked
: le changement soulève des questions qui doivent être résolues avant de procéder, ou dépend d'une autre question qui doit être résolue en premier lieuneeds rebase
: la pull request contient trop de petits commentaires non structurés, qui doivent être reformulés d'une meilleure manière ; cela est généralement fait par les mainteneurs juste avant le merge.La plupart des articles du wiki d'osu! ont des liens alternatifs, qui sont configurés en utilisant le fichier redirect.yaml
. Les redirections sont destinées à être utilisées en dehors du wiki d'osu!, par exemple, sur les forums, ou dans le tchat, où elles peuvent être rapidement transformées en référence en ligne :
Selon les [[RC]], cela est interdit.
Lorsque vous ajoutez des redirections pour un article nouveau ou existant, gardez à l'esprit qu'elles doivent être concises et conçues pour une utilisation réelle.
Le dépôt osu! wiki utilise une intégration continue (CI) pour vérifier automatiquement les pull requests pour diverses erreurs courantes. La liste des vérifications est configurée dans le fichier continuous-integration.yml
.
Le fichier package.json
liste tous les plugins (remark) utilisés par les CI, dont certains ont été écrits par les responsables du wiki d'osu!.
Les vérifications des CI sont exécutées automatiquement sur chaque commit d'un contributeur récurrent. Pour que leurs pull requests soient fusionnées, les contributeurs sont censés corriger les erreurs signalées par les CI. Pour voir le statut des vérifications, procédez comme suit :
osu-wiki continuous integration
, et cliquez sur le lien Details
.run remark on changed files
. Chaque constatation est accompagnée de son emplacement exact dans un fichier et d'une brève description de la raison pour laquelle il s'agit d'une erreur.Certaines erreurs apparaissent également sous forme d'annotations dans l'onglet Files changed
sous la ligne où le problème a été détecté.
Si vous avez besoin d'aide pour décrypter les CI, vérifier les messages d'erreur ou résoudre des problèmes, demandez dans le channel #osu-wiki
sur Discord.
Les vérifications des CI empêchent normalement les pull requests contenant des erreurs d'être merge. Cependant, dans le cas de fausses erreurs ou de bugs découverts dans les contrôles, ils peuvent toujours être contournés en tant que sécurité. Il y a quelques situations où le contournement intentionnel d'un contrôle CI est acceptable, comme indiqué ci-dessous. Contactez un mainteneur si vous avez besoin de contourner une vérification pour une raison qui n'est pas mentionnée ici.
À titre de référence, vous trouverez ci-dessous un tableau de tous les contrôles des CI dans l'ordre :
# | Contrôle | Outil | Explication | Contournement |
---|---|---|---|---|
1 | Taille des fichiers | meta/check-file-sizes.sh |
Indique si un fichier image est inférieur à la limite de taille des fichiers images des articles et des news (1 MB). Donne un avertissement pour les fichiers de plus de 0,5 Mo. | Aucun. |
2 | Markdown | remark via le fichier meta/remark.sh |
Si la syntaxe Markdown est correcte et cohérente dans les articles du wiki et les news. | Ajoutez SKIP_REMARK n'importe où dans la description de la pull request. Pour supprimer de façon permanente une erreur spécifique, ajoutez <!-- lint ignore rule-name --> au-dessus de la ligne incriminée, où rule-name est la règle à ignorer. |
3 | YAML | Commande check-yaml de osu-wiki-tools |
Si la syntaxe YAML est correcte et cohérente dans le fichier redirect.yaml et dans le front matter |
Aucun. |
4 | Liens wiki rompus | Commande check-links de osu-wiki-tools |
Si les liens wiki internes pointent vers un article, un news ou une section d'article. | Ajouter SKIP_WIKILINK_CHECK n'importe où dans la description de la pull request. |
5 | Traductions obsolètes | Commande check-outdated-articles de osu-wiki-tools |
Si les traductions sont correctement marquées comme obsolètes lors de la mise à jour d'un article en anglais. | Ajouter SKIP_OUTDATED_CHECK n'importe où dans la description de la pull request. |
no-heading-punctuation
Les points de suspension dans les titres ne sont normalement pas utilisés car les titres ne sont généralement pas des phrases et ne sont donc pas autorisés. Cependant, il arrive que la ponctuation de fin soit nécessaire, par exemple parce que le titre d'une musique ou le nom d'un artiste en contient.
<!-- lint ignore no-heading-punctuation -->
### Amusing Reflection Rag.
heading-increment
Normalement, les niveaux de rubrique ne peuvent augmenter que d'un seul à la fois. Pour les infobox cependant, seuls les niveaux de rubrique 4 et 5 sont autorisés, ce qui peut entrer en conflit avec cette règle.
# Liste des mappeurs préférés de peppy
::: Infobox
<!-- lint ignore heading-increment -->
#### peppy
Créateur d'osu!
:::
Voir également : Critères de style des articles/Mise en forme § Liens du wiki
Les contributeurs sont encouragés à réparer les liens rompus lors de la mise à jour des articles. Cela dit, dans certaines situations, cela peut nécessiter plus de travail que ce qui est pertinent pour la pull request :
Voir également : Critères de style des articles/Mise en forme § Traductions obsolètes et Critères de style des articles / Écriture § Parité du contenu
Il est possible d'ignorer la vérification des traductions obsolètes (et de ne pas marquer les traductions comme obsolètes) pour des modifications mineures de la rédaction, des ajustements grammaticaux et autres, qui n'affectent pas le sens de l'article.
Le wiki d'osu! est intégré au site web d'osu!, ce qui signifie que toutes les demandes de fonctionnalités techniques doivent être faites et suivies dans le dépôt ppy/osu-web
. Pour informer les autres contributeurs de votre demande, assurez-vous de lier le problème dans le channel Discord #osu-wiki
, ou dans le gestionnaire d'issues du wiki d'osu!
Certaines fonctionnalités ne sont pas directement liées au site web d'osu!, mais peuvent être utiles pour contribuer ou pour l'entretien général. Dans ce cas, elles sont implémentées par des personnes capables de le faire et ne sont pas ajoutées au site web directement :
Note : le site web osu-wiki status affiche une liste de tous les articles nécessitant une maintenance, répartis par catégorie.
Le wiki s'appuie sur les contributions de la communauté d'osu!. Vous pouvez aider les mainteneurs et les autres contributeurs en faisant votre part. Pour savoir comment faire, lisez le guide de contribution. Si à un moment donné vous vous sentez bloqué, demandez de l'aide dans le channel #osu-wiki
du serveur Discord d'osu!.
Pour une liste des traductions et leur exhaustivité, voir : osu-wiki status
Le wiki d'osu! est lu par des personnes du monde entier. Pour aider votre communauté locale et attirer de nouveaux joueurs, mappeurs, moddeurs et développeurs dans le jeu, vous pouvez traduire les articles en anglais, ou mettre à jour les traductions existantes qui ont pris du retard. Consultez la liste des langues supportées par le wiki d'osu!, et assurez-vous que votre traduction respecte le principe de parité de contenu. Si vous parlez couramment et que vous êtes un rédacteur expérimenté, attaquez-vous à des sujets clés tels que des articles sur les règles ou les critères de classement. Si vous n'en êtes qu'au début de votre carrière de rédacteur, choisissez un petit article pour recevoir l'aide et les conseils d'évaluateurs natifs.
Une traduction peut être merge sans être reviewée par un natif s'il s'est écoulé plus d'une semaine depuis la date de création de la traduction.
Pour l'étendue possible du travail, voir : Liste des stubs existants (anglais)
Certains articles du wiki d'osu! sont incomplets et manquent d'informations. Ces articles sont marqués comme stubs, ce qui signifie qu'ils sont suffisamment importants pour exister en tant que pages individuelles, mais qu'ils seront complétés plus tard. Si vous êtes familier avec le sujet de l'article, contribuez-y et partagez vos connaissances.
L'une des principales caractéristiques de tout wiki est la connectivité, c'est-à-dire que les articles renvoient à des pages connexes, ce qui aide le lecteur à rester dans le flux. Pour relier les articles, ajoutez des liens vers les termes mentionnés lorsqu'ils sont importants pour une meilleure compréhension du sujet. Créez des liens vers des sections individuelles de l'article si nécessaire, et utilisez des pages de désambiguïsation pour les termes généraux.
osu! est un environnement en constante évolution : la communauté créent de nouvelles beatmaps, invente de nouveaux moyens d'expression et fait d'autres nouvelles choses. Si un événement ou un terme n'est pas couvert, n'hésitez pas à écrire un article à ce sujet et à contribuer à la connaissance globale. Nouveau tournoi ou concours ? Nouvelle fonctionnalité d'osu! ? Une partie inconnue de l'histoire ? Mettez à profit vos talents de rédacteur.
Pour l'étendue possible du travail, voir : Liste des TODO existants (anglais)
Les articles existants ont également besoin d'être entretenus. Si vous avez trouvé une erreur, s'il manque des détails, ou si vous voulez simplement réécrire/étendre l'article en fonction de la réalité, faites un pas en avant et faites du wiki d'osu! un meilleur endroit. Si le changement que vous envisagez est suffisamment important ou significatif, assurez-vous d'en discuter dans le channel #osu-wiki
, ou créer un issue de suivi.