> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/fr/langues/13-portuguese.md). # Portugais ## Introduction Cet article explique comment composer le portugais : en permettant la composition correcte des caractères accentués, tels que ç, ã, é, etc., et en offrant une prise en charge de fonctionnalités propres à la langue, comme la césure. Si vous cherchez des instructions sur la façon d'utiliser plus d'une langue dans un seul document, par exemple l'anglais et le portugais, voir le [Prise en charge des langues internationales](/latex/fr/langues/03-international-language-support.md) article. ## Exemple en portugais utilisant pdfLaTeX Nous commencerons par l’exemple pdfLaTeX suivant, que vous pouvez ouvrir dans Overleaf en utilisant le lien sous le code. ```latex \documentclass{article} % \usepackage[utf8]{inputenc} n'est plus nécessaire (depuis 2018) %Définir l’encodage de police (sortie) %-------------------------------------- \usepackage[T1]{fontenc} %Pas nécessaire avec LuaLaTeX ou XeLaTeX %-------------------------------------- %Commandes spécifiques au portugais %-------------------------------------- \usepackage[portuguese]{babel} %-------------------------------------- %Règles de césure %-------------------------------------- \usepackage{hyphenat} \hyphenation{mate-mática recu-perar} %-------------------------------------- \begin{document} \tableofcontents \vspace{2cm} %Ajouter un espace de 2 cm \begin{abstract} Ceci est un bref résumé du contenu du document rédigé en portugais. \end{abstract} \section{Section d'introduction} C'est la première section, nous pouvons ajouter quelques éléments supplémentaires et tout sera écrit correctement. De plus, si un mot est un chemin très long et doit être tronqué, babel essaiera de le tronquer correctement, selon la langue. \section{Deuxième section} Cette section sert à voir ce qui se passe avec des commandes de texte qui définissent \[ \lim x = \theta + 152383.52 \] \end{document} ``` [Ouvrez cet exemple pdfLaTeX dans Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Sample+document+in+Portuguese\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+%5Cusepackage%5Butf8%5D%7Binputenc%7D+is+no+longer+required+%28since+2018%29%0A%0A%25Set+the+font+%28output%29+encoding%0A%25--------------------------------------%0A%5Cusepackage%5BT1%5D%7Bfontenc%7D+%25Not+needed+by+LuaLaTeX+or+XeLaTeX%0A%25--------------------------------------%0A%0A%25Portuguese-specific+commands%0A%25--------------------------------------%0A%5Cusepackage%5Bportuguese%5D%7Bbabel%7D%0A%25--------------------------------------%0A%0A%25Hyphenation+rules%0A%25--------------------------------------%0A%5Cusepackage%7Bhyphenat%7D%0A%5Chyphenation%7Bmate-m%C3%A1tica+recu-perar%7D%0A%25--------------------------------------%0A%0A%5Cbegin%7Bdocument%7D%0A%5Ctableofcontents%0A%0A%5Cvspace%7B2cm%7D+%25Add+a+2cm+space%0A%0A%5Cbegin%7Babstract%7D%0AEste+%C3%A9+um+breve+resumo+do+conte%C3%BAdo+do+documento+escrito+em+Portugu%C3%AAs.%0A%5Cend%7Babstract%7D%0A%0A%5Csection%7BSe%C3%A7%C3%A3o+introdut%C3%B3ria%7D%0AEsta+%C3%A9+a+primeira+se%C3%A7%C3%A3o%2C+podemos+acrescentar+alguns+elementos+adicionais+%0Ae+tudo+ser%C3%A1+escrito+corretamente.+Al%C3%A9m+disso%2C+se+uma+palavra+%C3%A9+um+caminho+%0Amuito+longo+e+tem+de+ser+truncado%2C+babel+ir%C3%A1+tentar+truncar+corretamente%2C+%0Adependendo+do+idioma.%0A%0A%5Csection%7BSegunda+se%C3%A7%C3%A3o%7D%0AEsta+se%C3%A7%C3%A3o+%C3%A9+para+ver+o+que+acontece+com+comandos+de+texto+que+definem%0A%0A%5C%5B+%5Clim+x+%3D++%5Ctheta+%2B+152383.52+%5C%5D%0A%5Cend%7Bdocument%7D) Cet exemple produit le résultat suivant : ![OL2port1.png](/files/6fc178746275eca0a6e2e472c8dc7845324f311c) ### Fichiers texte : entiers et caractères Tout fichier texte, comme une entrée LaTeX `.tex` fichier, n'est rien de plus qu'un flux de valeurs numériques (entières) qui sont utilisées comme mécanisme pour *représenter* les caractères du texte ; par conséquent, le traitement d'un fichier texte implique l'analyse (lecture/traitement) d'une série de valeurs entières. Cependant, une question importante se pose : *quel ensemble de caractères* est en réalité représenté par les valeurs entières contenues dans un fichier texte particulier ? En d'autres termes, comment ces valeurs entières ont-elles été *codées*: quel est le « mappage » (encodage) correct, voulu, des entiers du fichier texte vers les caractères correspondants qu'ils sont censés *représenter*? Les fichiers texte peuvent être générés dans d'innombrables environnements informatiques : dans différents pays/continents, à l'aide d'une multitude d'appareils, de systèmes d'exploitation et d'outils d'édition différents. Les auteurs de fichiers texte pourraient, potentiellement, utiliser ou appliquer différents encodages de texte selon les exigences locales, comme la langue, lors de la génération et du stockage de la séquence de valeurs entières choisies pour représenter les caractères individuels contenus dans un fichier texte. Cela peut bien fonctionner si les fichiers texte générés restent dans des écosystèmes techniques compatibles, qui utilisent le même encodage, mais que se passerait-il lorsque ces fichiers sont transférés vers des environnements complètement différents — puisque de nombreux fichiers texte ne contiennent aucune information indiquant l'encodage utilisé pour les générer. De toute évidence, le producteur (auteur) et le consommateur (utilisateur) des données textuelles doivent, d'une manière ou d'une autre, se mettre d'accord sur l'encodage (le mappage) utilisé ; sinon *des erreurs d'encodage* sont susceptibles d'apparaître en raison de décalages entre les données entières du fichier et l'ensemble des caractères qu'il est censé représenter. En plus de mapper correctement les valeurs entières du fichier texte aux caractères, tout affichage visuel ultérieur de ces caractères nécessite une forme de police capable de fournir les données (formes, voire bitmaps) pour produire une représentation visuelle des caractères souhaités. ### Encodage en entrée : inputenc, UTF-8 et un changement apporté à LaTeX en 2018 Historiquement, diverses encodages sur 8 bits ont été utilisés pour générer/traiter des fichiers texte, y compris des entrées LaTeX. Pour résumer une très longue histoire, les développeurs de LaTeX ont créé le `inputenc` package afin de résoudre les problèmes d'encodage — permettant aux fichiers texte, créés avec différents encodages, d'être transférés entre différentes installations LaTeX. Cependant, avec le temps, les utilisateurs/développeurs de logiciels sont passés de multiples encodages 8 bits à Unicode et à son schéma d'encodage UTF-8, qui est devenu l'option de fait pour l'encodage des fichiers texte. Avant 2018, pour traiter des fichiers encodés en UTF-8, les préambules des documents LaTeX incluaient la ligne ```latex \usepackage[utf8]{inputenc} ``` Les lecteurs pourraient remarquer que l'exemple ci-dessus n'inclut pas la ligne `\usepackage[utf8]{inputenc}` dans le préambule du document : pourquoi cela ? Cela est dû à un changement important apporté à LaTeX en 2018 : le passage à UTF-8 comme *encodage* d'entrée par défaut. Les documents composés avec pdfLaTeX et utilisant du texte encodé en UTF-8, y compris ceux créés et composés sur Overleaf, n'ont plus *besoin* d'inclure `\usepackage[utf8]{inputenc}` mais cela [ne fait pas de mal de le faire](https://www.latex-project.org/news/2018/04/10/issue28-of-latex2e-news-released/). Pour plus d'informations, consultez le [numéro d'avril 2018 de LaTeX News](https://www.latex-project.org/news/2018/04/10/issue28-of-latex2e-news-released/) et l'article de blog Overleaf [*Mise à niveau de TeX Live — septembre 2019*](https://www.overleaf.com/blog/tex-live-upgrade-september-2019). Tous les fichiers texte créés sur Overleaf sont encodés en UTF-8. ### Encodage de sortie : le package fontenc Pour composer correctement les caractères contenus dans les fichiers d'entrée, ces caractères doivent être mappés vers les *formes de sortie* (glyphes) appropriées contenues dans les polices utilisées pour composer le document. Cet « encodage de sortie » est géré par un autre package appelé `fontenc`. Pour utiliser `fontenc` incluez la ligne suivante dans le préambule de votre document, en utilisant un encodage tel que le [Encodage T1](http://mirrors.ctan.org/macros/latex/base/encguide.pdf), qui prend en charge les caractères accentués contenus dans les langues basées sur le latin : ```latex \usepackage[T1]{fontenc} ``` L'utilisation de la feuille de style `T1` d’encodage de police, via `\usepackage[T1]{fontenc}`, présente d’autres avantages : * L’encodage par défaut de police (« sortie ») OT1 de LaTeX est sur 7 bits, ce qui signifie qu’il ne peut coder que 128 caractères et ne comprend pas (n’autorise pas l’accès à) les véritables formes de caractères accentués (glyphes) contenues dans les polices. L’encodage `OT1` entraîne les moteurs TeX à « simuler » les caractères accentués en composant (en combinant) un caractère de base avec un caractère accentué superposé et décalé. * Si le moteur TeX doit recourir à la *construction* des caractères accentués, cela a des implications pour le copier/coller de texte depuis des PDF : copier du texte contenant des caractères accentués construits entraînera le collage de *deux caractères distincts* : le caractère de base et le caractère accentué. L’utilisation de l’ `T1` encodage évite cela. * L'utilisation de la feuille de style `T1` encodage, pour accéder aux véritables caractères accentués, améliore la césure. ### Encodage de police T1 de LaTeX Le tableau suivant répertorie l' `T1` encodage de police. Il est reproduit à partir de la page 22 du document *Encodages de police LaTeX* qui est [disponible sur CTAN](http://mirrors.ctan.org/macros/latex/base/encguide.pdf). ![](/files/68cea279ee71e9e1e1fafc0c443fd52af17a6bc5) ### Exemple de copier-coller L’exemple minimal suivant, qui n’utilise pas `fontenc`, montre les problèmes de copier/coller du texte contenant des caractères accentués. ```latex \documentclass{article} \begin{document} Section d'introduction (codage OT1) { \fontencoding{T1}\selectfont Section d'introduction (codage T1) } \end{document} ``` [Ouvrez cet exemple dans Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Demonstrating+copy+and+paste+with+font+encodings\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0ASe%C3%A7%C3%A3o+introdut%C3%B3ria+%28OT1+encoding%29%0A%0A%7B%0A%5Cfontencoding%7BT1%7D%5Cselectfont+Se%C3%A7%C3%A3o+introdut%C3%B3ria+%28T1+encoding%29%0A%7D%0A%5Cend%7Bdocument%7D) La première partie du texte est composée en utilisant l’ `OT1` encodage par défaut de LaTeX, ce qui produit des caractères accentués « faux ». Le morceau de code LaTeX suivant : ```latex \fontencoding{T1}\selectfont ``` bascule vers l’utilisation de l’ `T1` encodage, ce qui amène LaTeX à composer des glyphes de caractères accentués. Si vous copiez le texte du PDF produit par l’exemple ci-dessus, vous devriez voir quelque chose comme ceci : Section d'introduction (codage OT1) Section d'introduction (codage T1) Remarquez comment le texte encodé `OT1` ne contient pas de véritables caractères accentués, tandis que le texte encodé avec `T1` en contient bien. Le résultat du copier/coller peut aussi dépendre de l’application utilisée pour afficher le PDF depuis lequel vous copiez/collez du texte contenant des caractères accentués. ## Packages et commandes spécifiques à la langue Pour étendre les capacités par défaut de LaTeX, en fournissant une césure correcte et la traduction des noms des éléments du document, importez le `paquets babel` package à l’aide de l’ `portuguese` option de langue. ```latex \usepackage[portuguese]{babel} ``` Comme vous pouvez le voir dans le [l’exemple utilisant pdfLaTeX](#portuguese-example-using-pdflatex), au lieu de « Abstract » et « Contents », on utilise les mots portugais « Resumo » et « Conteúdo ». Si vous devez utiliser la localisation du portugais brésilien, utilisez `brazilian` à la place de `portuguese` comme paramètre de langue lors de l'importation de `paquets babel`. ## Césure Le `paquets babel` package fait généralement du bon travail pour fournir des capacités de césure propres à la langue, mais si un mot particulier n’est pas coupé correctement, il existe des packages pour aider. Par exemple, vous pouvez ajouter le `hyphenat` package dans votre préambule : ```latex \usepackage{hyphenat} \hyphenation{mate-mática recu-perar} ``` La deuxième ligne est une liste de mots séparés par des espaces avec des règles de césure définies. Si vous voulez empêcher la césure d'un mot spécifique *mot*, écrivez `{\nobreak word}` dans votre document, ou incluez-le dans un `\mbox{mot}`. ## Lectures complémentaires Pour plus d'informations, voir * [Prise en charge des polices modernes avec XƎLaTeX](/latex/fr/polices/03-xelatex.md) * [Composition des citations et des guillemets](/latex/fr/langues/04-typesetting-quotations.md) * [Prise en charge des langues internationales](/latex/fr/langues/03-international-language-support.md) * [Chinois](/latex/fr/langues/06-chinese.md) * [Français](/latex/fr/langues/07-french.md) * [Allemand](/latex/fr/langues/08-german.md) * [Grec](/latex/fr/langues/09-greek.md) * [Italien](/latex/fr/langues/10-italian.md) * [Japonais](/latex/fr/langues/11-japanese.md) * [Coréen](/latex/fr/langues/12-korean.md) * [Arabe](/latex/fr/langues/05-arabic.md) * [Russe](/latex/fr/langues/14-russian.md) * [Espagnol](/latex/fr/langues/15-spanish.md) * [L'introduction pas si courte à LaTeX2ε](http://www.ctan.org/tex-archive/info/lshort/) * [LaTeX/Internationalisation sur WikiBooks](http://en.wikibooks.org/wiki/LaTeX/Internationalization) * [LaTeX/Caractères spéciaux sur WikiBooks](http://en.wikibooks.org/wiki/LaTeX/Special_Characters) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/fr/langues/13-portuguese.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.