diff --git a/docs/fr/README.md b/docs/fr/README.md new file mode 100644 index 0000000..4252e13 --- /dev/null +++ b/docs/fr/README.md @@ -0,0 +1,355 @@ +Simple QrCode +======================== + +[](https://travis-ci.org/SimpleSoftwareIO/simple-qrcode) +[](https://packagist.org/packages/simplesoftwareio/simple-qrcode) +[](https://packagist.org/packages/simplesoftwareio/simple-qrcode) +[](https://packagist.org/packages/simplesoftwareio/simple-qrcode) +[](https://packagist.org/packages/simplesoftwareio/simple-qrcode) + +####[Español](https://www.simplesoftware.io/docs/simple-qrcode/es) | [Italiano](https://www.simplesoftware.io/docs/simple-qrcode/it) | [Português](https://www.simplesoftware.io/docs/simple-qrcode/pt-br) | [Русский](https://www.simplesoftware.io/docs/simple-qrcode/ru) | [हिंदी](https://www.simplesoftware.io/docs/simple-qrcode/hi) | [汉语](https://www.simplesoftware.io/docs/simple-qrcode/zh) + +- [Introduction](#docs-introduction) +- [Translations](#docs-translations) +- [Configuration](#docs-configuration) +- [Simple Ideas](#docs-ideas) +- [Usage](#docs-usage) +- [Helpers](#docs-helpers) +- [Common QrCode Usage](#docs-common-usage) +- [Usage Outside of Laravel](#docs-outside-laravel) + + +## Introduction +Simple QrCode est un wrapper facile à utiliser pour le framework populaire Laravel basé sur le large travail fourni par [Bacon/BaconQrCode](https://github.com/Bacon/BaconQrCode). Nous avons créé une interface qui est familière et facile à installer pour les utilisateurs de Laravel. + + +## Traductions +Nous cherchons des utilisateurs parlant Arabe, Espagnol, Coréen ou Japonais pour aider à traduire ce document. Créez une pull request si vous pouvez faire une traduction ! + + +## Configuration + +#### Composer + +Premièrement, ajoutez le paquet Simple QrCode dans votre `require` de votre fichier `composer.json` : + + "require": { + "simplesoftwareio/simple-qrcode": "~1" + } + +Ensuite, exécutez la commande `composer update`. + +#### Service Provider + +###### Laravel 4 +Enregistrez le `SimpleSoftwareIO\QrCode\QrCodeServiceProvider` dans votre fichier `app/config/app.php` à l'intérieur de la liste `providers`. + +###### Laravel 5 +Enregistrez le `SimpleSoftwareIO\QrCode\QrCodeServiceProvider::class` dans votre fichier `config/app.php` à l'intérieur de la liste `providers`. + +#### Alias + +###### Laravel 4 +Finalement, enregistrez le `'QrCode' => 'SimpleSoftwareIO\QrCode\Facades\QrCode'` dans votre fichier de configuration `app/config/app.php` à l'intérieur de la liste `aliases`. + +###### Laravel 5 +Finalement, enregistrez le `'QrCode' => SimpleSoftwareIO\QrCode\Facades\QrCode::class` dans votre fichier de configuration `config/app.php` à l'intérieur de la liste `aliases`. + + +## Idées simples + +#### Vues d'impression + +L'une des raisons pour laquelle on utilise ce paquet est d'avoir des QrCodes dans toutes nos vues d'impression. Ceci permet à nos clients de retourner à la page originale après qu'elle ait été imprimée en scannant simplement le code. Nous avons fait ceci en ajoutant le suivant dans notre fichier `footer.blade.php`. + +
Scanne moi pour retourner à la page originale.
+
+
+
+## Utilisation
+
+#### Utilisation basique
+
+Utiliser le générateur QrCode est très facile. La syntaxe la plus basique est :
+
+ QrCode::generate('Make me into a QrCode!');
+
+Ceci va faire un QrCode qui dit "Make me into a QrCode!"
+
+#### Generate
+
+`Generate` est utilisé pour créer le QrCode.
+
+ QrCode::generate('Make me into a QrCode!');
+
+>Attention ! Cette méthode doit être appelée en dernier si utilisée dans une chaîne.
+
+`Generate` va retourner par défaut une chaîne de caractères d'image SVG. Vous pouvez affichez ceci directement dans un navigateur moderne à l'intérieur du system Laravel Blade avec le suivant :
+
+ {!! QrCode::generate('Make me into a QrCode!'); !!}
+
+La méthode `generate` a un second paramètre qui va accepter un nom de fichier et un chemin pour sauvegarder le QrCode.
+
+ QrCode::generate('Make me into a QrCode!', '../public/qrcodes/qrcode.svg');
+
+#### Changement du format
+
+>QrCode Generator est configuré pour retourner une image SVG par defaut.
+
+>Attention ! La méthode `format` doit être appelée avant les autres opions de formattage telles que `size`, `color`, `backgroundColor` et `margin`.
+
+Trois formats sont actuellement supportés : PNG, EPS et SVG. Pour changer le format, utilisez le code suivant :
+
+ QrCode::format('png'); //Va retourner une image PNG
+ QrCode::format('eps'); //Va retourner une image EPS
+ QrCode::format('svg'); //Va retourner une image SVG
+
+#### Changement de la taille
+
+>QrCode Generator va par défaut retourner la plus petite taille possible en pixels pour créer le QrCode.
+
+Vous pouvez changer la taille d'un QrCode en utilisant la méthode `size`. Spécifiez simplement la taille désirée en pixels en utilisant la syntaxe suivante :
+
+ QrCode::size(100);
+
+#### Changement de la couleur
+
+>Faites attention lorsque vous changez la couleur d'un QrCode. Certains lecteurs éprouvent beaucoup de difficulté en lisant des QrCodes colorés.
+
+Toutes les coulers peuvent être exprimées en RVB (Rouge Vert Bleu). Vous pouvez changer la couleur d'un QrCode en utilisant la ligne suivante :
+
+ QrCode::color(255,0,255);
+
+Les changements de couleur d'arrière-plan sont également supportés et peuvent être exprimés de la même façon.
+
+ QrCode::backgroundColor(255,255,0);
+
+#### Changement de la marge
+
+La possibilité de changer la marge autour d'un QrCode est également supportée. Spécifiez simplement la marge désirée en utilisant la syntaxe suivante :
+
+ QrCode::margin(100);
+
+#### Correction d'erreur
+
+Changer le niveau de correction d'erreur est facile. Utilisez juste la syntaxe suivante :
+
+ QrCode::errorCorrection('H');
+
+Les options suivantes sont supportées pour la méthode `errorCorrection`.
+
+| Correction d'erreur | Assurance fournie |
+| --- | --- |
+| L | 7% des mots de code peuvent être restaurés. |
+| M | 15% des mots de code peuvent être restaurés. |
+| Q | 25% des mots de code peuvent être restaurés. |
+| H | 30% des mots de code peuvent être restaurés. |
+
+>Plus le niveau de correction d'erreur est élevé, plus le QrCode devient gros et moins il peut stocker de données. Lisez plus à propos de la [correction d'erreur](https://fr.wikipedia.org/wiki/Code_QR#Correction_d.27erreur).
+
+#### Encodage
+
+Changez l'encodage de caractères utilisé pour construire un QrCode. Par défaut l'encodeur `ISO-8859-1` est sélectionné. Lisez plus à propos du [codage des caractères](https://fr.wikipedia.org/wiki/Codage_des_caractères) Vous pouvez changer ceci en l'un des suivants:
+
+ QrCode::encoding('UTF-8')->generate('Make me a QrCode with special symbols ♠♥!!');
+
+| Encodeur de caractères |
+| --- |
+| ISO-8859-1 |
+| ISO-8859-2 |
+| ISO-8859-3 |
+| ISO-8859-4 |
+| ISO-8859-5 |
+| ISO-8859-6 |
+| ISO-8859-7 |
+| ISO-8859-8 |
+| ISO-8859-9 |
+| ISO-8859-10 |
+| ISO-8859-11 |
+| ISO-8859-12 |
+| ISO-8859-13 |
+| ISO-8859-14 |
+| ISO-8859-15 |
+| ISO-8859-16 |
+| SHIFT-JIS |
+| WINDOWS-1250 |
+| WINDOWS-1251 |
+| WINDOWS-1252 |
+| WINDOWS-1256 |
+| UTF-16BE |
+| UTF-8 |
+| ASCII |
+| GBK |
+| EUC-KR |
+
+>Une erreur `Could not encode content to ISO-8859-1` signifie que le mauvais type d'encodage de caractères est utilisé. Nous recommandons `UTF-8` si vous n'êtes pas sûr.
+
+#### Merge
+
+La méthode `merge` fusionne une image au dessus d'un QrCode. This is commonly used to placed logos within a QrCode.
+
+ QrCode::merge($filename, $percentage, $absolute);
+
+ //Génère un QrCode avec une image centrée au milieu.
+ QrCode::format('png')->merge('path-to-image.png')->generate();
+
+ //Génère un QrCode avec une image centrée au milieu. L'image insérée prend jusqu'à 30% du QrCode.
+ QrCode::format('png')->merge('path-to-image.png', .3)->generate();
+
+ //Génère un QrCode avec une image centrée au milieu. L'image insérée prend jusqu'à 30% du QrCode.
+ QrCode::format('png')->merge('http://www.google.com/someimage.png', .3, true)->generate();
+
+>La méthode `merge` ne supporte actuellement que les PNG.
+>The filepath is relative to app base path if `$absolute` is set to `false`. Change this variable to `true` to use absolute paths.
+
+>Vous devriez utiliser un haut niveau de correction d'erreur lorsque vous utilisez la méthode `merge` afin de vous assurer que le QrCode est encore lisible. Nous recommendons d'utiliser `errorCorrection('H')`.
+
+
+
+#### Merge Binary String
+
+La méthode `mergeString` peut être utilisée pour accomplir la même chose que l'appel `merge`, mais il vous permet de fournir un représentation en chaîne de caractère du fichier au lieu du chemin vers le fichier. C'est utile lorsque vous travaillez avec la facade `Storage`. Son interface est relativement similaire à l'appel `merge`.
+
+ QrCode::mergeString(Storage::get('path/to/image.png'), $percentage);
+
+ //Génère un QrCode avec une image centrée au milieu.
+ QrCode::format('png')->mergeString(Storage::get('path/to/image.png'))->generate();
+
+ //Génère un QrCode avec une image centrée au milieu. L'image insérée prend jusqu'à 30% du QrCode.
+ QrCode::format('png')->mergeString(Storage::get('path/to/image.png'), .3)->generate();
+
+>Comme pour l'appel normal `merge`, seuls les PNG sont supportés actuellement. La même chose s'applique pour la correction d'erreur, de hauts niveaux sont recommandés.
+
+#### Utilisation Avancée
+
+Toutes les méthodes supportent l'enchaînement. La méthode `generate` doit être appelée en dernier et tout changement `format` doit être appelé en premier. Par exemple vous pouvez exécuter les lignes suivantes :
+
+ QrCode::size(250)->color(150,90,10)->backgroundColor(10,14,244)->generate('Make me a QrCode!');
+ QrCode::format('png')->size(399)->color(40,40,40)->generate('Make me a QrCode!');
+
+Vous pouvez afficher une image PNG sans sauvegarder le fichier en fournissant une chaîne brute et encodée avec `base64_encode`.
+
+