Ajouter un Wiki

[pgonzalezalv]

Tout est dans le titre, ça peut rendre ce dépôt git plus attractif.

[AlexandreDubray]

Salut,

Oui, ça doit être fait un jour de toute manière. Une fois qu'on aura merger la PR #4 avec la branche principale on pourra y regarder. Peut-être pourrais-tu noter ici les différentes idées que tu as pour le contenu du Wiki?

[Jimvy]

Pour moi :

• Overview de l'organisation du repo au niveau des chapitres et des exercices.
• Courte description du reST, et liens vers une cheat-sheet
• Comment ajouter des tâches INGInious : création des dossiers, les différents paramètres à mettre dans l'interface web d'INGInious, la convention au niveau des noms des fichiers, le bon exemple de fichier run (copier-coller 😉)
• Éventuellement, expliquer comment installer et configurer le serveur du syllabus et le serveur d'INGInious.

[Jimvy]

Je reviens demander un wiki (ou du moins, un meilleur README) après qu'il y ait eu des changements substantiels dans les désormais 3 repos. En effet, c'est un peu la galère de faire fonctionner le syllabus interactif (ça va encore, mais il faut quasiment lire les sources pour comprendre le fonctionnement de syllabus-webapp et l'emplacement du dossier /pages/), de télécharger le syllabus et ses exercices (indiquer le besoin d'un git submodule update au début serait bien, pour les utilisateurs qui utilisent rarement voire pas du tout les submodules), et surtout de mettre en marche INGInious en local, pour qu'il réponde aux requêtes du syllabus interactif : typiquement, qu'est-ce qu'il faut modifier dans syllabus/config.py et dans les autres fichiers (je n'ai personnellement pas trouvé).

[AlexandreDubray]

Bonjour,

Utilises-tu la VM (https://github.com/OpenWeek/vagrant-ow2017)? Si oui, est-elle buggée? Sinon, personnellement en clonant le syllabus interactif avec l'optio --recursive, en plaçant les pages à la racine du syllabus et en faisant python3 syllabus-webapp, tout fonctionne correctement.

Je suis d'accord qu'un wiki est nécessaire, mais normalement il n'y a pas de configuration spéciale à faire pour faire fonctionner le tout, et donc ce n'est pas la priorité (IMO).

Bonne journée,

Alexandre

[francoismichel]

Hello,

Il manque effectivement quelques explications sur l'url vers le cours INGInious dans le config.py. Je vais les ajouter rapidement. Concernant le submodule, je pense qu'ils est bien de ne pas cloner directement les tâches INGInious mais d'indiquer surtout une dépendance du repo vers celles-ci, dans l'optique ou le cours INGInious et les pages ne tournent pas forcément sur les mêmes machines. Mais je peux indiquer un lien vers la Doc github des submodules si besoin.

Pour le reste, concernant l'installation du syllabus et des pages, des infos sont dans le README du repo du de l'app syllabus (j'ai aussi ajouté un dossier contenant une VM pour setup l'App dans une VM CentOS avec apache WSGI, et un README qui va avec, si besoin). Pour le setup d'INGInious, le README redirige déjà vers la Doc d'INGInious avec son SimpleGrader pour expliquer comment le setup. Je préfère personnellement que les informations sur le setup d'INGInious restent dans la Doc d'INGInious.

Désolé pour les changements brusques actuels, le but étant de pouvoir proposer ça aux étudiants de BAC1 et de le setup à l'UCL en priorité cette semaine, mais des que possible, on mettra la Doc à jour. @jimvy si tu veux y participer, aucun souci, je veux bien t'expliquer comment les choses fonctionnent au niveau de la webapp :-)

François