Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Téléchargement d'un lexique
<a name="managing-lexicons-console-upload"></a>

Les lexiques que vous utilisez doivent être conformes à la recommandation du W3C du W3C (Prononciation Lexicon Specification, PLS). Pour plus d'informations, consultez la recommandation [Pronunciation Lexicon Specification (PLS) Version 1.0](https://www.w3.org/TR/pronunciation-lexicon/#S4.7) sur le site Web de W3C.

------
#### [ Console - Lexicons tab ]

Pour utiliser un lexique de prononciation, vous devez commencer par le charger. Il y a deux emplacements sur la console à partir desquels vous pouvez charger un lexique, l'onglet **Text-to-Speech** et l'onglet **Lexicons**.

Les procédures suivantes expliquent comment ajouter des lexiques que vous pouvez utiliser pour personnaliser la prononciation de mots et de phrases rares dans la langue choisie. <a name="upload-lexicon-lexicons-tab"></a>

**Pour ajouter un lexique depuis l'onglet Lexiques**

1. Connectez-vous à la console Amazon Polly AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/polly/](https://console.aws.amazon.com/polly/)

1. Choisissez l'onglet **Lexicons**.

1. Choisissez **Charger un lexique**.

1. Donnez un nom au lexique, puis utilisez **Choisir un fichier de lexique** pour trouver le lexique à télécharger. Vous ne pouvez télécharger que des fichiers PLS dotés d'extensions .pls ou .xml.

1. Choisissez **Charger un lexique**. Si un lexique du même nom (qu'il s'agisse d'un fichier .pls ou .xml) existe déjà, le téléchargement du lexique remplace le lexique existant.

------
#### [ Console - TTS tab ]<a name="upload-lexicon-tts-tab"></a>

**Pour ajouter un lexique depuis l'onglet text-to-Speech**

1. Connectez-vous à la console Amazon Polly AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/polly/](https://console.aws.amazon.com/polly/)

1. Choisissez l'onglet **Text-to-Speech (Synthèse vocale)**.

1. Développez **les paramètres supplémentaires**, activez **Personnaliser la prononciation,** puis choisissez **Télécharger le lexique**.

1. Donnez un nom au lexique, puis utilisez **Choisir un fichier de lexique** pour trouver le lexique à télécharger. Vous ne pouvez utiliser que des fichiers PLS dotés d'extensions .pls ou .xml. 

1. Choisissez **Charger un lexique**. Si un lexique portant le même nom (qu'il s'agisse d'un fichier .pls ou .xml) existe déjà, le téléchargement du lexique remplace le lexique existant.

------
#### [ AWS CLI - one lexeme ]

Amazon Polly vous permet de stocker des lexiques [PutLexicon](API_PutLexicon.md) de prononciation dans une AWS région spécifique pour votre compte. Vous pouvez ensuite indiquer un ou plusieurs de ces lexiques stockés dans votre demande [SynthesizeSpeech](API_SynthesizeSpeech.md) que vous souhaitez appliquer avant que le service ne démarre la synthèse du texte. Pour de plus amples informations, veuillez consulter [Gestion des lexiques](managing-lexicons.md).

Considérez le lexique W3C compatible PLS. 

```
<?xml version="1.0" encoding="UTF-8"?>
<lexicon version="1.0" 
      xmlns="http://www.w3.org/2005/01/pronunciation-lexicon"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xsi:schemaLocation="http://www.w3.org/2005/01/pronunciation-lexicon 
        http://www.w3.org/TR/2007/CR-pronunciation-lexicon-20071212/pls.xsd"
      alphabet="ipa" 
      xml:lang="en-US">
  <lexeme>
    <grapheme>W3C</grapheme>
    <alias>World Wide Web Consortium</alias>
  </lexeme>
</lexicon>
```

Remarques :
+ Les deux attributs spécifiés dans l'élément `<lexicon>` :
  + L'`xml:lang`attribut indique le code de langue auquel le lexique s'applique. `en-US` Amazon Polly peut utiliser cet exemple de lexique si la voix que vous spécifiez dans l'`SynthesizeSpeech`appel possède le même code de langue (en-US). 
**Note**  
Vous pouvez utiliser l'opération `DescribeVoices` pour trouver le code de langue associé à une voix.

     
  + L'attribut `alphabet` indique `IPA`, ce qui signifie que l'alphabet phonétique international (API) est utilisé pour les prononciations. L'IPA est l'un des alphabets utilisés pour écrire les prononciations. Amazon Polly prend également en charge l'alphabet phonétique des méthodes d'évaluation vocale étendues (X-SAMPA).

     
+ L'élément `<lexeme>` décrit le mappage entre `<grapheme>` (qui est une représentation de texte du mot) et `<alias>`. 

Pour tester ce lexique, procédez comme suit :

1. Enregistrez le lexique sous le nom `example.pls`.

1. Exécutez la `put-lexicon` AWS CLI commande pour enregistrer le lexique (avec le nom`w3c`) dans la région us-east-2.

   ```
   aws polly put-lexicon \
   --name w3c \
   --content file://example.pls
   ```

1. Exécutez la commande `synthesize-speech` pour synthétiser l'exemple de texte dans un flux audio (`speech.mp3`) et indiquez le paramètre facultatif `lexicon-name`. 

   ```
   aws polly synthesize-speech \
   --text 'W3C is a Consortium' \
   --voice-id Joanna \
   --output-format mp3 \
   --lexicon-names="w3c" \
   speech.mp3
   ```

1. Lisez le fichier `speech.mp3` obtenu et notez que le mot W3C dans le texte est remplacé par « World Wide Web Consortium ».

L'exemple de lexique précédent utilise un alias. L'alphabet API mentionné dans le lexique n'est pas utilisé. Le lexique suivant spécifie une prononciation phonétique à l'aide de l'élément `<phoneme>` avec l'alphabet API.

```
<?xml version="1.0" encoding="UTF-8"?>
<lexicon version="1.0" 
      xmlns="http://www.w3.org/2005/01/pronunciation-lexicon"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xsi:schemaLocation="http://www.w3.org/2005/01/pronunciation-lexicon 
        http://www.w3.org/TR/2007/CR-pronunciation-lexicon-20071212/pls.xsd"
      alphabet="ipa" 
      xml:lang="en-US">
  <lexeme>
    <grapheme>pecan</grapheme>
    <phoneme>pɪˈkɑːn</phoneme>
  </lexeme>
</lexicon>
```

Suivez la même procédure pour tester ce lexique. Assurez-vous de saisir le texte contenant le mot « pacanes » (par exemple, « La tarte aux pacanes est délicieuse »).

Consultez les ressources suivantes pour obtenir des exemples de code supplémentaires pour le fonctionnement de l' PutLexicon API :
+ Exemple Java : [PutLexicon](PutLexiconSample.md)
+ Exemple Python (Boto3) : [PutLexicon](PutLexiconSamplePython.md)

------
#### [ AWS CLI - multiple lexemes ]

Amazon Polly vous permet de stocker des lexiques [PutLexicon](API_PutLexicon.md) de prononciation dans une AWS région spécifique pour votre compte. Vous pouvez ensuite indiquer un ou plusieurs de ces lexiques stockés dans votre demande [SynthesizeSpeech](API_SynthesizeSpeech.md) que vous souhaitez appliquer avant que le service ne démarre la synthèse du texte. Pour de plus amples informations, veuillez consulter [Gestion des lexiques](managing-lexicons.md).

Dans cet exemple, le lexème que vous spécifiez dans le lexique s'applique exclusivement au texte saisi pour la synthèse. Prenez en compte le lexique suivant : 

```
<?xml version="1.0" encoding="UTF-8"?>
<lexicon version="1.0"
      xmlns="http://www.w3.org/2005/01/pronunciation-lexicon"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.w3.org/2005/01/pronunciation-lexicon
        http://www.w3.org/TR/2007/CR-pronunciation-lexicon-20071212/pls.xsd"
      alphabet="ipa" xml:lang="en-US">

  <lexeme> 
    <grapheme>W3C</grapheme>
    <alias>World Wide Web Consortium</alias>
  </lexeme>
  <lexeme> 
    <grapheme>W3C</grapheme>
    <alias>WWW Consortium</alias>
  </lexeme>
  <lexeme> 
    <grapheme>Consortium</grapheme>
    <alias>Community</alias>
  </lexeme>
</lexicon>
```

Le lexique indique trois lexèmes, dont deux d'entre eux définissent un alias pour le graphème W3C comme suit :
+ Le premier élément `<lexeme`> définit un alias (World Wide Web Consortium).
+ Le deuxième `<lexeme>` définit un autre alias (WWW Consortium). 

Amazon Polly utilise le premier remplacement d'un graphème donné dans un lexique.

Le troisième `<lexeme>` définit un remplacement (Community) pour le mot Consortium.

Tout d'abord, nous allons tester ce lexique. Supposons que vous vouliez résumer l'exemple de texte suivant dans un fichier audio (`speech.mp3`), et que vous indiquiez le lexique dans un appel à `SynthesizeSpeech`.

```
The W3C is a Consortium
```

`SynthesizeSpeech` applique d'abord le lexique comme suit : 
+ Pour le premier lexème, le mot W3C est révisé en tant que « World Wide Web Consortium ». Le texte révisé apparaît comme suit :

  ```
  The World Wide Web Consortium is a Consortium
  ```
+ L'alias défini dans le troisième lexème s'applique uniquement au mot Consortium qui faisait partie du texte original, générant le texte suivant :

  ```
  The World Wide Web Consortium is a Community.
  ```

Vous pouvez le tester en utilisant AWS CLI les méthodes suivantes :

1. Enregistrez le lexique sous le nom `example.pls`.

1. Exécutez la commande `put-lexicon` pour stocker le lexique avec le nom « w3c », dans la région us-east-2.

   ```
   aws polly put-lexicon \
   --name w3c \
   --content file://example.pls
   ```

1. Exécutez la commande `list-lexicons` pour vérifier que le lexique « w3c » figure dans la liste des lexiques renvoyés.

   ```
   aws polly list-lexicons
   ```

1. Exécutez la commande `synthesize-speech` pour synthétiser l'exemple de texte dans un fichier audio (`speech.mp3`) et indiquez le paramètre facultatif `lexicon-name`. 

   ```
   aws polly synthesize-speech \
   --text 'W3C is a Consortium' \
   --voice-id Joanna \
   --output-format mp3 \
   --lexicon-names="w3c" \
   speech.mp3
   ```

1. Lisez le fichier `speech.mp3` obtenu pour vérifier que le discours synthétisé reflète les modifications de texte.

Consultez les ressources suivantes pour obtenir des exemples de code supplémentaires pour le fonctionnement de l' PutLexicon API :
+ Exemple Java : [PutLexicon](PutLexiconSample.md)
+ Exemple Python (Boto3) : [PutLexicon](PutLexiconSamplePython.md)

------