Update README

This commit is contained in:
Mattéo Delabre 2020-11-28 23:14:43 +01:00
parent 5456dcd898
commit 8a75f58f46
Signed by: matteo
GPG Key ID: AE3FBD02DC583ABB
1 changed files with 12 additions and 9 deletions

View File

@ -1,26 +1,29 @@
# YouTube Maze # YouTube Maze
À loccasion du 1<sup>er</sup> avril 2017, le vulgarisateur français [e-penser](https://www.youtube.com/user/epenser1) a posté sur YouTube un réseau de vidéos interconnectées à la manière dun labyrinthe. À chaque vidéo, le vidéaste nous laisse le choix den visionner deux autres, et nous met au défi de toutes les regarder pour parvenir à trouver une vidéo mystérieuse. Some YouTube creators have made video “gamebooks” by creating videos in which viewers can make choices that influence the course of the narration.
This is generally implemented by breaking up the video into short and interlinked segments.
This project aims at automatically exploring those video mazes and creating a visual representation of the underlying network.
Ce dépôt contient le code utilisé pour générer [un graphe de dépendances de chaque vidéo vers celles liées](https://matteo.delab.re/projects/epenser-maze), permettant daccéder directement à la vidéo mystérieuse. [See it live →](https://youtube-maze.cloud.delab.re)
## Technologies ## How Does it Work?
* [JavaScript (ES6)](https://fr.wikipedia.org/wiki/JavaScript) : langage de programmation interprété. The [algorithm](lib/explore.mjs) starts at the first video and explores the links recursively using a breadth-first search approach, keeping track of the links as it goes.
* [Node.JS](https://fr.wikipedia.org/wiki/Node.js) : environnement dexécution de JavaScript. The [Graphviz](http://www.graphviz.org/) library is used to automatically layout the graph so that as few edges cross as possible.
* [Graphviz](http://www.graphviz.org/) : outil pour visionner et générer des représentations de graphes.
## Générer le graphe ## Running Locally
Pour générer le graphe par vous-même, vous devez au préalable avoir installé Node.JS et Graphviz. Ensuite, lancez les commandes suivantes dans un terminal : You can also run the server locally, provided you have a working installation of Node.JS and Graphviz.
``` ```
git clone https://forge.delab.re/matteo/youtube-maze.git git clone https://forge.delab.re/matteo/youtube-maze.git
cd youtube-maze cd youtube-maze
npm install npm install
npm run build npm start
``` ```
If everything goes as planned, you should be able to access the server by opening `http://localhost:3000` in your browser.
## License ## License
This software is made available under the MIT license. This software is made available under the MIT license.