Skip to content

Proposer des modifications (avancé recommandé)

Purexo edited this page Oct 30, 2017 · 5 revisions

Proposer modifications

Pour cette partie avancé, il faut avoir remplis les prerequis

Forker le dépôt

À l'url suivante : https://github.com/Starbound-Fr/Starbound-Fr.github.io cliquez sur le bouton fork

Importer le dépôt

git clone https://github.com/[VOTRE-USERNAME]/Starbound-Fr.github.io.git Starbound-Fr.github.io
# Allez prendre un café, le dépôt pèse bien lourd (>500Mo).
cd Starbound-Fr.github.io
git checkout -b NomUser_ModificationAVenir

Trucs à savoir

Vu que vous avez remplis les prerequis, vous avez ruby et jekyll d'installé sur votre ordi. Du coup pour tester en local :

  • SHIFT+ClicDroit -> ouvrir une fenetre de commande ici
  • et tapez jekyll serve
  • une fois que c'est build, accédez à l'adresse localhost:4000 et admirez le site en local
    • Quand vous mettrez des fichiers à jours jekyll s'en apercevra et reconstruira le site, attendez un peu pour observer les modifications

Ajouter un article

Créer un nouveau fichier texte dans le dossier _posts au format suivant :

2016-02-17-starbound-fr-le-phenix-passionne.html
année-mois-jour-nom-de-l-article.markdown

Si vous choisissez l'extention .html c'est pour utiliser une syntaxe html
Je vous conseil d'utiliser .markdown ou .md pour utiliser la syntaxe Kramdown (Markdown étendu)

NB :

Si c'est votre premier article, ajoutez vous dans le fichier _data/authors.yml en suivant les attributs des autres auteurs. Ça permettra d'afficher des informations plus détaillé que juste votre nom en marge des articles ;-)

Entête du fichier

---
layout: post
author: Votre Nom D'auteur (de préférence votre username github)
title: Titre de l'article (doit refléter le nom du fichier sans la date du début)
cover: "/wp-content/uploads/2016/02/phoenix.jpg" (chemin de l'image pour l'entête)
cover_alt: cover
categories:
- News
tags:
- news
---

Concernant la cover (image à la une), ce serait vachement bien d'en avoir une. Voir [cette page](Uploader Des Images)

Suite à l'entête, écrivez votre article dans la syntaxe choisie lors du choix de l'extension.

Ajouter une page (pas un article)

Dans le dossier _pages créer un dossier avec un nom simple, puis créez un fichier index.html ou index.markdown

Entête du fichier

---
author: Votre Nom D'auteur (de préférence votre username github)
date: ANNEE-MOIS-JOURS HEURES:MINUTES:SECONDES
layout: page
title: Titre de la page
permalink: /permaliens de l'article/
---

Une fois les éditions effectués

git commit -m "message du commit"
git push

Ensuite allez sur votre fork, cliquez sur le bouton new pull request verifiez que tout est en ordre et envoyez.