Add README.md

This commit is contained in:
Fabrice P 2020-08-07 11:21:53 +00:00
parent b1ce8329c0
commit 47f35da250
1 changed files with 25 additions and 0 deletions

25
README.md Normal file
View File

@ -0,0 +1,25 @@
# Projet WikiLerni
## Introduction
Vous trouverez sur ce dépôt le code source du projet WikiLerni que vous pouvez visiter une instance sur cette page : https://www.wikilerni.com
Le backend est développé avec Node.js v12/Express.
Le frontend en "Vanilla.js" :-) + Babel.js pour gérer les anciens navigateurs.
Le code est fourni tel quel, sachant qu'il reste encore beaucoup de choses à faire...
Je me concentre pour l'instant sur la création des quizs et les améliorations du front-end pour les utilisateurs finaux.
Les quizs du site sont aussi libres (CC BY-SA 3.0) et utilisables de manière autonome en enregistrant le fichier html localement. Seul l'enregistrement des résultats nécessite l'appel au serveur node.js.
## Installation
Il n'y a pas de script d'installation pour l'instant.
Cela viendra, mais en attendant, si vous souhaitez tenter une installation sur votre machine (je ne promets rien !), voici la procédure à suivre :
- modifier le fichier example.env et renommer le : .env
- modifier le fichier config/instance-example.js et renommer le : instance.js
- créer une base de données vierge à l'aide du fichier models/wikilerni-crea.sql (doit fonctionner avec MySQL et MariaDB).
- installer les dépendances avec "npm install"
- lancer le serveur node + un serveur front pointant le répertoire /front/public/
- créer un premier compte utilisateur avec /front/public/inscription.html et changer son statut directement dans la base de données pour "admin" ou "manager" pour lui permettre de publier des quizs, gérer les comptes utilisateurs, etc.
- l'enregistrement du premier quiz créera la page d'accueil du site "/front/public/index.html" (entre autres).