Restructuration

* Refonte de la documentation (README, CONTRIBUTING) * Ajout des sauts de ligne en fin de fichier * Suppression du fichier inutile source.csv.txt
lalbert · Dec 28, 2015 · fc9d0ae · fc9d0ae
1 parent 4b96f5c
commit fc9d0ae
Show file tree

Hide file tree

Showing 12 changed files with 167 additions and 8,042 deletions.
diff --git a/.travis.yml b/.travis.yml
@@ -10,4 +10,5 @@ before_script:
   - composer install --prefer-dist
 
 script:
-  - ./vendor/bin/phpunit -c phpunit.xml.dist
+  - ./vendor/bin/phpunit -c phpunit.xml.dist
+
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -2,20 +2,30 @@
 
 Toute aide à la traduction de Magento 2 en français est la bienvenue !
 
-## Traduire les modules
+Le package est basé sur 3 fichiers de traduction :
 
-1. Recherchez dans [la liste des tickets](https://github.com/lalbert/magento2-fr_fr/issues?utf8=%E2%9C%93&q=is%3Aopen+label%3A%22A+traduire%22+-label%3A%22Traduction+en+cours%22) les modules qui ont besoin d'être traduit
-2. "Forkez" le dépôt
-3. Indiquez dans les commentaires du ticket que vous travaillez sur la traduction du module. Le label "En cours de traduction" sera ajouté
-4. Utilisez le fichier `source.csv.txt` pour effectuer la traduction du module concerné
-5. Fusionnez vos traductions dans le fichier `fr_fr.csv`
-6. Effectuez un pull-request pour l'intégration des traductions
+* [fr_fr.csv](https://github.com/lalbert/magento2-fr_fr/blob/develop/fr_fr.csv) : toutes ces chaînes ont été extraites de [Magento 2.0.0](https://github.com/magento/magento2/tree/2.0) en utilisant la commande [`i18n:collect-phrases`](http://devdocs.magento.com/guides/v2.0/config-guide/cli/config-cli-subcommands-i18n.html#config-cli-subcommands-xlate-dict).
+* [fr_fr.missing.csv](https://github.com/lalbert/magento2-fr_fr/blob/develop/fr_fr.missing.csv) : contient des chaînes supplémentaires qui n'ont pas pas été extraites avec la commande précédente.
+* [fr_fr.script.csv](https://github.com/lalbert/magento2-fr_fr/blob/develop/fr_fr.script.csv) : contient des chaînes dont les apostrophes sont échappées pour corriger des erreurs dans les scripts.
 
-### Recommentadions
+*Les 2 fichiers `fr_fr.missing.csv` et `fr_fr.script.csv` ne devraient théoriquement pas exister puisque Magento devrait d'une part extraire correctement toutes les chaînes traductibles, et devrait d'autre part correctement échapper les caractères posant d'éventuels problèmes.
+Ces problèmes ayant été remonté aux équipes de développement de Magento, nous sommes optimistes pour qu'ils soient corrigés dans une future version et seront donc inutiles.*
+
+## Reportez une erreur
+
+Si vous utilisez le package est que vous remarquez une erreur de traduction, une "coquille", une ~~fote d'ortografe~~ faute d'orthographe ou autre, vous pouvez [ouvrir un ticket](https://github.com/lalbert/magento2-fr_fr/issues/new) **après avoir vérifié** dans [la liste](https://github.com/lalbert/magento2-fr_fr/issues?utf8=%E2%9C%93&q=is%3Aopen+-label%3A%22A+traduire%22) que le problème n'a pas déjà été soulevé.
+
+## Discution sur les termes de traduction
+
+Certain termes peuvent être traduit de plusieurs façons différentes (ex: "Save" : "Sauvegarder" ou "Enregistrer").
+Afin d'uniformiser les traductions dans l'ensemble de Magento, des [tickets de discussion](https://github.com/lalbert/magento2-fr_fr/issues?q=is%3Aopen+is%3Aissue+label%3Adiscussion) sont ouverts (ou peuvent être ouverts) afin de voter pour le meilleur terme à intégrer.
+
+## Proposer vos traductions et corrections
+
+Si vous êtes utilisateur de GitHub, vous pouvez proposer vos propres traductions et corrections en demandant des Pull Request.
+
+Notez que les Pull Request ne sont autorisés que sur la branche [develop](https://github.com/lalbert/magento2-fr_fr/tree/develop).
 
-Le fichier fr_fr.csv ne doit contenir que des chaînes traduites !
-Ne traduisez qu'un module à la fois, ou séparez bien vos différentes traductions en différentes branches.
-Un pull request doit contenir obligatoirement les modifications du fichiers `source.csv.txt` et `fr_fr.csv`.
 
 ### Tests automatisés des traductions
 
@@ -26,11 +36,5 @@ Des tests ont été mis en place afin de vérifier au mieux les traductions. Les
 * Vérifie si la case du 1er caractère est respectée
 * Vérifie si la ponctuation de fin de chaîne est bien respectée
 
-## Tester les traductions
 
-Si vous avez installé le package est que vous remarquez une erreur de traduction, une "coquille", une ~~fote d'ortografe~~ faute d'orthographe ou autre, vous pouvez [ouvrir un ticket](https://github.com/lalbert/magento2-fr_fr/issues/new) **après avoir vérifié** dans [la liste](https://github.com/lalbert/magento2-fr_fr/issues?utf8=%E2%9C%93&q=is%3Aopen+-label%3A%22A+traduire%22) que le problème n'a pas déjà été soulevé.
 
-## Discution sur les termes de traduction
-
-Certain termes peuvent être traduit de plusieurs façons différentes (ex: "Save" : "Sauvegarder" ou "Enregistrer").
-Afin d'uniformiser les traductions dans l'ensemble de Magento, des [tickets de discussion](https://github.com/lalbert/magento2-fr_fr/issues?q=is%3Aopen+is%3Aissue+label%3Adiscussion) sont ouverts (ou peuvent être ouverts) afin de voter pour le meilleur terme à intégrer.
diff --git a/README.md b/README.md
@@ -4,6 +4,10 @@ Traduction de l'interface de Magento 2 en Français.
 
 # Installation
 
+## Via composer
+
+La méthode la plus simple est d'utiliser composer pour installer et mettre à jour le package de traduction :
+
 Ajouter le composant dans le fichier composer.json :
 
     composer require lalbert/magento2-fr_fr:@alpha
@@ -12,112 +16,36 @@ Vider le cacher
 
     bin/magento cache:clean
 
+Pour effectuer la mise à jour :
+
+	composer update
+
+## Téléchargement du package
+
+Si vous désirez installer le package sans utiliser composer, téléchargez-le et décompressez-le dans le répertoire `app/i18n/lalbert/fr_fr`
+
 # Contribuer à la traduction
 
 Référez-vous au fichier [CONTRIBUTING.md](https://github.com/lalbert/magento2-fr_fr/blob/master/CONTRIBUTING.md) si vous désirez contribuer aux traductions.
-
-# Progression de la traduction
-
-Toutes les chaînes de traduction compatiblent avec la version 1 de Magento ont été intégrées (les chaînes contenant des variables `%s` et `%d` ont également été rendu compatibles et intégrées)
-
-**Progression globale** : 7769/7775 ![Progress](http://progressed.io/bar/100)
-
-## Thèmes
-
-| Module | Nbr de chaînes | Nbr de chaînes traduites | Nbr de chaînes restantes | Progression |
-| :----- | -------------: | -----------------------: | -----------------------: | :---------: |
-| frontend/Magento/blank | 7 | 7 | 0 | ![Progress](http://progressed.io/bar/100) |
-| frontend/Magento/luma | 44 | 44 | 0 | ![Progress](http://progressed.io/bar/100) |
-
-## Modules
-
-| Module | Nbr de chaînes | Nbr de chaînes traduites | Nbr de chaînes restantes | Progression |
-| :----- | -------------: | -----------------------: | -----------------------: | :---------: |
-| Magento_AdminNotification | 49 | 49 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_AdvancedPricingImportExport | 4 | 4 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Authorization | 2 | 2 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Authorizenet | 66 | 66 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Backend | 426 | 426 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Backup | 78 | 78 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Braintree | 125 | 125 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Bundle | 93 | 93 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Captcha | 24 | 24 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Catalog | 656 | 657 | 1 | ![Progress](http://progressed.io/bar/100) |
-| Magento_CatalogImportExport | 18 | 18 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_CatalogInventory | 57 | 57 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_CatalogRule | 76 | 76 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_CatalogSearch | 36 | 36 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_CatalogUrlRewrite | 6 | 6 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_CatalogWidget | 20 | 20 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Checkout | 135 | 135 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_CheckoutAgreements | 39 | 39 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Cms | 148 | 148 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Config | 89 | 89 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_ConfigurableProduct | 124 | 124 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Contact | 23 | 23 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Cookie | 13 | 13 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Cron | 18 | 18 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_CurrencySymbol | 17 | 17 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Customer | 466 | 466 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_CustomerImportExport | 17 | 17 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Deploy | 1 | 1 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Developer | 9 | 9 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Dhl | 80 | 80 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Directory | 44 | 44 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Downloadable | 110 | 110 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_DownloadableImportExport | 3 | 3 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Eav | 140 | 140 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Email | 96 | 96 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_EncryptionKey | 13 | 13 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Fedex | 74 | 74 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_GiftMessage | 34 | 34 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_GoogleAdwords | 13 | 13 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_GoogleAnalytics | 4 | 4 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_GoogleOptimizer | 7 | 7 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_GroupedProduct | 22 | 22 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_ImportExport | 114 | 114 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Indexer | 22 | 22 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Integration | 109 | 109 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_LayeredNavigation | 28 | 28 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Marketplace | 13 | 13 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_MediaStorage | 25 | 25 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Msrp | 18 | 18 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Multishipping | 88 | 88 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_NewRelicReporting | 20 | 20 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Newsletter | 146 | 146 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_OfflinePayments | 23 | 23 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_OfflineShipping | 49 | 49 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_PageCache | 17 | 17 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Payment | 49 | 49 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Paypal | 556 | 556 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Persistent | 17 | 17 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_ProductAlert | 35 | 35 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_ProductVideo | 40 | 40 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Quote | 53 | 53 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Reports | 214 | 214 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Review | 131 | 131 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Rss | 7 | 7 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Rule | 34 | 34 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Sales | 754 | 754 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_SalesRule | 149 | 149 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_SalesSequence | 2 | 2 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Search | 52 | 52 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_SendFriend | 46 | 46 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Shipping | 177 | 177 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Sitemap | 64 | 64 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Store | 34 | 34 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Swatches | 25 | 25 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Tax | 172 | 172 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_TaxImportExport | 19 | 19 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Theme | 146 | 146 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Translation | 5 | 5 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Ui | 77 | 81 | 4 | ![Progress](http://progressed.io/bar/95) |
-| Magento_Ups | 111 | 111 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_UrlRewrite | 61 | 61 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_User | 126 | 126 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Usps | 132 | 132 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Variable | 21 | 21 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Webapi | 19 | 19 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Weee | 27 | 28 | 1 | ![Progress](http://progressed.io/bar/96) |
-| Magento_Widget | 72 | 72 | 0 | ![Progress](http://progressed.io/bar/100) |
-| Magento_Wishlist | 115 | 115 | 0 | ![Progress](http://progressed.io/bar/100) |
+
+# Version
+
+Les versions du package suivent les recommendations de la [Gestion sémantique de version](http://semver.org/lang/fr/).
+
+Destinée initialement au développement logiciel, voici les règles utilisées pour notre numérotation :
+
+## Incrémentation du numéro de version de CORRECTIF (x.y.**Z**)
+
+* Correction de coquilles
+* Correction de fautes fautes d'orthographes
+* Ajout de nouvelles chaînes traduites
+
+## Incrémentation du numéro de version MINEUR (x.**Y**.z)
+
+* Remplacement d'un mot par un autre
+* Changement du sens litérale de la précédente traduction
+
+## Incrémentation du numéro de version MAJEUR (**X**.y.z)
+
+Ne devrait jamais arriver...
+