parmentelat / moocpython

16 stars 7 forks source link

PDF session 2 #15

Open Karduin opened 6 years ago

Karduin commented 6 years ago

Bonjour Thierry, Je relance le projet avec la nouvelle session qui tient compte des modifications. C'est beaucoup pus facile que la dernière fois. Les fichiers de départ sont plus fiables et l’expérience de l'année dernière me fait gagner beaucoup de temps. Comme je ne sais pas si tu veux rendre visible le github tout de suite, je te laisse gérer l'information sur Fun mooc. Je ne sais pas si tu veux par exemple verrouiller ou supprimer les fichiers de la première session.

Cordialement, Jean-Michel

parmentelat commented 6 years ago

Bonjour Jean-Michel

C’est très sympa de ta part, et ça répond à une demande de la part des étudiants :)

La solution à laquelle je penserais en premier consisterait à utiliser le code dans le repo github moocpython pour produire les pdf, puis diffuser ces pdf en ligne depuis la plateforme FUN De cette façon je pense qu’on touchera le plus grand nombre de participants.

est-ce que ça peut fonctionner comme ça pour toi ? si oui, je peux même diffuser le pdf actuel comme le pdf de la semaine 1..

à nouveau un grand merci, c’est vraiment très utile :)

— Thierry

On 20 Sep 2018, at 10:43, Karduin notifications@github.com wrote:

Bonjour Thierry, Je relance le projet avec la nouvelle session qui tiens compte des modifications. C'est beaucoup pus facile que la dernière fois. Les fichiers de départ sont plus fiables et l’expérience de l'année dernière me fait gagner beaucoup de temps. Comme je ne sais pas si tu veux rendre visible le github tout de suite, je te laisse gérer l'information sur Fun mooc. Je ne sais pas si tu veux par exemple verrouiller les ou supprimer les fichiers de la première session.

Cordialement, Jean-Michel

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub, or mute the thread.

Karduin commented 6 years ago

Pas de problème pour moi, allons-y.

Tout est dans pdf-session-2

parmentelat commented 6 years ago

On 20 Sep 2018, at 15:58, Karduin notifications@github.com wrote:

Pas de problème pour allons-y.

Tout est dans pdf-session-2

— You are receiving this because you commented. Reply to this email directly, view it on GitHub, or mute the thread.

Bonjour Jean-Michel

Comment est-ce qu’on peut s’organiser pour les semaines suivantes ?

Je vois deux points: . est-ce qu'on fait un pdf avec les semaines de 1 à n, ou juste la semaine n ? . à quel moment de la semaine c’est le mieux de le faire ?

pour le premier point, il faut savoir qu’il y a une limite - de 10M je crois - à la taille des fichiers que je peux uploader dans FUN donc peut-être c’est mieux de faire juste la semaine n; mais bon si je me fie à ce que je vois dans pdf_du_cours le truc complet l’an passé faisait moins de 3 Mo, donc l’autre option est jouable aussi..

pour le second point, c’est toi qui me dit ce qui t’arrange le mieux, et je m’organise si c’est pareil pour toi, on peut le mettre en ligne dès le lundi, mais ça n’est vraiment pas une obligation

en tous cas MERCI d’avoir proposé de t’occuper de ça :)

enfin pour info: nous sommes en train de réfléchir à l’idée de transformer le cours en un cours permanent; il serait ouvert tout le temps, avec des phases - genre tous les 2 ou 3 mois - pour délivrer les attestations (en fait il y a déjà un cours Inria sur ICN qui fonctionne comme ça, nous pourrions nous inspirer de ce mode de fonctionnement)

— Thierry

Karduin commented 6 years ago

Bonjour Thierry,

En ce qui concerne le premier point, 1 pdf semaine 1 à n me parait plus judicieux. En tant qu'étudiant, un seul document avec toutes les infos me semble plus facile à gérer. Pas de dispersion de document et table des matières pour facilités la recherche.

Et comme tu l'as remarqué, le poids n'est pas excessif.

Pour le second point, j'ai eu la même réflexion à savoir qu'avoir la doc pendant les exercices cela évite les aller / retour sur le site.

