Skip to content

feat: ajoute les pages Dev manquantes du dépôt du jeu (#311) - #364

Open
ohugonnot wants to merge 1 commit into
mainfrom
311-pages-dev-manquantes
Open

ohugonnot wants to merge 1 commit into
mainfrom
311-pages-dev-manquantes

Conversation

@ohugonnot

@ohugonnot ohugonnot commented Oct 25, 2026 •

Copy link
Copy Markdown
Contributor

Refs #311

Le problème

La partie Dev du wiki est une copie de la documentation développeur du dépôt du jeu (unitystation/unitystation, dossier docs/), faite en 2023. Depuis, le jeu a continué à l'enrichir. Comparaison faite aujourd'hui :

  • 8 pages du jeu manquent dans le wiki ;
  • 22 pages existent des deux côtés mais ont changé ;
  • 42 pages sont identiques.

Ce que fait la PR

Elle ajoute les 8 pages manquantes. Ce ne sont que des fichiers nouveaux : aucune page existante n'est modifiée.

Page Source dans le dépôt du jeu Dernière mise à jour côté jeu
UI Actions (ActionsV2) docs/development/ActionsV2.md 2025-06-28
Async Net Messages docs/development/Async-Net-Messages.md 2025-11-27
Emotes docs/development/Emotes.md 2024-06-09
Pathfinding docs/development/How-To-Pathfind.md 2025-02-25
Hunger docs/development/Hunger.md 2026-04-02
Playing Sounds docs/development/Playing-Sounds.md 2026-03-21
Sicknesses docs/development/Sicknesses.md 2025-09-06
Admin logs docs/admin/adminlogs.md → nouveau dossier admin/, comme dans le jeu 2025-05-21

Plus 13 images, identiques à celles du jeu, rangées dans static/img/5_Dev/{ActionsV2,EmoteSO,Sicknesses}/.

Le texte est repris tel quel. Les seules adaptations sont celles qu'exige Docusaurus :

  • les encadrés « Warning » / « Tip » au format du jeu (mkdocs, !!! warning) sont convertis au format Docusaurus (:::warning) ;
  • les chemins d'images pointent vers /img/5_Dev/.... Au passage, l'image d'ActionsV2 est cassée dans le dépôt du jeu, où le chemin est faux ; ici elle s'affiche ;
  • dans ActionsV2, le titre est remonté au-dessus du premier encadré. Sinon, Docusaurus affiche deux titres et nomme la page « ActionsV2 » dans le menu ;
  • dans How-To-Pathfind, ChunkedTileMap<MetaDataNode> est mis en forme de code : écrit tel quel, il fait échouer le build.

Volontairement pas importée : GenEmoji. C'est un tableau de 4,8 Mo (14 000 lignes de HTML, plus du JavaScript) que Docusaurus 2 ne sait pas compiler. Il alourdirait aussi beaucoup le build sur le VPS. La page reste consultable sur le site du jeu.

Vérifié

  • Avant : les 8 adresses donnent une 404 en prod. Après : elles répondent dans les 4 langues (le contenu est en anglais, comme le reste de la partie Dev), avec le bon titre, sur le site construit et servi par busybox comme en prod.
  • Les 13 images s'affichent. Les encadrés sont bien rendus.
  • Build des 4 langues OK. Contrôle des liens : aucune erreur ajoutée. Robot des liens : aucun lien cassé sur les nouvelles pages.
  • Fusion testée avec toutes les PR ouvertes : aucun conflit.
  • Revue par deux relecteurs : rien à corriger.

Hors de cette PR (à voir ensuite)

  • Les 22 pages qui ont changé dans le jeu. fix: liens à antislash et menu des métiers (#117) #350 réécrit les liens de ces mêmes pages, donc cette mise à jour viendra dans une PR séparée, une fois fix: liens à antislash et menu des métiers (#117) #350 fusionnée.
  • La licence. Le jeu est passé à l'AGPLv3 dans sa doc (AGPLv3.md, novembre 2025), alors que le wiki affiche toujours une page « GPLv3 ». C'est à vous de décider ; je n'y touche pas.
  • D'autres pages existantes gardent des encadrés au format mkdocs, non convertis (Projectiles.md, How-to-Map.md).
  • La page V1 des actions (« How to use UIActions ») ne dit pas qu'elle est remplacée par la V2. C'est déjà le cas dans le dépôt du jeu.

Capture

Une des pages ajoutées (Hunger), telle qu'elle s'affiche sur le site construit :

Hunger

Pages importées depuis la doc du jeu (unitystation, dossier docs/),
fidèles à l'original :
- development/ActionsV2.md <- docs/development/ActionsV2.md
- development/Async-Net-Messages.md <- docs/development/Async-Net-Messages.md
- development/Emotes.md <- docs/development/Emotes.md
- development/How-To-Pathfind.md <- docs/development/How-To-Pathfind.md
- development/Hunger.md <- docs/development/Hunger.md
- development/Playing-Sounds.md <- docs/development/Playing-Sounds.md
- development/Sicknesses.md <- docs/development/Sicknesses.md
- admin/adminlogs.md <- docs/admin/adminlogs.md (nouvelle catégorie
  « admin », comme dans le dépôt du jeu)

Adaptations pour Docusaurus (MDX v1) :
- encadrés mkdocs « !!! warning » / « !!! Tip » convertis en
  :::warning / :::tip (ActionsV2, How-To-Pathfind) ;
- ActionsV2 : le titre « # UI Actions » passe en première ligne, avant
  le premier encadré, pour que Docusaurus le prenne comme titre de page ;
- How-To-Pathfind : ChunkedTileMap<MetaDataNode> mis entre accents
  graves, sinon MDX le lit comme une balise et le build casse ;
- chemins d'images remplacés par /img/5_Dev/... et les 13 images
  copiées dans static/img/5_Dev/ (ActionsV2, EmoteSO, Sicknesses). Le
  chemin d'ActionsV2 était déjà cassé dans le dépôt du jeu ;
- saut de ligne final ajouté quand il manquait.

GenEmoji.md n'est pas importé : la page fait 4,8 Mo de HTML et de
JavaScript, que MDX v1 ne sait pas compiler.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant