Aller au contenu
Emu Nova Forums

Rouliass

Rétro gameur·se
  • Compteur de contenus

    1 382
  • Inscription

  • Dernière visite

Messages posté(e)s par Rouliass

  1. Bon voilà, j'ai bien détaillé tout le processus pour modifier ou créer un commentaire sur un jeu. Pour créer ou modifier un test, ça fonctionne de la même façon. Il suffit de changer le chemin. "ratings" devient "reviews".

    Ah oui, par contre, j'ai explosé mon quota de stockage. Il va falloir que je remanie mes images pour les rendre plus light.

    Edit: fausse alerte, je viens de voir que j'ai oublié certains trucs

  2. Ah bah voilà, je pense que j'ai la réponse à une partie de mes questions.

    J'ai fait un 'commit' à partir du dépôt master. Ce qui a créé mon dépôt personnel (fork du master).

    Seul des utilisateurs avec des droits d'accès en écriture sur le master peuvent valider les 'commit' en faisant un 'merge' des deux branches via un 'pull request' (que je n'avais pas fait donc).

  3. Ah j'y pense, la dernière fois je l'avais fait revenir en soumettant une modification de test sur github. Tu peux tenter de rajouter une virgule quelque part pour voir.

    J'ai déjà fait des modifications sur Github. C'est justement là que se trouvent mes interrogations.

  4. > Pour l'accent --> Mon accent anglais ? ;)

    Je suis toujours fasciné par la capacité des canadiens francophone à switcher d'accent en milieu de phrase si un mot anglais se présente.

    > Pour ma photo --> J'y pense... Mais où sont les votres de photos ? ;)

    Si ma mémoire est bonne, il y a un topic quelque part pour ça, impossible de le retrouver. Je pense que de toutes façons, il y avait surtout quelques blagues. :)

    > J'ai cru comprendre qu'il était maintenant possible de poster plus facilement ses tests ?

    Alors, heu, pas vraiment. J'ai commencé à rédiger un tutoriel pour ça et je me suis heurté à divers trucs sur Github. J'attend des news du boss (mail envoyé le 16/04). J'ai l'impression que c'est pas super bien engagé vu la baisse drastique d'activité ici.

  5. C'était une bonne idée la tentative de refonte avec le système des contributions, mais c'est vraiment compliqué de redynamiser Emu Nova, avec l'évolution d'internet. Je crois que le site a fait son temps.

    Oui, c'est possible.

    Je vais quand même tenter de contacter le taulier directement sur son adresse mail plutôt que par la messagerie interne du forum.

  6. 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.

    ea266667-e899-44c6-84a7-bef96c8b677c.jpg

    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.

    8a8f15c1-088f-40a9-add6-d4fcc6b0a40a.jpg

    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.

    819ea257-22e4-4ff7-8601-4bedf19487cc.jpg

    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.

    f2fb303b-3221-49c4-80c2-6ba1f9aeca3a.jpg

    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.

    65197fba-3df3-4143-83c8-474d73261ac6.jpg

    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.

    dda7a48a-f61b-41b9-a1b8-79d7a4b701bb.jpg

    On tombe sur une fenêtre d'édition.

    82c74946-6bd8-483a-9322-8c1083e5d66f.jpg

    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:

    7b98057a-7e5e-477c-b5df-ea684d116966.jpg

    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.

    bc478fa1-38d6-470c-a348-f972b0b33ad8.jpg

    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.

    post-50026-0-20504600-1434012196_thumb.png

    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:

    post-50026-0-90627100-1434012202_thumb.png

    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.

    post-50026-0-26917700-1434012209_thumb.png

    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.

    post-50026-0-25434900-1434012217_thumb.png

    Bien évidemment, ce n'est pa si simple, en réalité, votre commentaire doit ressembler à la chose suivante:

    post-50026-0-00815400-1434012226_thumb.png

    On peut y voir les en-têtes indispensables que vous devez écrire vous-même (y compris pour la date).

    1. L'auteur du commentaire
    2. La note allouée
    3. 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/".

    post-50026-0-81346100-1434019293_thumb.png

    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.

    post-50026-0-29535000-1434019298_thumb.png

    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".

    post-50026-0-05685300-1434019303_thumb.png

    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.

×
×
  • Créer...