J'ai donc anticipé la réalisation de la deuxième semaine en forkant le repo flotpython. Avec Anaconda et jupyter je lance une session en local afin d’exécuter les notebooks. Il y a juste les exercices qui ne se charge pas mais cela doit être juste une question de path.

Tout ça pour dire que publier le lundi me parait une bonne idée. j'essaierai que tout soit prêt avant.

Le seul bémol éventuel, peux se produire si l'équipe modifie un notebook aprés ma recup. Du coup le pdf ne sera pas tout à fait en phase.

Je vais finir la deuxième semaine avant dimanche soir. Il manquera peut-être les notebooks avec exercices sauf si je les insère sans les exécutés et que je modifie ensuite quand il seront en ligne.

Jean-Michel

Karduin commented 6 years ago

mauvaise manip

Karduin commented 6 years ago

Mise à jour semaine 2 OK.

Dans w2-s5-c2-presentation :

Notebooks exercices :

Les notebooks concernés :

PS : Si tu préfères qu'on fractionne les semaines et que l'on compile tout à la fin de la session c'est faisable très facilement puisque j'ai déjà toute la structure.

parmentelat commented 6 years ago

bonjour Jean-Michel

j’ai sorti nbautoeval du cours; pour installer nbautoeval, faire simplement

pip3 install nbautoeval

pour le reste, voir inline..

On 22 Sep 2018, at 15:49, Karduin notifications@github.com wrote:

Mise à jour semaine 2 OK.

Dans w2-s5-c2-presentation :

• le module fait dans les 600 lignes, cela ne m’a pas paru indispensable de l’afficher. Qu'en penses tu ?

bien d’accord.

Notebooks exercices :

• Je trouve bien les fichiers d'exercices mais cela bloque ensuite avec nbautoeval. J'ai quand même inclus les notebooks concernés dans le pdf. C'est dommage, je voulais juste exécuter les cellules d’exemples.

j’ai publié pour l’instant le pdf actuel, dis-moi s’il y a lieu de le mettre à jour

Je ferais une mise à jour des notebooks exercices après leur publication sur FUN, à moins que tu ne me dise que ce n'est pas utile. Les notebooks concernés :

• w2-s2-x1-expressions-regulieres • w2-s6-x1-label • w2-S6-x2-inconnue • w2-s6-x3-laccess • w2-s6-x4-if-et-def equation • w2-s6-x5-wc • w2-s7-x1-list-p • w2-s7-x2-carre

c’est-à-dire, à quoi penses-tu exactement ? d’après moi, on n’a pas besoin de lier la publication des corrigés avec celle des pdf, c’est déjà très lourd comme ça …

Merci !

Karduin commented 6 years ago

Bonjour Thierry,

c’est-à-dire, à quoi penses-tu exactement ? d’après moi, on n’a pas besoin de lier la publication des corrigés avec celle des pdf, c’est déjà très lourd comme ça …

Je ne pensais pas à la correction mais aux exemples de ce qui est attendu. Dans le fond cela n'a pas un grand intérêt puisqu'il faut faire le travail en ligne. Je bosse sur la suite. (Mon clavier déraille issue closed par erreur :-(

Karduin commented 6 years ago

Bon je prend un peu d'avance avec le pdf de la semaine 1 à la semaine 3. Histoire de faire la suite sans pression. ;-)

parmentelat commented 6 years ago

Ok pas de souci bien sûr

Pour info, je mets un tag du genre py3s2-w2 sur le commit qui m'a servi de base pour publier le pdf que j'attache à la semaine 2

Par contre il semble que le pdf dans le dernier commit 312e3c31ce841677306a9b43a149aa7b194c1d6a est identique à ce que, justement, j'ai publié pour la semaine 2, non ?

Karduin commented 6 years ago

Non, celui que tu as publié concerne les semaines 1 à 2 tandis que le commit 312e3c3 concerne les semaines 1 à 3.

parmentelat commented 6 years ago

ah c'est bizarre, on parle bien de pdf-session-2/Python.pdf ?

parce que moi je vois 137 pages dont la dernière est sur l'exercice Compréhensions (2) sur la mise au carré, qui est la fin de la semaine 2 non ?

parmentelat commented 6 years ago

ah ça y est je viens de voir l'autre fichier dans le même répertoire ...

j'ai besoin d'un deuxième cerveau ;)

parmentelat commented 6 years ago

tant que j'y suis, j'enlève les .aux du repo git

Karduin commented 6 years ago

j'ai besoin d'un deuxième cerveau ;)

