1. Introduction et prérequis
Ce guide s’adresse aux enseignants de l’ENSEIRB-MATMECA souhaitant ajouter leurs propres pages de cours sur cours.pages.bordeaux-inp.fr.
Contexte
L’objectif de cette initiative est de mettre à disposition une plateforme en ligne, visant à améliorer l’expérience d’apprentissage des étudiants. Cette plateforme facilite les mises à jour et permet de proposer des contenus enrichis (vidéos, liens externes, etc.).
Contrairement aux supports traditionnels (PDF, slides, etc.), le contenu est consultable à tout moment depuis n’importe quel appareil et s’adapte aux différents formats d’écran (ordinateur, tablette, smartphone).
Connaissance requises
Certaines connaissances sont nécessaires ajouter ses pages de cours :
- Git : Ces pages sont hébergées sur l’instance Gitlab de Bordeaux INP, il est nécessaire de connaître les bases (
clone,commit,pull,push) de Git pour pouvoir les modifier. - Markdown : Le contenu des pages de cours est écrit en Markdown. Ce langage de formatage de texte est cependant assez simple à apprendre, et des exemples sont fournis.
Logiciels requis
Les logiciels suivants sont à installer : Git, Make, Hugo, Go, Node.js (+ npm), Python 3. Voici comment les installer, selon votre système d’exploitation :
- Dans un terminal :
sudo apt update
sudo apt install -y git make hugo golang-go nodejs npm python3
- Dans un terminal :
sudo dnf update
sudo dnf install -y git make hugo golang nodejs npm python3
- Dans un terminal :
sudo pacman -Syu
sudo pacman -S git make hugo go nodejs npm python --noconfirm
- Vérifiez si Homebrew est déjà installé. Dans un terminal :
brew --version
- Si une version s’affiche, il est déjà installé. Sinon, installez Homebrew avec la commande suivante :
curl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash
- Dans un terminal :
brew update
brew install git make hugo go node npm python
- Vérifiez si winget est déjà installé. Dans un terminal PowerShell :
winget --version
- Si une version s’affiche, il est déjà installé. Sinon, installez ou mettez à jour App Installer depuis le Microsoft Store.
- Dans un terminal PowerShell (en mode administrateur) :
winget install --id Git.Git -e --source winget
winget install --id GnuWin32.Make -e --source winget
winget install --id Hugo.Hugo.Extended -e --source winget
winget install --id GoLang.Go -e --source winget
winget install --id OpenJS.NodeJS.LTS -e --source winget
winget install --id Python.Python.3 -e --source winget