practices

Pratiques d'équipe Web et de conception

Une collection de documents décrivant les meilleures pratiques pour l'équipe Web canonique.

Ceux-ci peuvent également être consultés sur https://canonical-webtam.github.io/practices/.

Exécutez le site localement

Ce site est construit à l'aide de Jekyll.

Pour exécuter ce site localement, vous devrez d'abord installer Ruby sur votre machine locale.

Une fois que vous avez installé Ruby, vous pouvez ensuite installer Bundler en fonctionnant;

 gem install bundler -v 1.17.3

L'étape suivante consiste à installer les gemmes Ruby nécessaires pour exécuter le site avec Bundler;

 bundle install

Vous pouvez ensuite servir le site à l'aide de Jekyll;

 jekyll serve

... qui devrait ouvrir le site localement dans votre navigateur à http://127.0.0.1:4000/practices/

Contributif

Pour les lignes directrices sur la contribution de ces documents, voir Contribution.md.

Formatage de code

Cette base de code utilise plus jolie pour assurer un formatage cohérent.

Pour fonctionner plus jolie sur la base de code (en supposant que vous avez installé le fil), exécutez:

 yarn prettier-write **/*

Dépannage

Jekyll n'est pas trouvé

Si vous rencontrez un problème lorsque vous essayez d'exécuter un joyau installé, cela indique qu'il ne peut pas être trouvé, assurez-vous que le répertoire dans lequel les gemmes sont installés sont inclus dans votre chemin. Vous pouvez le vérifier en tapant echo $PATH dans un terminal et en vérifiant le dossier dans la sortie. Si vous n'êtes pas sûr de quel dossier vos gemmes sont installés, exécutez gem env | grep EXECUTABLE DIRECTORY et ajoutez le chemin imprimé dans votre variable d'environnement de chemin.

Licence

Le contenu de ce projet est licencié en vertu de la licence internationale Creative Commons Attribution-Sharealike 4.0, et le code sous-jacent utilisé pour formater et afficher que le contenu est sous licence dans le LGPLV3 par Canonical Ltd.