haha;-)

tant que j'y suis, j'enlève les .aux du repo git

Oui je ne les mettrait pas la prochaine fois, c'est vrai que cela n'a pas d’intérêt.

Karduin commented 6 years ago

Mise à jour semaine 4

Ainsi que les fichiers .tex

Karduin commented 6 years ago

Update w2-s1-c1

Python-s1-to-s3.pdf Python-s1-to-s4.pdf

parmentelat commented 6 years ago

Il y a eu un fil Confusion entre encodage des entrées-sorties et encodage du fichier

un étudiant a mis en évidence un gros contresens, et j'ai modifié le notebook w2-s1-c1-accents.ipynb

Ce serait bien, comme le suggère un élève, qu'on puisse modifier les pdf pour prendre ça en compte. Je ne suis pas sûr de comment faire moi-même On peut commencer avec Python-s1-to-s3.pdf, celui de la semaine 2 sera bientôt obsolète

Ça me suggère que

ou peut-être d'ailleurs on pourrait ne publier que la somme, si c'est plus pratique ? moi ça m'est égal si on publie des trucs en avance, les gens ne sont pas obligés de le lire

je cherche juste à te rendre la vie la plus simple possible - qu'en penses-tu ?


PS. je suis intrigué aussi parce que tu viens de publier des commits qui concernent le même notebook et pourtant je vois toujours la phrase

C’est à cela que sert la balise

qui normalement aurait dû disparaitre

Karduin commented 6 years ago

Autant pour moi ! J'avais bien suivi le fil, et j’étais persuadé d'avoir bien mis à jour, mais j'avais manqué le Reset to Original. Du coup je modifie et je commit les bons fichiers.

On peut commencer avec Python-s1-to-s3.pdf, celui de la semaine 2 sera bientôt obsolète

Oui, c'est pour ça que j’étais parti sur s3 et s4

Publication

OK je vais faire à la semaine + un cumulé.

Le cumulé est indispensable pour la table des matières.

Je ne maitrise pas encore très bien github. J'ai fait mon premier pull-request hier sur flotpython pour les numéros de lignes qui ont changés. J'avais peur de faire une bêtise mais c'etait plus simple que ce que je pensais. Je n'ai pas bien saisi cette histoire de balise. Un éclaircissement ou un lien qui explique ? :-)

parmentelat commented 6 years ago

On 27 Sep 2018, at 11:50, Karduin notifications@github.com wrote:

Je n'ai pas bien saisi cette histoire de balise. Un éclaircissement ou un lien qui explique ? :-)

non rien de complique, je voulais juste citer une phrase qui était dans la version obsolete de notebook et plus dans la version corrigee, pour te permettre de verifier rapidement que c’etait la bonne version dans le pdf final..

Karduin commented 6 years ago

Histoire de rester cohérent, j'ai refais :

parmentelat commented 6 years ago

On 27 Sep 2018, at 13:56, Karduin notifications@github.com wrote:

Histoire de rester cohérent, j'ai refais :

• 1 pdf par semaine • Python-s1.pdf • Python-s2.pdf • Python-s3.pdf • Python-s4.pdf • Les cumulés • Python-s1-to-s3.pdf • Python-s1-to-s4.pdf — You are receiving this because you commented. Reply to this email directly, view it on GitHub, or mute the thread.

Je publierai donc en semaine 3

et ainsi de suite les semaines suivantes

Merci infiniment !

Karduin commented 6 years ago

Bonjour Thierry,

Suite à la remarque d'un étudiant j'ai modifié la numérotation des pages. La page 1 est maintenant le chapitre 1.

