Skip to content
Ricozor edited this page Nov 9, 2015 · 35 revisions

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