From 46822679e9c90607177412f84001361948e02eb7 Mon Sep 17 00:00:00 2001 From: Pierre V Date: Thu, 13 Oct 2016 22:53:29 +0200 Subject: [PATCH] Adding french translation --- docs/fr/README.md | 355 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 355 insertions(+) create mode 100644 docs/fr/README.md 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 +======================== + +[![Build Status](https://travis-ci.org/SimpleSoftwareIO/simple-qrcode.svg?branch=master)](https://travis-ci.org/SimpleSoftwareIO/simple-qrcode) +[![Latest Stable Version](https://poser.pugx.org/simplesoftwareio/simple-qrcode/v/stable.svg)](https://packagist.org/packages/simplesoftwareio/simple-qrcode) +[![Latest Unstable Version](https://poser.pugx.org/simplesoftwareio/simple-qrcode/v/unstable.svg)](https://packagist.org/packages/simplesoftwareio/simple-qrcode) +[![License](https://poser.pugx.org/simplesoftwareio/simple-qrcode/license.svg)](https://packagist.org/packages/simplesoftwareio/simple-qrcode) +[![Total Downloads](https://poser.pugx.org/simplesoftwareio/simple-qrcode/downloads.svg)](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`. + +
+ {!! QrCode::size(100)->generate(Request::url()); !!} +

Scanne moi pour retourner à la page originale.

+
+ +#### Intégrer un QrCode + +Vous pouvez intégrer un qrcode dans un e-mail pour permettre à vos utilisateur de le scanner rapidement. Ci-après est un exemple de comment faire ceci avec Laravel. + + //Dans un template blade. + + + +## 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')`. + +![Merged Logo](https://raw.githubusercontent.com/SimpleSoftwareIO/simple-qrcode/master/docs/imgs/merged-qrcode.png?raw=true) + +#### 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`. + + + + +## Assistants + +#### Que sont les assistants? + +Les assistants sont une façon facile de créer des QrCodes qui font faire une certaine action à un lecteur lorsque scanné. + +#### E-Mail + +Cet assistant génère un qrcode e-mail qui peut remplir l'adresse email, le sujet et le corps du message. + + QrCode::email($to, $subject, $body); + + //Remplit l'adresse du destinataire + QrCode::email('foo@bar.com'); + + //Remplit l'adresse du destinataire, le sujet et le corps d'un e-mail. + QrCode::email('foo@bar.com', 'Ceci est le sujet.', 'Ceci est le corps du message.'); + + //Remplit juste le sujet et le corps d'un e-mail. + QrCode::email(null, 'Ceci est le sujet.', 'Ceci est le corps du message.'); + +#### Geo + +Cet assistant génère une latitude et une longitude qu'un téléphone peut lire et ouvrir la localisation dans Google Maps ou une application similaire. + + QrCode::geo($latitude, $longitude); + + QrCode::geo(37.822214, -122.481769); + +#### Numéro de téléphone + +Cet assistant génère un QrCode qui peut être scanné puis compose un numéro. + + QrCode::phoneNumber($phoneNumber); + + QrCode::phoneNumber('555-555-5555'); + QrCode::phoneNumber('1-800-Laravel'); + +#### SMS (Messages Texto) + +Cet assistant créé des messages SMS qui peuvent être préremplis avec le numéro du destinataire et le corps du messages. + + QrCode::SMS($phoneNumber, $message); + + //Créé un message texte avec le numéro rempli. + QrCode::SMS('555-555-5555'); + + //Créé un message texte avec le numéro et le message remplis. + QrCode::SMS('555-555-5555', 'Corps du message'); + +#### WiFi + +Cet assistant créé des QrCodes scannables qui peuvent connecter un téléphone à un réseau WiFI. + + QrCode::wiFi([ + 'encryption' => 'WPA/WEP', + 'ssid' => 'SSID du réseau', + 'password' => 'Mot de passe du réseau', + 'hidden' => 'Si réseau est un SSID caché ou non.' + ]); + + //Connecte à un réseau WiFi ouvert. + QrCode::wiFi([ + 'ssid' => 'Nom du réseau', + ]); + + //Connecte à un réseau WiFi ouvert et caché. + QrCode::wiFi([ + 'ssid' => 'Nom du réseau', + 'hidden' => 'true' + ]); + + //Connecte à un réseau WiFi sécurisé. + QrCode::wiFi([ + 'ssid' => 'Nom du réseau', + 'encryption' => 'WPA', + 'password' => 'myPassword' + ]); + +>Le scan WiFi n'est actuellement pas supporté sur les produits Apple. + + +##Utilisation QrCode Commune + +Vous pouvez utiliser un préfixe trouvé dans le tableau ci-dessous dans la section `generate` pour créer un QrCode pour stocker des informations plus avancées : + + QrCode::generate('http://www.simplesoftware.io'); + + +| Utilisation | Préfixe | Exemple | +| --- | --- | --- | +| URL Website | http:// | http://www.simplesoftware.io | +| URL sécurisée | https:// | https://www.simplesoftware.io | +| Adresse E-mail | mailto: | mailto:support@simplesoftware.io | +| Numéro de téléphone | tel: | tel:555-555-5555 | +| Texto (SMS) | sms: | sms:555-555-5555 | +| Texto (SMS) avec message prétapé | sms: | sms::I am a pretyped message | +| Texto (SMS) avec message prétapé et numéro | sms: | sms:555-555-5555:I am a pretyped message | +| Address géographique | geo: | geo:-78.400364,-85.916993 | +| MeCard | mecard: | MECARD:Simple, Software;Some Address, Somewhere, 20430;TEL:555-555-5555;EMAIL:support@simplesoftware.io; | +| VCard | BEGIN:VCARD | [See Examples](https://en.wikipedia.org/wiki/VCard) | +| Wifi | wifi: | wifi:WEP/WPA;SSID;PSK;Hidden(True/False) | + + +##Utilisation en dehors de Laravel + +Vous pouvez utiliser ce paquet en dehors de Laravel en instanciant une nouvelle classe `BaconQrCodeGenerator`. + + use SimpleSoftwareIO\QrCode\BaconQrCodeGenerator; + + $qrcode = new BaconQrCodeGenerator; + $qrcode->size(500)->generate('Make a qrcode without Laravel!');