Ce qui fait que maintenant même si la TOC grandit, la numérotation des pages reste la même. On peut donc à partir des pdf complets n'imprimer que le dernier chapitre et la TOC sans être obligé de tout réimprimer à cause de la pagination.

Bien sur cela ne marche pas avec les pdf hebdos.

Je vais le préciser en réponse dans le fil.

Merci infiniment !

Pas de problème ;-)

parmentelat commented 6 years ago

Comme je disais, je vais publier en semaine n:

J'ai modifié la page 'Info du cours' pour la semaine 3 dans ce sens.

Aussi je mets sur ce repo un tag, par exemple py3s2-w3, qui indique de quel commit je pars lorsque j'uploade les fichiers sur FUN

Comme ça on devrait s'y retrouver :)

Karduin commented 6 years ago

Bonjour Thierry,

est ce que cela aurai un intérêt d’insérer un montage de screenshots iPythonTutor dans le pdf ?

Exemple pour w2-s4-c1

Dans ce genre ou un autre suivant tes préférences.

parmentelat commented 6 years ago

On 2 Oct 2018, at 10:45, Karduin notifications@github.com wrote:

Bonjour Thierry,

est ce que cela aurai un intérêt d’insérer un montage de screenshots iPythonTutor dans le pdf ?

Exemple pour w2-s4-c1

Dans ce genre ou un autre suivant tes préférences.

— You are receiving this because you commented. Reply to this email directly, view it on GitHub, or mute the thread.

Bonjour Jean-Michel

Oui effectivement ce serait pas mal; une façon de faire serait de faire une digression au moment où on fait appel à pythotutor la première fois dans le cours w2-s4-c1 qui est, je m’en rends compte maintenant, justement l’exemple que tu as pris pour faire ton illustration

J’ai essayé de retoucher l’image que tu as préparée, sans trop y arriver; j’aurais juste remplacé les ‘Step1’ etc.. par le code correspondant; a1 = [0, 1, 2] etc.. Ça serait plus parlant en effet; cela dit bon, ça n’est pas non plus critique puisque les gens ne pourront pas aller plus loin que ça avec le pdf Mais peut-être qu’effectivement, pour la version en ligne, ça parlera plus aux gens si on leur montre un exemple de ce que fait pythontutor, sans qu’ils aient besoin d’y aller vraiment…

Merci pour cette idée — Thierry

Karduin commented 6 years ago

Bonjour Thierry, juste un petit mot pour préciser que la dernière version de python-s1-to-s4.pdf est théoriquement à jour des dernières corrections. Si j'ai le temps ce week-end, je mettrais à jour le S4 seul.

parmentelat commented 6 years ago

Je viens de publier les deux fichiers (s4 et s1-to-s4) Merci Fangh !

Karduin commented 6 years ago

Je travaille sur la semaine 5 et cette phrase me parait étrange (w5-s6-c2-modules-et-chemins) :

En admettant que vous rangez ce fichier dans le fichier /le/repertoire/d/installation/run.py, et que vous le lancez à partir de /le/repertoire/ou/vous/etes, avec une variable PYTHONPATH vide, vous devriez observer :

Est-ce bien ce que tu voulais dire ? ou quelque chose dans ce genre :

parmentelat commented 6 years ago

Bonjour Jean-Michel

Je viens de pousser une version amandée qui devrait je l’espère être plus claire sur ce point

merci ! — Thierry

On 15 Oct 2018, at 14:09, Karduin notifications@github.com wrote:

Je travaille sur la semaine 5 et cette phrase me parait étrange (w5-s6-c2-modules-et-chemins) :

En admettant que vous rangez ce fichier dans le fichier /le/repertoire/d/installation/run.py, et que vous le lancez à partir de /le/repertoire/ou/vous/etes, avec une variable PYTHONPATH vide, vous devriez observer :

Est-ce bien ce que tu voulais dire ? ou quelque chose dans ce genre :

• En admettant que vous rangez ce code dans le fichier • En admettant que vous rangez le fichier run.py dans le répertoire — You are receiving this because you commented. Reply to this email directly, view it on GitHub, or mute the thread.

