From 4ebbbdbcce96a50490139afd500af1749cc1e334 Mon Sep 17 00:00:00 2001 From: Simon Malesys Date: Wed, 20 Feb 2019 03:36:38 +0100 Subject: [PATCH] Docs: Update french documentation, contributing guide and github templates (#14418) * Docs: update french translation (fr-FR) * Contributing: add CONTRIBUTING.fr-FR.md * GitHub templates: update PULL_REQUEST_TEMPLATE.md with french contributing guide --- .github/CONTRIBUTING.fr-FR.md | 60 +++++++++ .github/PULL_REQUEST_TEMPLATE.md | 2 +- examples/docs/fr-FR/custom-theme.md | 15 ++- examples/docs/fr-FR/i18n.md | 1 + examples/docs/fr-FR/icon.md | 7 +- examples/docs/fr-FR/input.md | 1 + examples/docs/fr-FR/select.md | 5 +- examples/docs/fr-FR/table.md | 6 +- examples/docs/fr-FR/timeline.md | 202 ++++++++++++++++++++++++++++ examples/nav.config.json | 4 + 10 files changed, 287 insertions(+), 16 deletions(-) create mode 100644 .github/CONTRIBUTING.fr-FR.md create mode 100644 examples/docs/fr-FR/timeline.md diff --git a/.github/CONTRIBUTING.fr-FR.md b/.github/CONTRIBUTING.fr-FR.md new file mode 100644 index 00000000000..2d416f48223 --- /dev/null +++ b/.github/CONTRIBUTING.fr-FR.md @@ -0,0 +1,60 @@ +# Guide de contribution à l'assurance-chômage par élément + +Bonjour! Merci d'avoir choisi Element UI. + +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. + +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. + +## Concernant les issues + +- 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. + +- Avant de soumettre une issue, veuillez vérifier si des problèmes similaires n'ont pas déjà été signalés. + +- 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. + +## Concernant les pull requests + +- Faites un fork de ce dépôt vers votre compte. Ne créez pas de branches ici. + +- 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`) + +- **NE PAS** inclure de fichiers dans le répertoire `lib`. + +- Assurez-vous que l'exécution de `npm run dist` génère les bons fichiers. + +- 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. + +- Faites un rebase avant la création d'une PR pour garder l'historique clair. + +- Assurez-vous que les PRs sont créés dans la branche `dev` au lieu de la branche `master`. + +- Si votre PR corrige un bug, veuillez fournir une description du bug en question. + +- 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. + +## Pré-requis +`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`. +```shell +git clone git@github.com:ElemeFE/element.git +npm run dev + +# open http://localhost:8085 +``` + +> **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, regardez le résultat rapidement et facilement. + +Pour le build: + +```shell +npm run dist +``` + +## Concernant le développement de composants +- Exécutez `make new ` pour créer un répertoire pour le nouveau composant. Les tests, le fichier d'entrée et la documentation sont inclus. +- Reportez-vous au `Button` pour les composants imbriqués. +- Reportez-vous à `Select` pour connaître les composants qui dépendent d'autres composants. + +## Style du code +Il suffit de se conformer à la configuration [ESLint](https://github.com/ElemeFE/eslint-config-elemefe) de [ElemeFE](https://github.com/elemefe). diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 239cdb19b0a..12f9bf8b426 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -1,5 +1,5 @@ Please make sure these boxes are checked before submitting your PR, thank you! -* [ ] Make sure you follow Element's contributing guide ([中文](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.zh-CN.md) | [English](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.en-US.md) | [Español](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.es.md)). +* [ ] Make sure you follow Element's contributing guide ([中文](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.zh-CN.md) | [English](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.en-US.md) | [Español](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.es.md) | [Français](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.fr-FR.md)). * [ ] Make sure you are merging your commits to `dev` branch. * [ ] Add some descriptions and refer relative issues for you PR. diff --git a/examples/docs/fr-FR/custom-theme.md b/examples/docs/fr-FR/custom-theme.md index 68d73cdf62d..42717e5c299 100644 --- a/examples/docs/fr-FR/custom-theme.md +++ b/examples/docs/fr-FR/custom-theme.md @@ -111,12 +111,15 @@ Vue.use(ElementUI) Si vous utilisez `babel-plugin-component` pour les imports sur demande, modifiez `.babelrc` et spécifiez `styleLibraryName` avec le chemin où votre thème est localisé relativement à `.babelrc`. N'oubliez pas que `~` est requis: ```json { - "plugins": [["component", [ - { - "libraryName": "element-ui", - "styleLibraryName": "~theme" - } - ]]] + "plugins": [ + [ + "component", + { + "libraryName": "element-ui", + "styleLibraryName": "~theme" + } + ] + ] } ``` diff --git a/examples/docs/fr-FR/i18n.md b/examples/docs/fr-FR/i18n.md index 4e886eadf2c..7c2e0161eaf 100644 --- a/examples/docs/fr-FR/i18n.md +++ b/examples/docs/fr-FR/i18n.md @@ -221,6 +221,7 @@ Actuellement, Element supporte les langues suivantes:
  • Serbe (sr)
  • Basque (eu)
  • Kirghize (kg)
    • +
  • Arménien (hy)
    • Si votre langue n'apparaît pas dans la liste, n'hésitez pas a contribuer: ajoutez simplement un fichier de configuration [ici](https://github.com/ElemeFE/element/tree/dev/src/locale/lang) et créez une pull request. diff --git a/examples/docs/fr-FR/icon.md b/examples/docs/fr-FR/icon.md index 42c641c3ea6..a199c1747e1 100644 --- a/examples/docs/fr-FR/icon.md +++ b/examples/docs/fr-FR/icon.md @@ -37,8 +37,6 @@ line-height: 120px; color: #666; font-size: 13px; - transition: color .15s linear; - border-right: 1px solid #eee; border-bottom: 1px solid #eee; margin-right: -1px; @@ -58,15 +56,16 @@ font-size: 32px; margin-bottom: 15px; color: #606266; + transition: color .15s linear; } .icon-name { display: inline-block; padding: 0 3px; height: 1em; - color: #606266; + transition: color .15s linear; } &:hover { - color: rgb(92, 182, 255); + i,span{color: rgb(92, 182, 255);} } } diff --git a/examples/docs/fr-FR/input.md b/examples/docs/fr-FR/input.md index 0fa26dcdccf..28589b00546 100644 --- a/examples/docs/fr-FR/input.md +++ b/examples/docs/fr-FR/input.md @@ -716,6 +716,7 @@ Vous pouvez aller chercher des infos de suggestions sur un serveur distant. | suffix-icon | Classe de l'iĉone de suffixe. | string | — | — | | hide-loading | Si l'icône de chargement doit être cachée dans le cas d'une recherche distante. | boolean | — | false | | popper-append-to-body | Si le menu doit être ajouter au body. Si le positionnement du menu est incorrect, essayez de mettre cette propriété à `false`. | boolean | - | true | +| highlight-first-item | Si la première suggestion de la liste issue de la recherche distante doit être en surbrillance par défaut. | boolean | — | false | ### Slots de l'autocomplétion diff --git a/examples/docs/fr-FR/select.md b/examples/docs/fr-FR/select.md index 04907ab7200..088d4090c81 100644 --- a/examples/docs/fr-FR/select.md +++ b/examples/docs/fr-FR/select.md @@ -684,8 +684,8 @@ Si la valeur de Select est un objet, assurez-vous d'utiliser `value-key` comme i | remote-method | Méthode pour la recherche distante. | function | — | — | | loading | Si le sélecteur est en train de charger des options. | boolean | — | false | | loading-text | Texte à afficher pendant le chargement. | string | — | Loading | -| no-match-text | Texte à afficher quand le filtrage ne retourne aucune option. | string | — | No matching data | -| no-data-text | Texte à afficher quand il n'y a aucune option. | string | — | No data | +| no-match-text | Texte à afficher quand le filtrage ne retourne aucune option. Vous pouvez aussi utiliser le slot `empty`. | string | — | No matching data | +| no-data-text | Texte à afficher quand il n'y a aucune option. Vous pouvez aussi utiliser le slot `empty`. | string | — | No data | | popper-class | Classe du menu déroulant. | string | — | — | | reserve-keyword | Quand `multiple` et `filter` sont activés, si il faut réserver le mot-clé courant après la sélection d'une option. | boolean | — | false | | default-first-option | Sélectionne la première option avec Entrée. Utilisable avec `filterable` ou `remote` | boolean | - | false | @@ -709,6 +709,7 @@ Si la valeur de Select est un objet, assurez-vous d'utiliser `value-key` comme i |---------|-------------| | — | Liste de options. | | prefix | Contenu du préfixe du sélecteur. | +| empty | Contenu lorsqu'il n'y a aucune option. | ### Attributs du groupe d'options diff --git a/examples/docs/fr-FR/table.md b/examples/docs/fr-FR/table.md index 17a6b9d79a7..72234a78592 100644 --- a/examples/docs/fr-FR/table.md +++ b/examples/docs/fr-FR/table.md @@ -2105,9 +2105,9 @@ Vous pouvez personnaliser les indices des colonnes de type `index`. | cell-mouse-leave | Se déclenche quand la souris sort d'une cellule. | row, column, cell, event | | cell-click | Se déclenche quand l'utilisateur clique sur une cellule. | row, column, cell, event | | cell-dblclick | Se déclenche quand l'utilisateur double-clique sur une cellule. | row, column, cell, event | -| row-click | Se déclenche quand l'utilisateur clique sur une ligne. | row, event, column | -| row-contextmenu | Se déclenche quand l'utilisateur fait un click droit sur une ligne. | row, event | -| row-dblclick | Se déclenche quand l'utilisateur double-clique sur une ligne. | row, event | +| row-click | Se déclenche quand l'utilisateur clique sur une ligne. | row, column, event | +| row-contextmenu | Se déclenche quand l'utilisateur fait un click droit sur une ligne. | row, column, event | +| row-dblclick | Se déclenche quand l'utilisateur double-clique sur une ligne. | row, column, event | | header-click | Se déclenche quand l'utilisateur clique sur une colonne du header. | column, event | | header-contextmenu | Se déclenche quand l'utilisateur fait un click droit sur une colonne du header. | column, event | | sort-change | Se déclenche quand l'ordre de tri change. | { column, prop, order } | diff --git a/examples/docs/fr-FR/timeline.md b/examples/docs/fr-FR/timeline.md new file mode 100644 index 00000000000..bc401512965 --- /dev/null +++ b/examples/docs/fr-FR/timeline.md @@ -0,0 +1,202 @@ + + + +## Timeline + +Affiche une suite d'évènements dans un ordre chronologique. + +### Usage + +La ligne du temps peut être divisée en plusieurs activités en ordre ascendant ou descendant. Les timestamps sont des caractéristiques importantes qui les distinguent des autres composants. Notez la différence avec Steps. + +:::demo +```html +
    +
    + Order: + + Descendant + Ascendant + +
    + + + + {{activity.content}} + + +
    + + +``` +::: + +### Noeud personnalisé + +Vous pouvez personnaliser la taille, la couleur et les icônes de chaque Noeud. + +:::demo +```html +
    + + + {{activity.content}} + + +
    + + +``` +::: + +### Timestamp personnalisé + +Le timestamp peut être placé au-dessus du contenu lorsque celui-ci est trop haut. + +:::demo +```html +
    + + + +

    Mise à jour du template GitHub

    +

    Commit de Tom le 2018/4/12 20:46

    +     +     + + +

    Mise à jour du template GitHub

    +

    Commit de Tom le 2018/4/3 20:46

    +     +     + + +

    Mise à jour du template GitHub

    +

    Commit de Tom le 2018/4/2 20:46

    +     +     +     +
    +``` +::: + +### Attributs de Timeline + +| Attribut | Description | Type | Valeurs acceptées | Défaut | +|---------- |-------- |---------- |------------- |-------- | +| reverse | Si l'ordre chronologique est ascendant ou descendant, le défaut étant ascendant. | boolean | — | false | + +### Attribut de Timeline-item + +| Attribut | Description | Type | Valeurs acceptées | Défaut | +|---------- |-------- |---------- |------------- |-------- | +| timestamp | Le contenu du timestamp. | string | - | — | +| hide-timestamp | Si le timestamp doit être affiché. | boolean | — | false | +| placement | La position du timestamp. | string | top / bottom | bottom | +| type | Le type de noeud. | string | primary / success / warning / danger / info | - | +| color | La couleur de fond du noeud. | string | hsl / hsv / hex / rgb | - | +| size | La taille du noeud | string | normal / large | normal | +| icon | Le nom de classe de l'icône. | string | — | - | + +### Slots de Timeline-Item + +| Nom | Description | +|------|--------| +| — | Contenu personnalisé pour le timeline-item. | +| dot | Noeud personnalisé. | diff --git a/examples/nav.config.json b/examples/nav.config.json index 0a54c1502fe..6ef246be03b 100644 --- a/examples/nav.config.json +++ b/examples/nav.config.json @@ -1005,6 +1005,10 @@ { "path": "/collapse", "title": "Collapse" + }, + { + "path": "/timeline", + "title": "Timeline" } ] }