|
| 1 | +# Guide à destination des contributeurs d'Element UI |
| 2 | + |
| 3 | +Bonjour! Merci d'avoir choisi Element UI. |
| 4 | + |
| 5 | +Element UI est une bibliothèque de composants basée sur Vue 2.0 pour les développeurs, les designers et les chefs de produits. |
| 6 | + |
| 7 | +Nous sommes ravis que vous souhaitiez contribuer à Element. Avant de soumettre votre contribution, veuillez vous assurer de prendre un moment pour lire les indications suivantes. |
| 8 | + |
| 9 | +## Concernant les issues |
| 10 | + |
| 11 | +- Les issues concernent exclusivement les bugs, les demandes de fonctionnalités et les sujets liés à la conception. Les questions concernant d'autres sujets peuvent être fermées directement. Si vous avez des questions à propos de l'utilisation d'Element, veuillez vous rendre sur [Gitter](https://gitter.im/element-en/Lobby) pour obtenir de l'aide. |
| 12 | + |
| 13 | +- Avant de soumettre une issue, veuillez vérifier si des problèmes similaires n'ont pas déjà été signalés. |
| 14 | + |
| 15 | +- Veuillez spécifier la version de `Element` et `Vue` que vous utilisez, et fournir des informations sur le système d'exploitation et le navigateur. [JSFiddle](https://jsfiddle.net/) est recommandé afin de construire une démo pour que votre problème puisse être reproduit clairement. |
| 16 | + |
| 17 | +## Concernant les pull requests |
| 18 | + |
| 19 | +- Faites un fork de ce dépôt vers votre compte. Ne créez pas de branches ici. |
| 20 | + |
| 21 | +- Les informations de validation doivent être formatées en tant que `[Nom du composant] : Info à propos de ce commit` (par exemple `Button : Fix xxx bug`) |
| 22 | + |
| 23 | +- **NE PAS** inclure de fichiers dans le répertoire `lib`. |
| 24 | + |
| 25 | +- Assurez-vous que l'exécution de `npm run dist` génère les bons fichiers. |
| 26 | + |
| 27 | +- Pour des raisons de compatibilité et de taille de fichier, notre configuration babel n'importait que `preset-2015`, donc les API comme `Array.prototype.find` et `Object.assign` dans `ES2015` ne sont pas recommandées. Vous pouvez importer des polyfills si nécessaire. |
| 28 | + |
| 29 | +- Faites un rebase avant la création d'une PR pour garder l'historique clair. |
| 30 | + |
| 31 | +- Assurez-vous que les PRs sont créés dans la branche `dev` au lieu de la branche `master`. |
| 32 | + |
| 33 | +- Si votre PR corrige un bug, veuillez fournir une description du bug en question. |
| 34 | + |
| 35 | +- La fusion d'un PR nécessite deux responsables: l'un approuve les modifications après révision, puis l'autre les révise et les fusionne. |
| 36 | + |
| 37 | +## Pré-requis |
| 38 | +`Node.js 4+`, `yarn` et `npm 3+` sont requis. Note: nous utilisons yarn pour verrouiller les versions des dépendances, donc vous devriez installer les dépendances en utilisant `yarn` au lieu de `npm install`. |
| 39 | +```shell |
| 40 | +git clone [email protected]:ElemeFE/element.git |
| 41 | +npm run dev |
| 42 | + |
| 43 | +# open http://localhost:8085 |
| 44 | +``` |
| 45 | + |
| 46 | +> **Remarque** : modifiez le fichier `examples/play/index.vue`, utilisez le composant auquel vous contribuez, puis lancez `npm run dev:play`, allez sur [http://localhost:8085](http://localhost:8085), regardez le résultat rapidement et facilement. |
| 47 | +
|
| 48 | +Pour le build: |
| 49 | + |
| 50 | +```shell |
| 51 | +npm run dist |
| 52 | +``` |
| 53 | + |
| 54 | +## Concernant le développement de composants |
| 55 | +- Exécutez `make new <nom-du-composant>` pour créer un répertoire pour le nouveau composant. Les tests, le fichier d'entrée et la documentation sont inclus. |
| 56 | +- Reportez-vous au `Button` pour les composants imbriqués. |
| 57 | +- Reportez-vous à `Select` pour connaître les composants qui dépendent d'autres composants. |
| 58 | + |
| 59 | +## Style du code |
| 60 | +Il suffit de se conformer à la configuration [ESLint](https://github.com/ElemeFE/eslint-config-elemefe) de [ElemeFE](https://github.com/elemefe). |
0 commit comments