parmentelat commented 6 years ago

On 15 Oct 2018, at 14:37, Thierry Parmentelat thierry.parmentelat@inria.fr wrote:

Bonjour Jean-Michel

Je viens de pousser une version amandée qui devrait je l’espère être plus claire sur ce point

merci ! — Thierry

On 15 Oct 2018, at 14:09, Karduin notifications@github.com wrote:

Je travaille sur la semaine 5 et cette phrase me parait étrange (w5-s6-c2-modules-et-chemins) :

En admettant que vous rangez ce fichier dans le fichier /le/repertoire/d/installation/run.py, et que vous le lancez à partir de /le/repertoire/ou/vous/etes, avec une variable PYTHONPATH vide, vous devriez observer :

Est-ce bien ce que tu voulais dire ? ou quelque chose dans ce genre :

• En admettant que vous rangez ce code dans le fichier • En admettant que vous rangez le fichier run.py dans le répertoire — You are receiving this because you commented. Reply to this email directly, view it on GitHub, or mute the thread.

suite aux remarque de kordeo, je pense avoir compris le souci avec les listes qui ne sortaient pas bien

en fait en markdown

le souci c’est qu’en jupyter la ligne blanche est optionnelle et en bon fainéant je ne la mettais pas toujours; et quand on ne la met pas eh bien la traduction en latex puis pdf présente bien le symptome de la liste toute machées dont kordeo a relevé plein d'exemplaires

à partir de maintenant. ma moulinette de normalisation des notebooks prend ça en charge automatiquement les pdf qu’on générera devraient donc être plus propres de ce point de vue.

par contre ça fait pas mal de trafic dans les notebooks..

— Thierry

Karduin commented 6 years ago

Bonne nouvelle ! C'est du travail en moins. Je vais tester avec la semaine 6, j'ai fini la 5 hier.

Si votre projet de transformer le cours en un cours permanent se fait, je présume que le contenu évoluera. Si tu veux, on peut peut-être prévoir de mettre à jour les pdf régulièrement. Je ne sais pas à quel fréquence mais on doit pouvoir s'organiser.

Karduin commented 6 years ago

Bonjour Thierry, en travaillant sur la semaine 6 :

Ben alors tu ne fais pas du PEP8 ;-) Ta moulinette peux gérer ça ?

Edit: Update S6 OK

parmentelat commented 6 years ago

Bonjour Thierry, en travaillant sur la semaine 6 :

• Pour le moment les listes ne poses pas de problèmes. 👍 • Je ne m’était pas rendu compte avant, mais les cellules de codes ou de résultat ne sont pas PEP8 (+ de 80 caractères). Du coup je bricole des retours à la ligne sinon les lignes concernées n'apparaissent pas en entier dans le document. (dépassement des marges sans retour à la ligne) Ben alors tu ne fais pas du PEP8 ;-) Ta moulinette peux gérer ça ?

Je peux regarder ça; je suis sûr qu’il y a des extensions jupyter pour ça oui Par contre j’apprécierais que tu me pointes vers un exemple précis pour que je puisse avancer

Pour élargir la discussion, concernant un passage à un mode ‘mooc permanent’ et une mise à jour des pdf:

Il me semble qu’on aurait intérêt à rendre idéalement le passage de notebook à latex totalement automatique J’ai regardé d’un peu plus près ta moulinette, dans ce qui est à faire à la main aujourd’hui si je comprends bien

  1. il y a la partie fastidieuse liée au fait au scope (une semaine, plusieurs semaines, …)
  2. et si je comprends bien aussi des bidouilles à faire à la main dans les .tex

Sur la partie 1, je suis sûr qu’on peut faire quelque chose assez vite (par exemple en utilisant un template Sur la partie 2. par contre, l’expérience avec les listes me laisse penser que si on communique mieux, je peux corriger certains - idéalement tous les - soucis à la source (et prendre des habitudes qui vont bien) pour contourner les divers soucis

Sur cette dernière partie, n’hésite pas à me signaler des endroits précis qui posent problème, ça aide !

— Thierry