Code source du site Putain de code !. Contient tout le nécessaire pour faire fonctionner le site. Pas de base de données à installer, pas de serveurs à configurer.
$ git clone https://github.com/putaindecode/putaindecode.fr.git
$ cd putaindecode.fr
$ npm run init
$ npm install
$ npm start
Les articles peuvent être postés ici sous forme de PR une fois qu'on est OK dans une issue du repo. Si vous souhaitez voir un post écrit, ou même en écrire un, faites un tour là bas ;)
Pour contribuer au site, n'hésitez pas, en plus de lire la partie technique ci-dessous, à lire le fichier spécifique CONTRIBUTING.md
Notice: Faites attention à la configuration de vos éditeurs de texte et IDE.
Nous utilisons .editorconfig
pour garder une cohérence.
Respectez cela (il vous suffit d'aller sur le site editorconfig.org/
pour télécharger le plugin adéquat pour votre éditeur.
Ce site utilise gulp, il vous est donc conseillé de jeter un coup d'oeil au README de gulp avant d'intervenir sur le projet ;).
$ git clone https://github.com/putaindecode/putaindecode.fr.git
$ cd website
$ npm run init
$ npm install
Lorsque vous n'avez pas travaillé sur le site depuis un petit moment, on vous conseille d'exécuter les commandes suivantes :
$ git pull
$ npm install
Si vous rencontrez des erreurs lors du git pull
(par ex. pour une histoire de
fichiers modifiés non commités), vous pouvez juste avant faire
un petit
$ git reset --hard
Note: cela supprimera toutes vos modifications locales sans avertissement, à
faire avec précaution.
Préférez git stash
si vous souhaitez conserver vos modifications.
$ npm start
Oui oui, c'est tout, vous devriez avoir le site web qui s'ouvre tout seul dans votre navigateur. Si ce n'est pas le cas, et que vous n'avez pas d'erreurs dans votre console, rendez-vous à l'adresse suivante: http://localhost:4242.
La commande suivante (lorsque vous avez les droits nécessaires) va construire le site
en version optimisée, et le publier (mise à jour de la branche gh-pages
, qui,
grâce à GitHub, suffit à mettre en ligne le site).
$ npm run deploy
Cela dit, tous les commits dans la branche master
provoqueront une mise en production automatique via Travis-CI.
Note: pour commiter sans provoquer un deploy
, il suffit d'ajouter [ci skip]
dans votre message de commit.
Installez icoutils. Par exemple sur OS X :
$ brew install icoutils
ou
$ npm run init-osx
Ensuite utilisez la commande suivante
$ npm run favicon
Remerciements à toutes les personnes impliquées dans cette discussion putaindecode/organisation/issues/4. Remerciement spécial à @bloodyowl pour le logo initial.