Rechercher dans la communauté

Salut la foule, Ayant un peu de temps devant moi, je vais tenter de mettre ici un tutoriel pour contribuer (créer/modifier un test, créer/modifier un commentaire) au Projet Veda. Si ça peut encore servir ... On va essayer de faire ça simple avec des screenshot. Pour le moment, ce post est en chantier, donc non terminé et il sera complété au fil de l'eau. I. Créer un compte sur Github. (Et comprendre un peu ce qui s'y passe.) On commence par se connecter à l'adresse: https://github.com/join. Là c'est simple, il suffit de choisir un nom d'utilisateur, de spécifier son adresse email et de définir un mot de passe. Ensuite il faut trouver le dépôt (repository) qui porte le nom data.emunova.net. Il suffit d'utiliser le système de recherche. Pour rappel, Github est un service d'hébergement de dépôt Git. Ce dernier fait de la gestion de version sur du code (ou du texte). Ça permet d'avoir un historique complet de chaque modification sur chaque fichier. Dans le cas d'EmuNova le dépôt (data.emunova.net) sert à stocker toutes les données du site et uniquement les données. Il existe un autre dépôt contenant le code de génération du site qui ne nous intéresse pas ici. Par ailleurs, Github propose sur son portail (le site web github.com) des outils permettant de travailler directement en ligne et notamment faire de l'édition des données. Le dépôt data.emunova.net présente une arborescence assez simple. On peut voir les dossiers 'systems' et 'genres' qui contiennent des informations sur les différents supports de jeux et genres de jeux. Le dossier intéressant est 'games'. Il contient la liste des consoles/ordinateurs. Chacun d'eux regroupent la liste des jeux dont le test est disponible. Le dossier de chaque jeu comprend trois sous dossiers et un fichier. Le fichier 'index.json' contient des informations sur le jeu. Le dossier 'images' rassemble les images affichées sur la fiche du titre. 'reviews' stocke les différents tests sous le format 'nom.md'. 'ratings' sert quand à lui pour les commentaires avec le même format 'nom.md'. Bien entendu, tous les jeux ne possèdent pas de dossier. Voir certains possèdent un dossier à leur nom mais ne présente pas forcément de sous-dossier 'ratings' ou 'reviews', voir 'images'. La création d'un test ou d'un commentaire peut donc passer par la mise en place complète du morceau d'arborescence adéquate. II. Les commentaires : modification. (Là ça va, c'est simple.) Pour commencer simple, nous allons modifier un commentaire existant. Tiens, par exemple mon commentaire de Double Dragon sur Amstrad CPC. Magnifique non ? On se déplace dans le dossier Git qui va bien: data.emunova.net / games / amstrad-cpc / double-dragon / ratings On peut y voir le fichier rouliass.md. On clique dessus pour voir apparaître le contenu. Puis il suffit d'utiliser l'icône en forme de crayon pour proposer une modification. On tombe sur une fenêtre d'édition. Après validation (gros bouton vert "Propose the change"), la modification est prise en compte, mais partiellement. On créé ce qu'on appelle un 'fork', une copie personnelle du dépôt contenant notre modification. Comme on peu le voir sur l'image suivante: A ce moment, nous pouvons demander d'intégrer notre modification au dépôt principal en cliquant sur le bouton vert "Create Pull Request" une première fois, puis en validant une deuxième fois sur la page suivante (même bouton). On tombe ensuite sur la page récapitulative de notre demande. On peut y mettre des commentaires supplémentaires. Il faut maintenant attendre deux étapes. 1. Un des membres de l'équipe doit valider notre demande d'intégration au dépôt principal. 2. Une fois l'intégration faite, le Boss doit regénérer le site web pour afficher nos modifications. II. Les commentaires : création. (Bon ok, accrochez-vous quand même un peu.) Nous allons maintenant passer à l'étape de création d'un commentaire. Etape qui n'est guère plus compliquée. Voyons voir. Je n'ai jamais commenté Sonic Adventure 2 sur Dreamcast. N'y ayant pas joué depuis facile 10 ans, j'avais dû décrété que j'attendrais d'y retoucher pour ne pas écrire à la va-vite. Et bien tant pis, pour la science, je vais ajouter un commentaire rageux. Il faut commencer par revenir sur le dépôt "data.emunova.net", puis aller dans le dossier "/games/dreamcast/sonic-adventure-2/ratings/". Une fois au bon endroit, On peut voir une petite croix (un +) à la fin de l'indication de chemin. En cliquant dessus (il y a une info-bulle noire pour vous aider à bien repérer l'endroit) on demande l'édition d'une nouvelle page. On arrive sur un page d'édition. Il y a plusieurs chose à remplir ici. Tout d'abord, il faut nommer notre nouveau fichier <login>.md, ici <login> = surnom sur Emunova. Moi, par exemple, j'ai mis "rouliass.md". Il faut passer le retour à la ligne du mode "no wrap" à "soft wrap", sinon on devient dingue. Ensuite, il faut écrire son commentaire dans la grande partie centrale. Puis pour finir, il faut entrer un titre succinct et un commentaire qui servira aux modérateurs. Puis on clique sur "Propose new file" Voilà ce que ça donne: On arrive ensuite sur un récapitulatif de notre demande. Comme précédemment, cette création de nouveau fichier se fait sur un 'fork', une copie du dépôt principal qui nous appartient. Il faut donc cliquer sur le bouton vert "Create pull request" pour demander l'intégration sur le dépôt principal. Il ne faut pas oublier de confirmer en recliquant sur "Create pull request" dans la page suivante (qui est un récapitulatif). On finit par arriver sur une dernière page résumant la demande en cours. Il est possible d'y ajouter d'autres commentaires. Bien évidemment, ce n'est pa si simple, en réalité, votre commentaire doit ressembler à la chose suivante: On peut y voir les en-têtes indispensables que vous devez écrire vous-même (y compris pour la date). L'auteur du commentaire La note allouée La date de publication Comme pour la modification, la création passe par les deux étapes: 1. Validation de l'intégration (merge) par un membre de l'équipe 2. Regénération du site par le Boss. Et après, vous êtes heureux. IV. Et pour les tests ? (On prend les mêmes et on recommence.) Pour les tests, ça marche exactement de la même façon. Vous avez juste besoin de changer le dossier "ratings" par le dossier "reviews". Evidemment, ça, c'est pour le texte. Mais avant, il faut créer une nouvelle entrée pour un jeu. Voilà comment ça se passe. Je vais chercher à ajouter Thanatos, un bon vieux jeu des familles sur CPC. On se déplace donc dans "oncletom / data.emunova.net / games / amstrad-cpc". On clique sur la croix (+) pour faire un ajout et on écrit "thanatos/". On constate que "thanatos/" disparait de la zone éditable pour s'intégrer au chemin et qu'une nouvelle zone éditable apparait. Ça peut surprendre. Dans la nouvelle zone éditable on va taper "index.json" qui est le fichier qui va contenir les informations du jeu. Le contenu est simple: Le nom, la date de sortie, l'éditeur, le nombre de joueur et le style de jeu. Le tout est dans un format bien précis à reproduire à l'identique. Toujours selon la méthode précédente, il faut fournir un commentaire au fichier et cliquer sur le bouton vert "Propose new file". Puis demander une "Pull Request". Plus qu'à attendre l'intégration dans le dépôt principal puis la mise à jour sur le site web. Pas la peine d'attendre ces deux étapes pour commencer à écrire votre test, tout peut-être fait en parallèle et validé plus tard. Il faudra simplement penser à redemander les création du dossier du jeu (on peut le demande n fois, ce n'est pas un problème). Bon par contre, pour ajouter une image, c'est une autre paie de manches. C'est impossile avec le site web Github. Il faudra forcément passer par un client Git classique pour travailler. Je ne vais pas m'étendre sur le sujet qui risque de sérieusement rallonger le tutoriel. Donc pour le moment, il n'est pas possible d'ajouter une image à un test. V. Astuces diverses ? (Et avariées.) Ecrire en gras: **ce texte est en gras** Ecrire en italique: *ce texte est en italique* Ecrire un titre: ## Ceci est un titre Et bien d'autres à venir.