Ceci est le code source de notre portail Mozilla francophone https://mozfr.org/.
Le site utilise le générateur statique Cecil https://cecil.app/. Les templates utilisent Twig.
Vous devez d'abord forker le dépôt:
git clone https://github.com/votreforkdudépot/www/
cd www
Note: Cecil requière l'extension PHP ext-gd.
Installez Cecil avec Composer le gestionnaire de dépendances de PHP:
composer install
Une fois les dépendances installées, vous pouvez lancer le serveur de développement local avec cette commande dans votre terminal:
composer serve:dev
Le site sera à l'adresse http://localhost:8000. Lorsqu'un changement est effectué dans un fichier source, Cecil regénérera le dossier de sortie et rafraîchira le navigateur sautomatiquement.
Vous pouvez aussi exécuter toutes les autres commandes de Cecil avec:
composer cecil [nom de la commande]
Tous les fichiers source (HTML, JS, CSS, images, polices…) sont dans le
dossier source. Le dossier de sortie se trouve dans source/_site.
Pour les utiliser, vous devez tout d'abord installer NodeJS.
Lorsque NodeJS est installé, vous pouvez installer les outils avec:
cd /chemin/vers/mozfr/www
npm install
Pour lancer les tests de détection des bugs, vous pouvez exécuter:
npm run lint
Pour formatter le code, vous pouvez exécuter:
npm run prettier
- Créez une branche pour votre patch (une "feature branch" en terminologie git), on ne prendra pas de patch venant de votre branche master.
- Ouvrez un ticket s'il n'y en a pas déjà un
- Rebasez votre branche avant de faire une PR, après acceptation du patch (revue), si vous aviez fait plusieurs commits, fusionnez-les (squash). Voici un article en anglais qui explique ça : https://blog.carbonfive.com/2017/08/28/always-squash-and-rebase-your-git-commits/
This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.