Cliquez ici pour voir le projet fonctionner
Ce projet est une application Web développée avec Frameworks Next.js et le vent arrière qui vise à aider à l'étude des langues étrangères via la musique. Une fois sur la page d'accueil de l'application, vous devez informer le nom d'une chanson et de son auteur, qui montrera une liste de chansons trouvées, alors sélectionnez simplement la chanson que vous voulez, mettez-la sur une plate-forme comme YouTube ou Spotify et combler les lacunes présentes dans les paroles avec le mot correct. Les lacunes sont dessinées au hasard, ce qui vous permet de toujours avoir des mots différents à compléter et ainsi améliorer vos compétences linguistiques en essayant d'apprendre.
Pour démarrer l'application localement, vous devez télécharger ce référentiel (soit par les options de clone GitHub, soit via un fichier .zip) et modifier le fichier modèle.env.local . Ce fichier doit être renommé .env.local et la valeur de la variable présente dans ce fichier doit être changée en une valeur valide du jeton d'accès client obtenu à partir de l'API de génie, la base du package utilisé pour obtenir les lettres. La documentation est accessible en cliquant ici.
Après cela, sur la page principale du projet, vous devrez exécuter les commandes npm i pour installer les locaux npm run dev pour démarrer le projet. Après la compilation, le projet sera disponible localement via localhost:3000 .
Remarque: le port 3000 est le port par défaut, mais je vous recommande de voir quel port le projet sera vraiment exécuté via le terminal où la commande npm run dev a été utilisée.
Si vous souhaitez accéder au projet en ligne, cliquez ici pour voir le déploiement fait sur la plate-forme Vercel.
Sur la page d'accueil de l'application, vous devez mettre le nom de la musique et la personne ou le groupe à laquelle cette chanson est associée. Dans cet écran d'accueil, vous pouvez également sélectionner la difficulté de la musique. Plus la difficulté est grande, plus les lacunes semblent vous rendre compléter. Une fois que le nom et la paternité de la chanson ont été sélectionnés, vous devez cliquer sur le bouton de recherche. Cela fera une liste de résultats pour votre rendu de recherche, puis cliquez simplement sur la carte qui contient la musique souhaitée, et ici, il convient de noter que lorsque les chansons sont obtenues via l'API, la musique en plusieurs langues est disponible. Une fois que vous avez cliqué sur la carte de musique, l'application accédera à la page de la chanson, qui a l'interface ci-dessous:

Chaque espace a deux boutons. Le premier d'entre eux est le bouton de correction indiqué par une vérification qui corrigera l'écart actuel quittant le bord vert si le mot a été tapé correctement et rouge autrement. Le deuxième bouton est le bouton de pointe représenté par une lampe. Ce bouton montrera le mot qui devrait être tapé dans cet écart. Ces actions sont individuelles et applicables uniquement à l'écart actuel.
En dehors de ces actions locales, l'interface contient six boutons d'action globale:
Pour contribuer au projet, vous pouvez ouvrir un problème dans le projet pour parler un peu de la fonctionnalité que vous souhaitez être implémentée, ou d'un bug que vous avez trouvé (j'ai fini par ne pas trouver de bugs, ce qui signifie probablement que je ne les cherchais pas assez bien hahaha). Si possible, mettez une image liée au sujet car elle facilite la visualisation et la compréhension.
Si vous souhaitez implémenter quelque chose basé sur le projet, n'hésitez pas. Ce projet est open-source, vous n'avez donc pas besoin de ma permission pour faire quoi que ce soit. Faites simplement la fourche du projet et démarrez votre implémentation à mesure que vous trouvez mieux, et si vous souhaitez envoyer un référentiel pro-demande Pro avec votre implémentation, n'hésitez pas à à l'aise. N'oubliez pas de mettre un message disant que les améliorations ou ce que vous avez implémenté. Oh, et si vous ne voulez pas faire de PR mais que vous avez utilisé ce projet comme base, vous pouvez ouvrir un numéro ici avec votre lien de référentiel car je souhaite faire une liste afin que ceux qui accèdent à ce projet puissent également accéder aux implémentations d'autres utilisateurs.
Si vous voulez faire quelque chose, mais que vous ne savez pas quoi faire, vous pouvez jeter un œil aux problèmes du projet pour voir si nous avons quelque chose d'ouverture et ensuite me demander de vous attribuer cette tâche.