Cette méthode ne requiert aucune compétence en programmation ni aucune manipulation de code. Le seul prérequis est que vous devez disposer d'un hébergement web.

1. Téléchargez le convertisseur complet (interface HTML + code de conversion de texte) :
   Télécharger le convertisseur

2. Ouvrez le fichier .zip que vous venez de télécharger et placez le dossier "keetag" qu'il contient sur votre serveur (en utilisant un client FTP tel que FileZilla).
   

   
   Dézipper (décompresser) le dossier Keetag
   

         

   
   Le dossier Keetag décompressé
   

3. Le convertisseur est désormais installé sur votre site ! Vérifiez qu'il est accessible :

   • Si votre site est http://johndoe.fr et que vous avez déposé le dossier "keetag" à la racine de votre serveur, le convertisseur est à l'adresse
     http://johndoe.fr/keetag/.

   • Si vous avez placé le dossier "keetag" à l'intérieur d'un dossier "xxxx", le convertisseur sera à l'adresse
     http://johndoe.fr/xxxx/keetag/.

4. Il vous reste à configurer le langage de départ et d'arrivée que vous souhaitez pour vos conversions. Pour cela, ouvrez le fichier "config.ini" dans un éditeur de texte et remplacez les identifiants existants par les ID adéquats (liste des ID des langages d'entrée et de sortie).
   

   
   Configurer Keetag
   

En pratique, vous souhaiterez sans doute intégrer le convertisseur dans une de vos propres pages. Vous pouvez le faire facilement en reprenant les éléments HTML de l'interface. Ceux-ci sont réduits au strict nécessaire afin que la structure soit claire et intuitive, même si vous n'êtes pas familiers avec le HTML.

Si votre site est en PHP, le moyen le plus simple et rapide d'appeler l'API est d'utiliser la librairie KeetagCaller. Si vous avez besoin d'un autre langage (Python, Javascript...), consultez la section Mise en place rapide sans librairie.

1. Téléchargez la librairie KeetagCaller et placez-la sur votre serveur.

2. Intégrez le convertisseur dans votre site sur ce modèle. Vous aurez besoin de connaître l'ID du langage de départ et de celui d'arrivée, pour cela consultez la liste des langages pris en charge.

   <?php
   // Includes the Keetag library
   require 'KeetagCaller.php';
   $keetag = new KeetagCaller();
   // Example of text to convert. In your real site, you will probably replace
   // this hard coded text with something like $_POST['text_to_convert']
   $text_to_convert = 'Hello <b>World</b>!
   Use the powerful <a href="https://keetag.net">Keetag converter</a>
   to implement formatting tags on your site very easily.';
   // The text is in HTML, so we set "1" (ID of the HTML language on Keetag)
   $orig_language_id   = 1;
   // We want to convert the text to BBcode, so we set "2" (ID of the BBCode language)
   $destin_language_id = 2;
   // Converts the text
   $result = $keetag->convert_text($text_to_convert, $orig_language_id, $destin_language_id);
   // Displays the text after conversion
   echo $result['converted_text'];

   
   
   

3. Astuce :

   Vous pouvez également définir les langages de départ et d'arrivée une fois pour toutes avec set_option(). Ainsi, vous n'aurez pas besoin de les préciser en paramètre à chaque appel de convert_text() :

   <?php
   // Sets the original et destination languages
   $keetag->set_option('orig_language_id',   $orig_language_id);
   $keetag->set_option('destin_language_id', $destin_language_id);
   // Converts the text, with only one parameter
   $result = $keetag->convert_text($text_to_convert);
   // Displays the text after conversion
   echo $result['converted_text'];

Les exemples de code sont en PHP, mais vous pouvez bien sûr les transposer dans le langage de votre choix.

1. Commençons par définir les 3 variables qui serviront pour la conversion. Pour connaître les ID des langages de départ et d'arrivée, consultez la liste des langages pris en charge.

   
   // Example of text to convert. In your real site, you will probably replace
   // this hard coded text with something like $_POST['text_to_convert']
   $text_to_convert = 'Hello <b>World</b>!
   Use the powerful <a href="https://keetag.net">Keetag converter</a>
   to implement formatting tags on your site very easily.';
   // The text is in HTML, so we set "1" (ID of the HTML language on Keetag)
   $orig_language_id   = 1;
   // We want to convert the text to BBcode, so we set "2" (ID of the BBCode language)
   $destin_language_id = 2;

2. Votre texte sera envoyé à la page de l'API grâce à la méthode POST.
   Pour faire cela sans recourir à un formulaire HTML, utilisez la fonction stream_context_create()
   en PHP (ou son équivalent dans un autre langage). Vous pouvez copier le code ci-dessous sans le modifier :

   $stream = stream_context_create([
       'http' => [
           'method'  => 'POST',
           // Important : sets a user agent
           'header'  => "Content-type: application/x-www-form-urlencoded\r\n"
                       ."User-Agent: Mozilla/4.0 (compatible; MSIE 6.0)\r\n",
           // Your datas for the conversion are applied here
           'content' => http_build_query([
               'text_to_convert'       => $text_to_convert,
               'orig_language_id'      => $orig_language_id,
               'destin_language_id'    => $destin_language_id
               ])
           ]
       ]);

   Remarquez que ce code envoie un user agent. Ceci est indispensable quel que soit le langage que vous utilisez. Si vous ne le faites pas, le serveur retournera une erreur « 403/forbidden » et votre script ne pourra pas accéder à l'API.

3. Vous devez à présent envoyer ces données à la page de l'API. En PHP, utilisez la fonction native file_get_contents() :

   $json = file_get_contents('https://keetag.net/en/api/v1/converter', FALSE, $stream);

   Vous pouvez utiliser un outil plus performant comme cURL s'il est disponible sur votre plateforme.

4. Ce que vous venez de récupérer est un flux texte au format JSON. Pour le manipuler avec PHP, transformez-le en array avec la fonction json_decode() :

   $result = json_decode($json, TRUE);

   Si votre version de PHP ne contient pas la fonction json_decode() (versions antérieures à PHP 5.2), vous pouvez l'y ajouter grâce à cette astuce archivée (utilisation du package « Services_JSON »).

   Le texte converti se trouve dans la clé "converted_text" :

   echo $result['converted_text'];

1. ↑ Le site Keetag officiel en français

2. ↑ The official Keetag site in English

3. ↑ Jeu d'essais de Keetag (Keetag test set)

4. ↑ Discussions à propos de Keetag

5. ↑ KeetagCaller : API Keetag : intégrer Keetag dans un site web ou une application