Échappeur LaTeX

Coller du texte libre dans un document LaTeX est un piège classique : l'esperluette termine une cellule de tableau, le pourcent démarre un commentaire qui avale le reste de la ligne, le dollar ouvre le mode mathématique, le souligné commence un indice, le dièse heurte les paramètres de macros, les accolades changent le groupement, le tilde devient une espace insécable, l'accent circonflexe ouvre un exposant et une barre oblique inverse seule commence une séquence de contrôle. Cet échappeur LaTeX transforme le texte brut en un fragment sûr que vous pouvez déposer dans des paragraphes, légendes, étiquettes et champs bibliographiques, et il inverse la même carte lorsque vous devez récupérer les caractères d'origine. Le mode escape réécrit chaque spécial TeX avec des séquences portables en mode texte telles que \&, \%, \$, \_, \#, \{, \}, \textbackslash{}, \textasciitilde{} et \textasciicircum{}.

Comment les échappements de caractères spéciaux LaTeX fonctionnent en pratique

LaTeX traite un petit ensemble de caractères ASCII comme de la syntaxe plutôt que comme des glyphes imprimables. La barre oblique inverse introduit des séquences de contrôle, de sorte qu'un chemin comme C:\Users ne doit pas apparaître brut en mode texte.

L'esperluette est le séparateur de colonnes dans les environnements tabular et align ; le pourcent démarre un commentaire qui masque tout jusqu'à la fin de la ligne ; le dollar bascule les mathématiques en ligne ; le souligné et le circonflexe marquent indices et exposants ; le dièse désigne les paramètres de macros ; les accolades délimitent les groupes ; et le tilde est un caractère actif pour les espaces insécables.

Lorsque votre chaîne injecte des titres d'utilisateurs, codes produits, noms de fichiers, URL ou cellules CSV dans un modèle .tex, n'importe lequel de ces spéciaux changera le sens du document ou interrompra la compilation. Cette capacité parcourt l'entrée caractère par caractère.

En mode escape elle remplace chaque spécial par une séquence standard en mode texte : les spéciaux simples deviennent une barre plus le caractère (\&, \%, \$, \#, \_, \{, \}), tandis que barre, tilde et circonflexe utilisent des formes nommées avec accolades vides pour que la lettre suivante ne soit jamais absorbée dans un mot de contrôle.

En mode unescape elle fait correspondre d'abord la plus longue séquence connue, restaure le caractère brut et rejette les barres finales, les fragments tronqués de \textbackslash{, les formes courtes incomplètes de \~ ou \^ et tout autre échappement non reconnu, afin que les appelants ne reçoivent jamais de corruption silencieuse.

Ce que vous envoyez et ce que vous recevez

Envoyez un champ chaîne obligatoire nommé text et un champ optionnel mode. Lorsque mode est omis, escape est la valeur par défaut et une seule charge utile reste utile. Le mode escape convertit le texte brut en texte sûr pour LaTeX stocké dans result.

Le mode unescape inverse les séquences connues de caractères spéciaux dans text et renvoie la chaîne brute récupérée dans result. La réponse répète toujours mode et le text d'origine, et ajoute result, length du résultat et specials — le nombre de spéciaux réécrits dans les deux sens — afin que les interfaces montrent le travail effectué. Les échecs de validation ne consomment pas le solde prépayé.

Les contrôles classiques incluent l'échappement d'une ligne de prix contenant dollars, esperluettes et pourcents ; le déséchappement d'un fragment qui utilise \_ et \textbackslash{} ; l'aller-retour d'accolades et de dièses d'un SKU produit ; et le rejet d'une chaîne qui se termine par une barre seule. Branchez le formulaire gratuit du navigateur pour des contrôles rapides et des démonstrations en classe, puis le même contrat depuis des scripts lorsque vous générez rapports, factures ou lots d'articles.

Où un échappeur LaTeX prouve sa valeur

Les générateurs de documents qui fusionnent des champs CRM, des réponses d'enquête ou des cellules de tableur dans des modèles LaTeX doivent échapper chaque valeur de texte libre avant l'écriture, ou une seule esperluette dans un nom d'entreprise cassera le tabular et un pourcent dans une étiquette de remise commentera le reste de la ligne. Les pipelines académiques et éditoriaux qui construisent pages de titre, résumés et listes d'auteurs à partir de formulaires web ont besoin d'un chemin d'échappement fiable pour que les échantillons fournis restent du TeX valide.

Les équipes support et localisation collent des fragments de journaux ou des sujets de tickets qui contiennent déjà des échappements par barre et ont besoin d'un déséchappement qui échoue bruyamment sur les séquences tronquées au lieu d'inventer des caractères. Les auteurs de cursus qui enseignent les spéciaux TeX veulent une page dédiée à l'échappement de caractères plutôt que d'enfouir le sujet sous un outil générique Base64 ou d'entités HTML, car l'intention de recherche et l'ensemble d'échappements autorisé diffèrent.

Si vous avez besoin d'entités HTML, d'encodage pourcent d'URL, de littéraux de chaînes JavaScript ou d'une compilation complète de documents, traitez-les comme des intentions de recherche et des pages d'atterrissage distinctes plutôt que de surcharger cette page d'échappement LaTeX.