Home

Objectifs

L'objectif de C2iS-OneTea est de mettre en place un kick-off, un kick starter, un boilerplate, un bootstrap, etc., enfin peu importe le nom, l'objectif est d'avoir une structure simple, rapide à déployer.

Une page html (php, avec ses includes pour le header et le footer), des dossiers less & css (avec quelques fichiers less de base), un dossier js (avec un fichier d'éxé) et un dossier image.

## Pré-requis (environnement de travail) Pour démarrer un projet :
`node.js/npm` doit être installé : [nodejs.org](http://nodejs.org/)

(0a) Si GruntJS a déjà été installé, il faut le supprimer :

npm uninstall -g grunt

(0b) Si vous utilisez oneTea pour la première fois, il faut installer grunt-cli et bower en global

npm install -g grunt-cli
npm install -g bower

(0c) vérifier que vous avez la dernière version de nodejs et npm

dans la console : npm version

sudo npm cache clean -f
sudo npm install -g n
sudo n stable

sources : http://davidwalsh.name/upgrade-nodejs
ou télécharger l'installer nodejs/nmp ici : http://nodejs.org/download/

(1) Installer oneTea dans un dossier projet existant (ex: /toto/) :

git clone git://github.com/c2is/c2is-onetea.git . (clone de oneTea)
rm -rf .git (suppression du dossier .git oneTea)

(2) Pour initialiser un projet :

• Préparation des outils :

• lister les plugins Grunt (uglify, less, ...) dans package.json et dans Gruntfile.js

• modifier le fichier .bowerrc avec votre destination (ex: /vendors, ...) { "directory" : "/vendors" }

• lister les composants/vendors (jQuery, Modernizr, ...) dans bower.json

• Installation des outils :

• npm install (installe les plugins grunt définis dans package.json)
  

• bower install (installe les composants bower définis dans bower.json) /!\ à faire uniquement par la personne qui initie le projet
  

• grunt (lance les premières tâches nécessaires)
  

• grunt watch (grunt *** permet de lancer une tâche, comme le watch : ici /js et /less)

## Liste de composants Vous trouverez une liste des composants que nous utilisons souvent : [Voir la liste des composants 'utiles'](https://github.com/c2is/c2is-onetea/wiki/Liste-des-composants)
Vous trouverez une liste de plugins pour GruntJS que vous pouvez ajouter à vos projets pour automatiser certaines tâches : [Voir la liste](https://github.com/c2is/c2is-onetea/wiki/Liste-de-plugins-pour-GruntJS)

N'hésitez pas à la mettre à jour régulièrement.

Contact

LGU