guide/README.md

@@ -0,0 +1,16 @@
+# Guide
+
+Tutoriel pour développer Raquette fracassante.
+
+## Formats
+
+- complet.md : en markdown (source)
+- complet.html : en HTML, à ouvrir avec un navigateur
+
+## Génération
+
+### HTML
+
+```sh
+pandoc -o complet.html complet.md --standalone --wrap=none --metadata title="Guide Godot JDLL 2024" --css=https://matcha.mizu.sh/matcha.css --toc --toc-depth=5
+```

guide/complet.md

@@ -2,44 +2,32 @@ Faire un jeu avec le Godot Engine
 =================================
 
 
-Orga
-----
+Ressources et références
+------------------------
 
+### Le jeu
 
-- Laisser les parties son à Nomys
-- Nomys sera plus dispo à partir de mercredi
-- Jovial fonce sur le guide le plus possible
-    - Ajustements sur le jeu dans un second temps
+- [Le dépôt git](https://gogs.jovian-hersemeule.eu/DricomDragon/RaquetteFracassante)
+- [Alpha Raquette sur Itch.io](https://dricomdragon.itch.io/alpha-raquette)
 
+### Outils
 
-Le jeu
-------
+- [Site officiel Godot](https://godotengine.org/)
+- [Documentation officielle Godot](https://docs.godotengine.org/en/stable/)
 
-Le dépôt git :
-<https://gogs.jovian-hersemeule.eu/DricomDragon/RaquetteFracassante>
+### Ressources
+
+- [Game Impact](https://gameimpact.fr/)
+	- [Guide sur l'inclusivité](https://gameimpact.fr/wp-content/uploads/2022/05/Representer-la-diversite-Game-Impact-2021-02-Web.pdf)
 
 Le guide
 --------
 
-
 ### Introduction
 
-
 #### Principe de l'atelier
 
-
-- Projet starter.
-    - Le projet qui servira de base à l'atelier est un casse brique
-        classique qui s'appelle Raquette Fracassante.
-    - Chaque niveau doit être complété en cassant toutes les briques à
-        l'écran grâce à une balle qui accélère à chaque rebond. Il faut
-        ainsi renvoyer la balle de plus en plus vite avec la raquette
-        tout en visant les briques à casser.
-    - Le jeu comporte des pouvoirs bonus qui pourront être débloqué en
-        récupérant les capsules qui tombent de certaines briques une
-        fois celles-ci détruites.
-
-Attention aux briques qui nécessitent d'être frappées plusieurs fois !
+Vous avez à disposition un **projet starter** en Godot. C'est un casse-brique en 2D que vous aurez la liberté d'améliorer selon vos envies.
 
 Le projet sera disponible en deux versions permettant aux personnes
 présentes lors de l'atelier d'orienter leur découverte du Godot Engine
@@ -63,10 +51,13 @@ présentes lors de l'atelier d'orienter leur découverte du Godot Engine
     - Vous êtes libres de faire les étapes dans l'ordre que vous
         voulez, mais attention aux dépendances ! Repérez vous grâce à la
         carte fournie.
+    - Le nombre de triangles sur chaque case de la carte indique la difficulté. 1 étant facile, et 4 difficile.
+
+<figure>
+![Carte des dépendances entre étapes du tutoriel](carte_des_etapes.png)
+</figure>
 
 
-Image : carte des dépendances
-![Carte des dépendances entre étapes](carte_des_etapes.png)
 
 Note : Afin que le chacun et chacune puisse ici s'y retrouver, nous
 présenteront les fonctionnalités par domaine et par niveau de
@@ -76,15 +67,13 @@ fonctionnalités qui les intéressent à notre casse-brique minimaliste.
 
 ##### Décommenter le code
 
-
-
 Il y aura du code déjà présent à décommenter dans les scripts. Essayez
 de comprendre chaque bout de code vous-même.
 
-Les commentaires en Godot commencent avec #. Raccourci pour décommenter
-les lignes selectionnées : Ctrl + K.
+Les commentaires en Godot commencent avec `#`. Raccourci pour décommenter
+les lignes selectionnées : `Ctrl` + `K`.
 
-Note : les commentaires doubles ## sont des commentaires spéciaux dits
+Note : les commentaires doubles `##` sont des commentaires spéciaux dits
 de documentation (docstrings). Il ne faut pas les décommenter ! Le texte
 associé est visible dans l'éditeur.