Bladeren bron

updated initial instructions

master
Lapin-Blanc 3 jaren geleden
bovenliggende
commit
f38b4241a9
1 gewijzigde bestanden met toevoegingen van 30 en 7 verwijderingen
  1. +30
    -7
      README.md

+ 30
- 7
README.md Bestand weergeven

@@ -1,10 +1,33 @@
# Introduction

Ce projet a pour objectif de vous guider tout au long de la réalisation d'un jeu simple en Python.

Voici les étapes de travail :

## Pour commencer

- Description de l'environnement de travail : python3.9, pip, virtualenv et vs code
- Principe du projet par changements successifs de commit
- Ètapes initiales :
- Fork et clonage du dépôt du projet
- Ouverture du projet dans VS Code
- Installation de l'environnement et des dépendances
- Passage sur le premier tag pour la première partie
Avant toutes choses, il vous faut vérifier votre environnement de travail. Ce projet a été élaboré les bases suivantes.

- **Python 3.9** : pour tester, ouvrez un terminal et exécutez la commande `python -V` qui devrait vous retourner `Python 3.9.0`. De légères différences de version ne devraient toutefois pas poser de problème.
- **Pip** : nécessaire pour installer les packages additionnels Python. Pour vérifier : `pip -V` devrait vous donner un numéro de version supérieur à 20, et en relation avec votre version de Python. En cas de problème avec l'une ou l'autre de ces deux dernières vérifications, le plus simple est de retirer complètement Python et de le réinstaller selon la méthode vue au cours. (Attention notamment au PATH)
- **Virtualenv** : nécessaire pour travailler dans des environnements Python virtuels de travail. Pour vérifier la présence de ce programme : `virtualenv --version` devrait, comme pip, vous donner un numéro de version supérieur à 20 et en relation avec votre version de Python.
- **Git** : pour la gestion des différentes versions de votre projet, des corrections, etc. La commande `git --version` devrait vous donner une version 2.X.X. Si ce n'est pas le cas, il vous faut alors l'installer. Avec votre gestionnare de paquets (apt, choco, etc.) ou à défaut à partir du [site de l'éditeur ](https://git-scm.com/downloads).
- **VS Code** : attention à ce que tout le reste soit bien présent et à installer le module Python de vscode.

## Déroulement de votre travail

1. Il vous faudra d'abord commencer par *forker* (bifurquer) ce dépôt dans les vôtres.
1. Ensuite seulement, vous allez cloner celui-ci dans un de vos dossiers local de développement.
1. Une fois le dossier *paf-loiseau* rapatrié, vous ouvrirez celui-ci avec vscode.

## Étapes de développement

Le dépôt que vous avez cloné est positionné sur sa branche principale (master) comportant ce fichier, le fichier de licence et le fichier .gitignore.

Le déroulement du projet est organisé selon une introduction et quatres chapitres. À chacune de ces sections correspondent **deux** branches :
- une qui correspond aux explications et à la situation de départ (-start),
- l'autre correspondant à la situation finale attendue (-end).

Voici les étapes de travail pour chaque section :
1. Basculez sur la branche '-start' de la partie sur laquelle vous allez travailler.
En suivant les instructions et explications du chapitre (clic droit sur le fichier .md dans vscode, puis 'open preview') vous allez modifier ce qui doit l'être en validant vos changement au fur et à mesure.

Laden…
Annuleren
Opslaan