# MANUEL D'UTILISATION

## Méthode 1 : PORTFOLIO.exe

Dans le dossier "Pyinstaller" se trouve un exécutable "PORTFOLIO.exe", utilisable pour tout Windows 11. La variante "Linux_PORTFOLIO" a de nombreuses mises à jour de retard. Le plus simple reste d'ouvrir l'exécutable si vous êtes sous Windows 11 et le projet devrait se lancer de lui-même. 

## Méthode 2 : Code source

Si vous n'avez pas confiance en les exécutables ou souhaitez disséquer mon projet, le code source est à votre disposition. Voici la démarche pour s'en servir :

### Portfolio, Python et VSCode

Ce portfolio est un projet écrit majoritairement en langage Python (extension de fichier .py).

Pour ouvrir ce type de fichier, il vous faudra un IDE (Environneement de Développement Intégré) tel que Visual Studio Code (abrégé VSCode).

C'est par ailleurs celui que je recommande, car c'est dessus qu'a été développé l'entièreté de ce Portfolio, et donc le seul dont je sois assuré du bon fonctionnement. Pour avoir essayé avec Edupython, par exemple, le programme ne plante pas mais le scrolling ne fonctionne pas, empêchant de visionner une partie du contenu.

Pour installer VSCode : https://code.visualstudio.com/Download

Sur VSCode, donc, allez dans "File > Open Folder" (en français, "Fichier > Ouvrir Dossier") puis cherchez sur votre machine le dossier contenant ce fichier et PORTFOLIO.py, et ouvrez-le. Vous devriez voir apparaître une barre à gauche avec l'ensemble des fichiers et sous-dossiers contenus dans le dossier que vous venez d'ouvrir.

Il faudrait aussi installer un compilateur Python pour VSCode, car ce dernier n'en n'a pas par défaut. Je recommande le "Python 3.13" téléchargeable gratuitement dans le Microsoft Store. 
Lorsque vous exécuterez pour la première fois un programme Python dans VSCode, il vous demandera de sélectionner un compilateur dans la barre du haut ; vous pourrez alors choisir celui installé.

### PORTFOLIO.py & Pygame

Le fichier a exécuter est PORTFOLIO.py, comme le suggère son nom. Cliquez dessus. Cela doit ouvrir un onglet dans VSCode (le contenu du fichier) où se trouvent environ 120 lignes. Pas besoin de les comprendre ou même de les lire.

Le programme est construit autour de la bibliothèque Pygame, utilisée pour le développement de jeux en Python. Par défaut, elle n'est pas installée sur VSCode, vous verrez d'ailleurs peut-être que la ligne 8 "import pygame" est soulignée en jaune, car VSCode ne reconnaît pas cette bibliothèque.

Je vous demanderai donc de bien vouloir l'installer. Pour cela, ouvrez un terminal en allant sur "... > Terminal > New Terminal" (ou juste "Terminal > New Terminal" si votre écran est assez grand pour qu'il soit affiché directement en haut à gauche), cliquez dans le terminal qui a dû s'ouvrir en bas de VSCode et marquez dedans "pip install pygame". Validez avec la touche Entrée.

Si le téléchargement marche, vous pouvez passer à l'étape suivante, peu importe que la ligne soit encore soulignée ou non (enfin je crois).

### Compiler & Exécuter

En étant dans l'onglet de PORTFOLIO.py, vous pouvez à présent lancer (excéuter) le programme en appuyant sur le triangle poitant vers la droite en haut à droite de l'écran. 

À ce niveau, il est probable qu'un écran noir apparaîsse suivi au bout de quelques secondes d'un message d'erreur vous proposant de fermer le programme car il ne répond pas. Fermez-le. 

Ce comportement est normal : comme vous exécutez le programme pour la première fois, le compilateur de Python n'a encore rien écrit dans son cache pour lui permettre de le relancer plus rapidement les fois suivantes.

Essayez donc de l'exécuter à nouveau. Ce "phénomène" peut se reproduire une deuxième fois, voire trois (au-delà il y a un problème), avant que la fenêtre ne se colorie enfin et que le jeu commence.

Une fois que la compilation aura marché une première fois, le programme ne devrait prendre plus que 3 secondes à s'exécuter les fois suivantes.

## Précisions

Cette version du Portfolio est encore en passe de développement : des éléments non-maîtrisés ont été retiré (il y avait des effets sonores à un moment, vous savez) et de nombreuses idées sont encore à ajouter. Le Portfolio continuera d'évoluer, n'ayant pas pour vocation d'être fixe et certainement pas terminé.

Le programme s'adaptera théoriquement a toute résolution d'écran, peut-être un peu mal pour les images.

Si vous voulez télécharger mon CV, ma lettre de motivation, ou d'autres documents présentés dans ce Portfolio, vous pourrez trouver tous les PDF dans le dossier "Pdf téléchargables". 
Si vous souhaitez vous rendre sur la page web présentant mon unique expérience professionnelle sans passer par le programme, rendez-vous dans "Docs > Pro" et ouvrez "Stage.html" dans un navigateur web.

En cas de problème, de questions ou simplement pour envoyer des commentaires, vous pouvez me joindre par mail à thibaud.laurens@gmail.com ou thibaud.laurens@etu.univ-nantes.fr, par téléphone (mais évitez, on met ça dans le CV pour le pro) au 0772249515, ou sur Discord avec le pseudo kirbeus_snerual.

Sur ce, bonne journée à vous !
