Skip to content

LoicGrobol/web-interfaces

Repository files navigation

Interfaces web pour le TAL

Licence : CC BY 4.0

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

Contact : loic.grobol@parisnanterre.fr

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

CC BY Licence badge

Copyright © 2021 Loïc Grobol <loic.grobol@gmail.com>

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

CC-BY-SA Licence badge