đïž Autres recettes
Banque de recettes additionnelles fournies à titre de référence.
Veuillez noter qu'elles ne seront pas exploitées dans le cursus du cours 420-SN1.
- đ Notebook Jupyter
- đ„ CrĂ©er un rĂ©pertoire GitHub
- đ» Installer GitHub Desktop
- đ Git avec GitHub Desktop
Les notebooks Jupyter sont parfaits pour combiner texte, code et rĂ©sultats dans un seul fichier interactif. Ils contiennent Ă la fois, de façon intermĂȘlĂ©e :
- des blocs de texte (en format markdown ou html)
- des blocs de code Python qui peuvent ĂȘtre exĂ©cutĂ©s
- des rĂ©sultats dâexĂ©cution
- des graphiques
- des images
Ils sont largement utilisĂ©s en sciences pour la recherche, lâexploration de donnĂ©es et lâenseignement.
CrĂ©er un notebookâ
Pour créer un nouveau notebook :
- Créer un projet PyCharm (ou en ouvrir un existant).
- Dans lâarborescence des fichiers du projet Ă gauche, cliquer-droit sur le dossier oĂč on veut crĂ©er le notebook.
- Choisir New > Jupyter Notebook.
- Donner un nom au notebook (par exemple
mon_premier_notebook) et appuyer sur â. - Un fichier avec l'extension
.ipynbest créé dans lâarborescence des fichiers (par exemplemon_premier_notebook.ipynb) et sâouvre dans un nouvel onglet. - Le notebook contient une premiĂšre cellule vide. Pour en ajouter dâautres, il suffira de cliquer sur le bouton ïŒ dans la barre dâoutils en haut.
Ăcrire du texteâ
- Cliquer sur une cellule existante, ou en ajouter une nouvelle avec le bouton ïŒ.
- Dans la barre dâoutils du notebook, changer le type de cellule de Code Ă Markdown.
- Taper le texte en utilisant la syntaxe Markdown (voir exemple ci-dessous).
- Appuyer sur
Shiftâ pour afficher le rendu formatĂ©.
Exemple de Markdown :â
# Titre principal
Voici du texte en **gras**, *italique* et un [lien](https://jupyter.org).
- Une liste
- Ă puces
1. Une liste
2. numérotée
Voici un bloc de code non exécutable :
```python
def salut():
print("Bonjour!")
```
RĂ©sultat affichĂ© :â
Titre principal
Voici du texte en gras, italique et un lien.
- Une liste
- Ă puces
- Une liste
- numérotée
Voici un bloc de code non exécutable :
def salut():
print("Bonjour!")
Ăcrire du codeâ
- Cliquer sur une cellule existante, ou en ajouter une nouvelle.
- Laisser le type de cellule sur Code.
- Taper du code Python comme dans un fichier
.py. - Appuyer sur
Shiftâ pour exĂ©cuter la cellule. - Observer le rĂ©sultat qui sâaffiche directement sous la cellule.
Exemple :â
x = 2 + 2
print(f'Le résultat est {x}')
RĂ©sultat affichĂ© :â
Le résultat est 4
ExĂ©cuter du codeâ
- Cliquer dans la cellule contenant du code Python.
- Appuyer sur
Shiftâ (ou cliquer sur le bouton â¶ dans la barre dâoutils). - Pour exĂ©cuter toutes les cellules du notebook dâun coup, cliquer sur le bouton â¶â¶ dans la barre dâoutils.
Exemple :â
# Définir une fonction
def bonjour(nom):
print(f'Bonjour, {nom}!')
# Appeler la fonction
bonjour('Marie')
RĂ©sultat affichĂ© :â
Bonjour, Marie!
Astucesâ
- Tu peux dĂ©placer une cellule vers le haut ou le bas Ă lâaide des flĂšches â â dans la barre dâoutils.
- Pour insĂ©rer une cellule au-dessus ou au-dessous, utiliser les boutons ïŒ ou Insert Cell Below/Above.
- Les fichiers
.ipynbpeuvent ĂȘtre ouverts dans dâautres outils comme JupyterLab ou VS Code. - Les cellules Markdown peuvent contenir des titres, des listes, des images, des liens, et mĂȘme des Ă©quations mathĂ©matiques en format TeX :
Ăcrire des Ă©quations mathĂ©matiques (TeX)â
- Cliquer sur une cellule existante ou en créer une nouvelle.
- Changer son type en Markdown.
- InsĂ©rer lâĂ©quation LaTeX entre
$$ ... $$pour une formule centrée, ou entre$ ... $pour une formule en ligne. - Appuyer sur
Shiftâ pour afficher le rendu.
Exemple (formule centrĂ©e) :â
La formule quadratique est :
$$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$
Exemple (formule en ligne) :â
La solution est donnée par $x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$.
RĂ©sultat affichĂ© :â
La formule quadratique est :
La solution est donnée par .
- Allez sur github.com
- Connectez-vous Ă votre compte
- Cliquez sur l'onglet
Repositories - Cliquez sur le bouton
Newen haut à droite - Donner un nom à votre nouveau répertoire, par exemple
Cours_420-SN1 - Dans
Configuration>Choose visibility, sélectionnezPrivatepour que vos fichiers ne soient pas publics (accessibles par tout le monde) - Cliquez sur
Create repository
GitHub Desktop est déjà installé sur les ordinateurs du cégep.
Cette procédure est seulement pour installer GitHub Desktop sur votre ordinateur personnel.
GitHub Desktop est l'outil servant à synchroniser le contenu de vos répertoires GitHub sur votre ordinateur avec la version dans le nuage.
Pour installer GitHub Desktop sur votre ordinateur personnel, suivez les étapes suivantes :
- Aller sur le site de GitHub Desktop.
- Cliquer sur "Download for Windows (64 bit)".
- Double-cliquer sur le fichier "GitHubDesktopSetup-x64.exe" dans vos téléchargements.
- Suivre les instructions d'installation (l'installation devrait se faire automatiquement).
- Se connecter Ă l'aide de votre compte GitHub.
Voici la procédure à suivre lorsque vous vous connectez à un poste au cégep, en utilisant GitHub Desktop :
Si votre enseignant n'utilise pas GitHub Desktop pour la gestion du dépÎt de code, veuillez plutÎt consulter cette recette.
1ïžâŁ Cloner un rĂ©pertoire GitHubâ
- Ouvrez GitHub Desktop
- Allez dans le menu
File>Clone repository... - Cliquez sur
Sign inet connectez-vous avec votre compte GitHub - Une fois connecté, sous l'onglet
GitHub.com, vous verrez la liste de vos répertoire- Sélectionnez le répertoire que vous voulez cloner (par exemple,
Cours_420-SN1) - Cliquez sur
Choose...pour choisir l'emplacement local oĂč cloner le rĂ©pertoire- đ Naviguez et choisissez le
Bureau
- đ Naviguez et choisissez le
- Cliquez sur
Clone
- Sélectionnez le répertoire que vous voulez cloner (par exemple,
- Votre répertoire est maintenant cloné (copié) localement sur le bureau de votre poste de travail
- Gardez GitHub Desktop ouvert pour la suite des opérations.
2ïžâŁ Ouvrir un projet dans PyCharmâ
- Ouvrez PyCharm
- Cliquez sur le bouton
Open(ou allez dans le menuFile>Open...) - Naviguez jusqu'au dossier de votre répertoire cloné (normalement sur le
Bureau) - Dans votre répertoire, sélectionnez le dossier du projet que vous voulez ouvrir (par exemple,
Exemples_exercices)- đ Ne sĂ©lectionnez pas le repo entier, mais le dossier spĂ©cifique du projet Ă l'intĂ©rieur du repo
- Si vous n'avez pas encore créé de projet dans le répertoire, vous pouvez créer un nouveau dossier pour votre nouveau projet (cliquez sur
Nouveau dossieren haut Ă gauche)
- Une fois le dossier du projet sélectionné (en bleu), cliquez sur
Select Folder- Cliquez sur
Trust Projectsi PyCharm vous le demande - đ PyCharm va ouvrir le projet et indexer les fichiers (cela peut prendre quelques instants)
- Cliquez sur
- Vous pouvez maintenant éditer et exécuter les fichiers Python de votre projet dans PyCharm.
3ïžâŁ Faire des commit-pushâ
MĂȘme si PyCharm sauvegarde localement les modifications que vous faites dans vos fichiers, elles ne sont pas sauvegardĂ©es dans votre compte GitHub. Si une panne d'Ă©lectricitĂ© survenait, vous perdriez toutes vos modifications non poussĂ©es sur GitHub. Il est donc important de faire des commit-push rĂ©guliĂšrement, par exemple aprĂšs chaque exercice complĂ©tĂ© :
- Allez sur GitHub Desktop.
- Vous verrez les fichiers modifiés dans l'onglet
Changes- Si vous cliquez sur un fichier, vous verrez les modifications apportées à ce fichier
- Dans le champ
Summary, ajoutez un message de commit décrivant vos modifications (par exemple,Exercice 1 complété) - Pour envoyer vos modifications sur GitHub, cliquez sur les boutons bleus :
Commit to mainPush origin
- đ N'oubliez pas de faire
PushaprÚs chaqueCommit. Tant que vous ne faites pasPush, vos modifications ne sont pas sauvegardées sur GitHub.
đ§âđ» Ordinateur personnelâ
Si vous travaillez sur votre ordinateur personnel :
- Assurez-vous d'avoir installé GitHub Desktop et PyCharm
- Clonez votre rĂ©pertoire GitHub sur votre ordinateur personnel en suivant la mĂȘme procĂ©dure que ci-dessus
- đ Mais vous n'avez pas besoin de le cloner Ă chaque fois, seulement la premiĂšre fois
- Ouvrez le projet dans PyCharm comme décrit ci-dessus
- N'oubliez pas de faire des commit-push réguliÚrement pour sauvegarder vos modifications sur Git
Si vous travaillez sur plusieurs ordinateurs (par exemple, votre ordinateur personnel et un poste au cégep), vous devez toujours synchroniser vos modifications entre les deux ordinateurs pour éviter des conflits.
Chaque fois que vous revenez travailler sur votre ordinateur personnel, vous devez récupérer les modifications que vous avez faites sur un autre ordinateur (par exemple, au cégep) avant de continuer à travailler sur vos fichiers.
Pour cela, dans GitHub Desktop, cliquez sur les boutons bleus :
Fetch originPull origin
C'est l'équivalent de Commit-Push mais dans l'autre sens : vous récupérez les modifications que vous avez faites sur un autre ordinateur.
- đ Si vous ne faites pas cela avant de continuer Ă travailler sur vos fichiers sur votre ordinateur personnel, vous risquez d'avoir des conflits lorsque vous essayerez de faire un
Commit-Push.