README.md

Interfaces web pour le TAL

Contenus pour le cours « Bases de données et web dynamique » du master Plurital.

• Site du cours
• Dépôt GitHub

Contact : [email protected]

Développement

Pour travailler au développement de ce cours :

1. Créer un environnement virtuel et l'activer

2. Installer les dépendances

   pip install -U -r requirements.txt

3. Démarrer jupyter

   jupyter notebook

   Idéalement ça devrait aussi marcher avec jupyterlab mais ce n'est pas encore le cas pour les slides

4. On peut alors modifier les fichiers md dans jupyter comme si c'étaient des notebooks grâce à la magie de jupytext

Autres éléments magiques :

• On peut ouvrir les notebooks en md sur Binder grâce au postBuild qui dit de compiler l'extension jupytext. Par contre le build initial de l'image est assez lent. (même avec --minimize=False qui accélère un peu)

Générer le site en local

Dependencies:

• Ruby
  • Bundle

Setup:

gem install jekyll bundler
bundle config set --local path 'vendor/bundle'
bundle install

Regenerate:

bundle exec jekyll build
bundle exec jekyll serve

Astuce pour les pages : Jekyll n'est pas très bon pour les pages qui ne sont pas des postes de blog, les ajouter dans _pages (ce qui fonctionne parce qu'on l'a mis dans _config.yml)- et leur donner un permalink dans le header.

Binder

(En cours)

Pour accélérer le lancement des notebooks dans Binder, on utilise un repo d'environnement différent (l'idée est que comme ce repo change rarement, il y a rarement besoin de reconstruire l'image pour Binder). Il faut penser à le mettre à jour quand on change les dépendances ici.

Pour travailler au développement de ce cours :

1. Créer un environnement virtuel et l'activer

2. Installer les dépendances

   pip install -U -r requirements.txt

3. Démarrer jupyter

   jupyter notebook

   Idéalement ça devrait aussi marcher avec jupyterlab mais ce n'est pas encore le cas pour les slides

4. On peut alors modifier les fichiers md dans jupyter comme si c'étaient des notebooks grâce à la magie de jupytext

Autres éléments magiques :

• On peut ouvrir les notebooks en md sur Binder grâce au postBuild qui dit de compiler l'extension jupytext. Par contre le build initial de l'image est assez lent. (même avec --minimize=False qui accélère un peu)

Licences

Copyright © 2021 Loïc Grobol <[email protected]>

Sauf indication contraire, les fichiers présents dans ce dépôt sont distribués selon les termes de la licence Creative Commons Attribution 4.0 International.

Un résumé simplifié de cette licence est disponible à https://creativecommons.org/licenses/by/4.0/.

Le texte intégral de cette licence est disponible à https://creativecommons.org/licenses/by/4.0/legalcode

Exceptions à la licence

Les fichiers suivants ne sont pas distribués selon les termes de la licence Creative Commons Attribution 4.0 International

CC-BY-SA

• Les images internet-schema-*.png et simple-client-server.png du dossier slides/lecture-06/pics sont issues de la documentation web du MDN sont soumises à la licence CC-BY-SA 2.5.