1 Code source

Trivabble est un logiciel libre, sous licence Affero General Public License (AGPL).

Son code source est disponible sur GitLab, à cette adresse : https://gitlab.com/raphj/trivabble. Les rapports de bogues et les demandes de merges se font par là, ou par courriel.

Si vous souhaitez simplement télécharger le code source :

git clone https://gitlab.com/raphj/trivabble.git

2 Installation rapide

RAPPEL: le jeu n'est pas encore considéré comme totalement stable, bien qu'il soit sensé fonctionner correctement. Mettez en place un serveur public à vos risques et périls. Cela dit, il n'y a qu'en testant qu'on arrivera à avoir un truc tout à fait stable ;-)

Le jeu doit être servi par un serveur HTTP comme Apache ou Nginx.

  1. Si vous n'avez pas encore de serveur HTTP, vous pouvez installer apache.

  2. Ensuite, clonez le dépôt dans la racine du dossier web :

    cd /var/www/html # CHANGER le dossier si nécessaire
    git clone https://gitlab.com/raphj/trivabble.git
  3. Pour que le jeu fonctionne, vous devez installer node.js et lancer le serveur :

    cd /var/www/html/trivabble
    nodejs trivabble-server.js

    Bon à savoir. toutVous pouvez interrompre et relancer l'exécution du serveur, il restaurera tout seul les parties à partir de sa sauvegarde, même si des joueurs sont en train de l'utiliser. De même, les utilisateurs peuvent rafraîchir la page web, perdre la connexion puis la retrouver, le jeu reprendra là où il en était.

    Cependant, prévenez quand même les joueurs si vous devez redémarrer le serveur en production je ne peux pas garantir que le processus de sauvegarde et de restauration prend tous les cas de figures en compte !

  4. Par défaut, le serveur écoute en HTTP sur le port 3000. Le client javascript, quand
    à lui, essaie de se connecter au serveur sur le port 80, à l'adresse /:trivabble.

    Vous devez mettre en place un proxy qui connecte http(s)://localhost/:triabble à http://localhost:3000/.

    Par exemple avec apache (il vous faudra activer les modules proxy et proxy-reverse) :

    a2enmod proxy
    a2enmod proxy-reverse
    <VirtualHost *:80> # remplacer 80 par 443 pour HTTPS
        ...
        <Location /:trivabble>
                ProxyPass http://localhost:3000/ retry=0
    
                # retry=0 est important !
    
                ProxyPassReverse http://localhost:3000/
        </Location>
        ...
    </VirtualHost>
  5. Il ne reste plus qu'à mettre en place le lancement du serveur au démarrage.

    Par exemple, avec Ubuntu 14.04 :

    sudo cat > /etc/init/trivabble.conf << 'HERE'
    start on startup
    task
    exec start-scrabble
    HERE
    
    sudo cat > /usr/local/bin/triabble << 'HERE'
    #!/bin/sh
    cd /var/www/html/trivabble # CHANGER par le chemin ou l'on trouve le dossier de Trivabble
    exec nodejs scrabble-server.js
    HERE
    
    sudo chmod +x /usr/local/bin/triabble