Comment contribuer

Le site est basé sur nanoc, il est donc recommandé de l'installer pour valider les modifications effectuées sur le site.

Le contenu du site est hébergé sur le repository GITHUB http://github.com/asyd/sysadmin-fr.

Si vous avez les droits en écriture sur le repository GIT

$ git clone http://github.com/asyd/sysadmin-fr

Si vous avez forké le repository GIT

Pour le fork : https://github.com/asyd/sysadmin-fr/fork_select

$ git clone -b master git@github.com:VOTRE_COMPTE/sysadmin-fr.git
$ cd sysadmin-fr
$ git remote add asyd https://github.com/asyd/sysadmin-fr.git
$ git fetch asyd

Vous pouvez alors vérifier que votre repository est à jour par rapport à celui d'asyd:

$ git diff master asyd/master

Cette commande ne vous donnera un diff que si il y a eu un commit dans l'un ou l'autre des repositories.

Une fois que vous êtes content de votre travail, vous avez:

  • Commité dans votre repo,
  • Pushé ce commit dans votre repo sur github

Il reste à demander à asyd s'il veut bien de votre travail. Il faut pour cela lancer un "pull request" depuis la page de votre repo. Après avoir cliqué sur le bouton "pull request", attention de bien choisir "asyd:migration" comme branch de destination. Par exemple:

"You're asking asyd to pull 4 commits into asyd:migration from votreCompte:migration"

Edition du contenu

Créer votre articles dans le répertoire articles (ou books s'il va contenir plusieurs pages), au format HTML ou markdown. Les images doivent être déposées dans le répertoire images, en créant un sous dossier pour votre article, ou utilisateur. Modifier également la page articles.html pour créer un lien, dans la section adéquate. Pour tester et valider vos modifications, utiliser nanoc :

$ nanoc view