Commit fcce1316 authored by Luc Didry's avatar Luc Didry

Merge branch 'patch-1' into 'french-readme'

Translate README.fr.md in french



See merge request !1
parents 7475b141 c40fe062
Pipeline #7059 skipped
......@@ -9,28 +9,28 @@ Si vous souhaitez travailler avec nous, **forkez-nous sur [framagit.org](https:/
# Giphy Mat Hooker
Powered By Giphy
Propulsé par Giphy
The `Mat` stand for [Mattermost](http://www.mattermost.org/).
Le mot `Mat` est un diminutif de [Mattermost](http://www.mattermost.org/).
This service allows you to create [slash commands](http://docs.mattermost.com/developer/slash-commands.html) on Mattermost to search gifs on <http://giphy.com/>.
Ce service vous permet de créer des "[slash commands](http://docs.mattermost.com/developer/slash-commands.html)" (ou commandes slash, commencant par le caractère `/`) dans un chat Mattermost pour chercher et afficher des gifs depuis <http://giphy.com/>.
## License
## Licence
Giphy Mat Hooker is licensed under the terms of the AGPLv3. See the LICENSE file.
Giphy Mat hooker est proposé sous licence AGPLv3. Veuillez vous référer au fichier LICENSE.
# Installation
## Dependencies
## Dépendances
* Carton : Perl dependencies manager, it will get what you need, so don't bother for dependencies (but you can read the file `cpanfile` if you want).
* Carton : Gestionnaire de dépendances Perl qui vous permettra de récupérer les dépendances nécessaires sans vous obliger à les traiter individuellement (mais rien ne vous empêche de consulter le fichier `cpanfile`).
```shell
sudo cpan Carton
```
## The real installation
After installing Carton :
## La véritable installation
Après avoir installé Carton :
```shell
git clone https://git.framasoft.org/framasoft/giphymathooker.git
......@@ -40,23 +40,22 @@ cp giphy_mat_hooker.conf.template giphy_mat_hooker.conf
vi giphy_mat_hooker.conf
```
The configuration file is self-documented.
Le fichier de configuration contient les explications nécessaires.
## Usage
### Launch manually
### Lancement manuel
This is good for test, not for production.
Cette méthode est utile pour les tests, ne pas l'utiliser en production.
```
carton exec hypnotoad script/giphy_mat_hooker
# stop it
carton exec hypnotoad -s script/giphy_mat_hooker
```
Oui, c'est tout. Le service écoutera à l'adresse "http://127.0.0.1:8080".
Yup, that's all, it will listen at "http://127.0.0.1:8080".
For more options (interfaces, user, etc.), change the configuration in `giphy_mat_hooker.conf` (have a look at http://mojolicio.us/perldoc/Mojo/Server/Hypnotoad#SETTINGS for the available options).
Pour plus d'options (interfaces, utilisateurs, etc.), vous pouvez modifier la configuration dans le fichier `giphy_mat_hooker.conf` (jetez un oeil à l'adresse http://mojolicio.us/perldoc/Mojo/Server/Hypnotoad#SETTINGS pour la liste complète des options).
### Systemd
......@@ -71,24 +70,24 @@ systemctl start giphymathooker.service
## Nginx
You may want to put GHM behind a reverse proxy. Have a look at `utilities/giphymathooker.nginx` for an example.
Si vous souhaitez installer GHM derrière un reverse proxy. Consultez le fichier d'exemple `utilities/giphymathooker.nginx`.
# How to use in Mattermost?
# Comment l'utiliser dans Mattermost?
First, have a look at the [Mattermost documentation about slash commands](http://docs.mattermost.com/developer/slash-commands.html).
Jetez tout d'abord un oeil à la [documentation Mattermost sur les slash commands](http://docs.mattermost.com/developer/slash-commands.html).
Then, create your slash command, using the URL of your installation (say https://giphy.example.org), choose `GET` or `POST` method, it doesn't matter, GMH will answer to both.
Créez ensuite votre commande slash en renseignant l'URL de l'installation (par exemple https://giphy.example.org), puis choisissez entre les méthodes `GET` ou `POST`; cela n'a pas d'importance, GMH est capable de répondre aux deux méthodes.
Finally, put the token provided by Mattermost in your GMH configuration file. Or not, if you want anybody to be able to use it if he provides the mattermost parameters.
Enfin, renseignez le jeton (*token*) fourni par Mattermost dans le fichier de configuration de GMH. Si vous ne le renseignez pas, n'importe quel service sera capable de le solliciter s'il fournit les paramètres de Mattermost.
Now, you can search gifs on Giphy with `/gif my search terms` (if you choose `gif` as your slash command).
Vous pouvez désormais chercher des gifs sur Giphy avec la commande `/gif ma recherche` (si vous avez choisi `gif` comme mot clef pour la commande slash).
## Bonus
Point a slash command to https://giphy.example.org/understood/, you'll get this gif:
Si vous créez une commande slash pour l'adresse https://giphy.example.org/understood/, vous obtiendrez ce gif:
![Jack Sparrow saying he understand everything](https://media4.giphy.com/media/cRpEcJPIBEHPG/giphy.gif)
![Jack Sparrow disant qu'il comprend tout](https://media4.giphy.com/media/cRpEcJPIBEHPG/giphy.gif)
Point a slash command to https://giphy.example.org/money/, you'll get this gif:
Une commande slash vers https://giphy.example.org/money/ vous donnera ce gif:
![Man laughing under a banknotes rain](https://media0.giphy.com/media/2mXJvHKUYL9n2/giphy.gif)
![Edgar de la cambriole riant sous une pluie de billets](https://media0.giphy.com/media/2mXJvHKUYL9n2/giphy.gif)
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment