Caractères réservés dans SSML

Il existe cinq caractères prédéfinis qui ne peuvent normalement pas être utilisés dans une instruction SSML. Ces entités sont réservées par la spécification de langage. Ces caractères sont

Nom	Caractère	Code d’échappement
guillemets (guillemets doubles)	"	"
esperluette	&	&
apostrophe ou guillemet simple	'	'
signe inférieur à	<	&lt;
signe supérieur à	>	&gt;

SSML utilisant ces caractères dans le cadre de son code, vous devez les échapper lorsque vous les utilisez dans SSML. Vous utilisez le code d'échappement au lieu du caractère réel pour qu'il s'affiche correctement tout en créant un document SSML valide. Par exemple, la séquence suivante

We're using the lawyer at Peabody & Chambers, attorneys-at-law.

serait rendue dans SSML sous la forme

<speak>
We&apos;re using the lawyer at Peabody &amp; Chambers, attorneys-at-law.
</speak>

Dans ce cas, les caractères spéciaux de l'apostrophe et de l'esperluette sont échappés afin que le document SSML reste valide.

Pour les symboles &, <, et > les codes d'échappement sont toujours nécessaires lorsque vous utilisez SSML. De plus, lorsque vous utilisez l'apostrophe (guillemet simple) (') comme apostrophe, vous devez également utiliser le code d'échappement.

Toutefois, lorsque vous utilisez les guillemets doubles (") ou l'apostrophe (guillemet simple) (') comme guillemets, le fait d'utiliser ou non le code d'échappement dépend du contexte.

Guillemets doubles

• Doivent être échappés lorsqu’ils sont intégrés à une valeur d'attribut délimitée par des guillemets doubles. Par exemple, dans le AWS CLI code suivant

  --text "Pete "Maverick" Mitchell"

• Ne nécessitent pas d’être échappés lorsqu’ils sont utilisés dans un contexte textuel. Par exemple, dans

  He said, "Turn right at the corner."

• Doivent être échappés lorsqu’ils sont intégrés à une valeur d'attribut délimitée par des guillemets simples. Par exemple, dans le AWS CLI code suivant

  --text 'Pete "Maverick" Mitchell'

Apostrophes (guillemets simples)

• Doivent être échappées lorsqu'elles sont utilisées comme apostrophes. Par exemple, dans

  We've got to leave quickly.

• Ne nécessitent pas d’être échappés lorsqu’ils sont utilisés dans un contexte textuel. Par exemple, dans

  "And then I said, 'Don't quote me.'"

• Ne nécessitent pas d’être échappées lorsqu’elles sont utilisées dans un attribut de code délimité par des guillemets doubles. Par exemple, dans le AWS CLI code suivant

  --text "Pete 'Maverick' Mitchell"