Bienvenue

Sur le repo du cours de programmation mobile avancée 5N6 du collège Edouard Montpetit. Le lien vers le site:

https://info.cegepmontpetit.ca/5N6-mobile-2/

Ce gabarit est simplement le projet de départ du produit Docusaurus développé par l'équipe de Facebook, avec quelques configurations prédéfinies pour le département d'informatique du CÉGEP Édouard Montpetit. Nous vous encourageons fortement à aller jeter un coup d'oeil aux références ci-bas pour en apprendre davantage sur les possibilités qu'offre Docusaurus.

Pour bien commencer

1. Sur Github, faite un fork de ce projet. Le standard de nomenclature au département est sigle-nom-du-cours ex : 4N6-Mobile.
2. Clonez et ouvrez le projet forké dans votre éditeur de code préféré.
3. Dans l'onglet Settings de votre repository, dans la section Pages, dans la sous section Build and deployment, Source, sélectinonez GitHub Actions.
4. Dans l'onglet Actions de votre repository, acceptez le conditions pour le déploiement.
5. Le fichier config.json doit être modifié pour contenir les informations liées à votre cours. nomUrl doit correspondre au nom du repository Github créé.
6. Voir Installation et Développement Local pour voir comment démarrer le serveur (à partir du répertoire web).
7. Modifiez les documents Markdown qui sont dans la répertoire docs selon vos besoins.
8. Profit

Installation (pour les profs)

Commencer par cloner le repo localement.

Prérequis

Vous devez avoir installé les logiciels suivants sur votre poste :

• NodeJS
• NPM (normalement inclus dans l'installation de NodeJS

Instruction

Dans un terminal, déplacez vous dans le répertoire web.

$ cd web

Si ce n'est pas déjà fait, installez les dépendances avec NPM.

Installer les dépendances nécessaire. Depuis le dossier du projet web

$ npm install

Démarrez le serveur local.

Exécuter le projet pour valider les modifications avant de commit. Depuis le dossier du projet web

$ npm start

Cette commande démarre une serveur de développement local sur le port 3000 de votre machine personnelle et ouvre un navigateur avec l'adresse locale du site. Les changements effectués sur la documentation (/docs) sont automatiquement appliqués sur le site à la sauvegarde des fichiers. Les changements faits à la configuration (ex: docusaurus.config.js) nécessitent un redémarrage du projet.

Déploiement (pour les profs)

Tout le code poussé sur la branche main de ce dépôt est automatiquement déployée sur https://info.cegepmontpetit.ca/nom-du-repo-github/ à l'aide de Github Actions.

Avancé

Des composantes supplémentaires ont été développées par Pierre-Olivier Brillant. Vous pouvez vous référer à la section Wiki de ce repository, ou vous adresser directement à lui pour en savoir plus.

Tout le code poussé sur la branche main de ce dépôt est automatiquement déployée sur https://info.cegepmontpetit.ca/5N6-mobile-2/ à l'aide de Github Pages et Github Actions.

Références

• Guide Markdown de base
• Guide Markdown étendu pour Docusaurus