Blog du projet P3, LEPL1503

Ce blog comprend des informations utiles aux étudiants qui réalisent le projet du cours LEPL1503 à l'UCLouvain.

Ce blog est écrit en Markdown et est mis en ligne grâce à au logiciel Jekyll de GitHub.

Les étudiants sont encouragés à proposer des articles sur ce blog. Les étudiants dont les articles seront publiés recevront un bonus dans l'évaluation du cours.

Pour proposer un article pour le blog, nous vous invitons à réfléchir aux problèmes pratiques qui vous ont fait perdre du temps dans le cadre du projet et que vous avez résolu avec l'aide d'un des membres du groupe ou d'un tuteur. Décrivez brièvement ce problème en expliquant sa solution sous la forme d'un nouvelle issue.

Pour créer une issue sur GitHub, connectez-vous sur GitHub et choisissez un nom d'utilisateur et un mot de passe.

Lors de votre premier accès à https://github.com/UCL-INGI/LEPL1503-Blog, GitHub vous recommande de lire le tutoriel accessible depuis https://guides.github.com/activities/hello-world/, c'est une excellente idée.

Voici quelques copies d'écrans qui illustrent comment écrire un article sur le blog depuis le site GitHub. C'est aussi possible en ligne de commande bien entendu et ce serait un excellent sujet d'article pour le blog.

La première étape est d'aller dans la zone relative aux "Issues" le projet GitHub du blog.

Ensuite il faut créer une nouvelle "Issue".

Vous pouvez maintenant décrire votre idée d'article dans la nouvelle "Issue".

Votre "Issue" est maintenant prête vous pouvez commencer la discussion pour son amélioration.

La discussion de votre "Issue" est terminée et vous allez rassembler toutes les notes dans la discussion dans un article de blog. Pour cela, la première étape est de créer une copie (un fork) du repo.

Après quelques secondes, vous avez maintenant un repo GitHub contenant une copie de celui du blog. C'est ce repo que vous allez modifier et dans lequel vous allez préparer votre article.

Le repo du blog contient différents répertoires. C'est dans le répertoire _posts que vous trouverez les articles du blog en format Markdown.

Vous pouvez cliquer sur le bouton "Create New File" pour créer un nouveau fichier dans ce répertoire. La convention de nommage est de commencer par la date suivie d'un ou deux mots qui résument le contenu de l'article en terminant par l'extension .md comme le contenu est en Markdown.

Une fois votre fichier complet, vous pouvez écrire le message de commit qui décrit votre modification et créer une branche de façon à pouvoir soumettre un pull-request.

Vos modifications sont prêtes dans votre repo, vous devez maintenant les soumettre au repo original en cliquant sur "new pull request". Vérifiez que votre pull request est bien envoyée vers la branche master du repo UCL-INGI/LEPL1503-Blog

Pensez à ajouter un bref message qui décrit votre article et faites référence au numéro de l'"Issue" que vous résolvez.

GitHub va maintenant transférer votre modification vers le repo officiel sous la forme d'une pull-request qui pourra être facilement intégrée dans le blog afin de publier votre article.