Configuration de l'environnement de développement
Prérequis
Pour installer et configurer votre environnement de développement local, voici quelques prérequis :
- git
- gcc/clang/llvm (Linux : outils de construction, Mac OS X : XCode avec outils de ligne de commande)
- ruby w/ bundler
Mac OS X : Vous devez d'abord installer XCode, disponible sur l'App Store, sur votre Mac. Après l'avoir téléchargé et exécuté, exécutez ceci en ligne de commande :
| xcode-select --install |
Clonage des projets
Tout d'abord, clonez le projet, puis ajoutez une ligne à votre fichier ~/.bash_profile pour indiquer aux autres programmes où se trouvent les fichiers de développement LibSass :
|
git clone git@github.com:sass/libsass.git cd libsass echo "export SASS_LIBSASS_PATH=$(pwd)" >> ~/.bash_profile |
Ensuite, si vous exécutez le script «bootstrap», il devrait cloner tous les autres projets requis :
| ./script/bootstrap |
Vous devriez maintenant avoir un dossier sass-spec et un dossier sassc dans le dossier libsass. Ces deux dossiers sont des clones de leurs projets Git respectifs. Si vous souhaitez effectuer une pull request, pensez à travailler dans ces dossiers. Par exemple, si vous souhaitez ajouter un test (consultez la documentation pour savoir comment procéder), assurez-vous de le commiter dans votre fork du projet GitHub sass-spec. De plus, chaque fois que vous exécutez des tests, assurez-vous de les récupérer depuis l'origine ! Nous voulons nous assurer que les tests sont effectués sur les dernières versions de libsass, sassc et sass-spec !
Maintenant, essayez de compiler le projet. Pour cela, utilisez la commande make :
| make |
À ce stade, si vous obtenez une erreur, il y a probablement un problème avec l'installation de votre compilateur. Mais avant cela, n'oubliez pas de rechercher le message d'erreur sur Google ! De nombreux problèmes sont résolus rapidement de cette façon.
Exécution de la spécification avec LibSass
Ensuite, pour exécuter la spécification avec LibSass, exécutez :
| ./script/spec |
Si vous obtenez une erreur concernant SASS_LIBSASS_PATH, vous devrez peut-être toujours définir une variable pointant vers le dossier libsass, comme ceci :
| export SASS_LIBSASS_PATH=/Users/you/path/libsass |
...où la dernière partie renvoie au répertoire libsass que vous avez cloné. Vous pouvez obtenir ce chemin en saisissant pwd dans le terminal.
Exécution de la spécification avec Ruby Sass
Accédez au dossier sass-spec ayant dû être cloné précédemment avec la commande «bootstrap». Exécutez la commande suivante :
| bundle install ./sass-spec.rb |
Vous testez maintenant avec Sass !
Profilage
Librsass est-elle lente ? Consultez le guide de Profilage de LibSass.