> 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/uk/movi/13-portuguese.md).

# Португальська

## Вступ

Ця стаття пояснює, як набирати португальською: увімкнення коректного набору символів із діакритикою, таких як ç, ã, é тощо, а також підтримка мовно-специфічних можливостей, таких як перенос слів. Якщо ви шукаєте інструкції щодо використання більше ніж однієї мови в одному документі, наприклад англійської та португальської, дивіться [Підтримка міжнародних мов](/latex/uk/movi/03-international-language-support.md) статтю.

## Приклад португальської мови з використанням pdfLaTeX

Ми почнемо з наведеного нижче прикладу pdfLaTeX, який можна відкрити в Overleaf за посиланням під кодом.

```latex
\documentclass{article}
% \usepackage[utf8]{inputenc} більше не потрібен (починаючи з 2018 року)

%Встановіть кодування шрифту (виводу)
%--------------------------------------
\usepackage[T1]{fontenc} %Не потрібно для LuaLaTeX або XeLaTeX
%--------------------------------------

%Команди, специфічні для португальської мови
%--------------------------------------
\usepackage[portuguese]{babel}
%--------------------------------------

%Правила переносу
%--------------------------------------
\usepackage{hyphenat}
\hyphenation{mate-mática recu-perar}
%--------------------------------------

\begin{document}
\tableofcontents

\vspace{2cm} %Додайте проміжок 2 см

\begin{abstract}
Це короткий підсумок вмісту документа, написаного португальською мовою.
\end{abstract}

\section{Вступний розділ}
Це перший розділ, ми можемо додати деякі додаткові елементи
і все буде написано правильно. Крім того, якщо слово є шляхом
дуже довгим і його потрібно перенести, babel намагатиметься перенести його правильно,
залежно від мови.

\section{Другий розділ}
Цей розділ призначений для того, щоб побачити, що відбувається з текстовими командами, які визначають

\[ \lim x =  \theta + 152383.52 \]
\end{document}
```

[Відкрийте цей приклад pdfLaTeX в 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)

Цей приклад дає такий результат:

![OL2port1.png](/files/6b6641b025bf1194c8fed0dfad75acececfae18a)

### Текстові файли: цілі числа і символи

Будь-який текстовий файл, такий як вхідний файл LaTeX, `.tex` — це не що інше, як потік числових (цілочисельних) значень, які використовуються як механізм для *представлення* символів тексту; отже, обробка текстового файла передбачає сканування (читання/обробку) послідовності цілочисельних значень. Однак виникає важливе питання: *який набір символів* насправді представлено цілочисельними значеннями, що містяться в певному текстовому файлі? Іншими словами, як ці цілочисельні значення було *закодовано*: яке правильне (задане) «відображення» (кодування) від цілих чисел у текстовому файлі до відповідних символів, які вони мають *представлення*?

Текстові файли можуть створюватися в незліченних обчислювальних середовищах: у різних країнах і на різних континентах, з використанням безлічі різних пристроїв, операційних систем і редакторів. Автори текстових файлів потенційно можуть використовувати або застосовувати різні текстові кодування відповідно до місцевих вимог, наприклад мови, під час створення й зберігання послідовності цілочисельних значень, обраних для представлення окремих символів, що містяться в текстовому файлі. Це може добре працювати, якщо створені текстові файли залишаються в межах сумісних технічних екосистем, які використовують однакове кодування, але що станеться, коли ці файли передаються до зовсім інших середовищ — адже багато текстових файлів не містять жодної інформації, яка вказує на кодування, використане для їх створення.

Очевидно, виробник (автор) і споживач (користувач) текстових даних мають якимось чином домовитися про використовуване кодування (відображення), інакше *помилки кодування* ймовірно виникатимуть через невідповідність між цілочисельними даними у файлі та набором символів, які, як вважається, він представляє. Окрім правильного зіставлення цілочисельних значень текстового файла із символами, будь-яке подальше візуальне відображення цих символів вимагає певної форми шрифту, здатного надати дані (форми або навіть растрові зображення) для виведення візуального представлення потрібних символів.

### Кодування введення: inputenc, UTF-8 і зміни в LaTeX у 2018 році

Історично для створення/обробки текстових файлів, зокрема вхідних файлів LaTeX, використовували різні 8-бітні кодування. Якщо скоротити дуже довгу історію, розробники LaTeX створили `inputenc` пакет для розв'язання проблем кодування — він давав змогу текстовим файлам, створеним із використанням різних кодувань, передаватися між різними інсталяціями LaTeX.

Однак із часом користувачі та розробники програмного забезпечення відійшли від множинних 8-бітних кодувань і перейшли до використання Unicode та його схеми кодування UTF-8, яка стала де-факто варіантом для кодування текстових файлів. До 2018 року для обробки файлів, закодованих у UTF-8, преамбули документів LaTeX містили рядок

```latex
\usepackage[utf8]{inputenc}
```

Читачі можуть помітити, що наведений вище приклад не містить рядка `\usepackage[utf8]{inputenc}` у преамбулі документа: чому так? Це пов’язано з важливою зміною в LaTeX, запровадженою у 2018 році: переходом на UTF-8 як стандартне *вхідне* кодування. Документи, набрані за допомогою pdfLaTeX і з використанням тексту, закодованого в UTF-8, зокрема створені та набрані в Overleaf, більше не *не потрібно* потрібно включати `\usepackage[utf8]{inputenc}` але це [не заважає це зробити](https://www.latex-project.org/news/2018/04/10/issue28-of-latex2e-news-released/). Для додаткової інформації дивіться [випуск LaTeX News за квітень 2018 року](https://www.latex-project.org/news/2018/04/10/issue28-of-latex2e-news-released/) та допис у блозі Overleaf [*Оновлення TeX Live — вересень 2019*](https://www.overleaf.com/blog/tex-live-upgrade-september-2019). Усі текстові файли, створені в Overleaf, кодуються з використанням UTF-8.

### Кодування виводу: пакет fontenc

Щоб правильно набирати символи, що містяться у вхідних файлах, ці символи потрібно зіставити з відповідними *формами виводу* (ґліфами), що містяться у шрифтах, які використовуються для набору документа. Цим «кодуванням виводу» керує інший пакет під назвою `fontenc`.

Щоб використовувати `fontenc` додайте наступний рядок до преамбули вашого документа, використовуючи кодування, наприклад [кодування T1](http://mirrors.ctan.org/macros/latex/base/encguide.pdf), яке підтримує символи з діакритиками, що містяться в мовах на основі латиниці:

```latex
\usepackage[T1]{fontenc}
```

Використання `T1` кодування шрифту через `\usepackage[T1]{fontenc}`, має й інші переваги:

* Типове кодування шрифту LaTeX OT1 («вивід») є 7-бітним, тобто може кодувати лише 128 символів і не надає (не вмикає) доступу до справжніх форм символів із діакритиками (ґліфів), що містяться у шрифтах. Кодування `OT1` призводить до того, що рушії TeX «імітують» символи з діакритиками, набираючи (поєднуючи) базовий символ із накладеним і зміщеним символом наголосу.
* Якщо рушію TeX доводиться вдатися до *створення* символів з діакритиками, це має наслідки для копіювання/вставлення тексту з PDF: копіювання тексту, що містить створені символи з діакритиками, призведе до *двох окремих символів* під час вставлення: базового символу та символу наголосу. Використання `T1` кодування дозволяє уникнути цього.
* Використання `T1` кодування, щоб отримати доступ до справжніх символів із діакритиками, покращує перенос слів.

### Кодування шрифту LaTeX T1

Наведена нижче таблиця перелічує `T1` кодування шрифту. Вона відтворена зі сторінки 22 документа *Кодування шрифтів LaTeX* який [доступний на CTAN](http://mirrors.ctan.org/macros/latex/base/encguide.pdf).

![](/files/72af73ac8f14ac6dec8c5c3c7881805eeae30ab9)

### Приклад копіювання та вставлення

Наведений нижче мінімальний приклад, який не використовує `fontenc`, демонструє проблеми з копіюванням/вставленням тексту, що містить символи з діакритиками.

```latex
\documentclass{article}
\begin{document}
Вступний розділ (кодування OT1)

{
\fontencoding{T1}\selectfont Вступний розділ (кодування T1)
}
\end{document}
```

[Відкрити цей приклад в 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)

Перший фрагмент тексту набрано з використанням стандартного кодування `OT1` , унаслідок чого символи з діакритиками є «фальшивими». Наступний фрагмент коду LaTeX:

```latex
\fontencoding{T1}\selectfont
```

перемикає використання `T1` кодування, унаслідок чого LaTeX набирає ґліфи символів із діакритиками. Якщо ви скопіюєте текст із PDF, створеного за наведеним вище прикладом, ви повинні побачити щось на кшталт цього:

Вступний розділ (кодування OT1) Вступний розділ (кодування T1)

Зверніть увагу, що `OT1` закодований текст не містить справжніх символів з діакритиками, тоді як текст, закодований за допомогою `T1` їх містить. Результат копіювання/вставлення також може залежати від програми, яку використовують для перегляду PDF, з якого ви копіюєте/вставляєте текст із символами з діакритиками.

## Пакети та команди, специфічні для мови

Щоб розширити стандартні можливості LaTeX, забезпечивши належний перенос слів і переклад назв елементів документа, імпортуйте `babel` пакет, використовуючи `portuguese` опцію мови.

```latex
\usepackage[portuguese]{babel}
```

Як ви можете бачити у [прикладі з pdfLaTeX](#portuguese-example-using-pdflatex), замість «Abstract» і «Contents» використовуються португальські слова «Resumo» і «Conteúdo».

Якщо вам потрібно використовувати локалізацію бразильської португальської, використовуйте `brazilian` замість `portuguese` як параметр мови під час імпорту `babel`.

## Перенесення слів

Функція `babel` пакет зазвичай добре справляється з наданням можливостей переносу, специфічних для мови, але якщо певне слово переноситься неправильно, є пакети для допомоги. Наприклад, ви можете додати пакет `hyphenat` до преамбули:

```latex
 \usepackage{hyphenat}
 \hyphenation{mate-mática recu-perar}
```

Другий рядок — це список слів, розділених пробілами, з визначеними правилами переносу. Якщо ви хочете запобігти переносу певного *слово*, напишіть `{\nobreak word}` у своєму документі або включіть його до `\mbox{word}`.

## Додаткове читання

Для отримання додаткової інформації див.

* [Підтримка сучасних шрифтів із XƎLaTeX](/latex/uk/shrifti/03-xelatex.md)
* [Набір лапок і знаків лапок](/latex/uk/movi/04-typesetting-quotations.md)
* [Підтримка міжнародних мов](/latex/uk/movi/03-international-language-support.md)
* [Китайська](/latex/uk/movi/06-chinese.md)
* [Французька](/latex/uk/movi/07-french.md)
* [Німецька](/latex/uk/movi/08-german.md)
* [Грецька](/latex/uk/movi/09-greek.md)
* [Італійська](/latex/uk/movi/10-italian.md)
* [Японська](/latex/uk/movi/11-japanese.md)
* [корейська](/latex/uk/movi/12-korean.md)
* [Арабська](/latex/uk/movi/05-arabic.md)
* [Російська](/latex/uk/movi/14-russian.md)
* [Іспанська](/latex/uk/movi/15-spanish.md)
* [Не зовсім короткий вступ до LaTeX2ε](http://www.ctan.org/tex-archive/info/lshort/)
* [LaTeX/Інтернаціоналізація на WikiBooks](http://en.wikibooks.org/wiki/LaTeX/Internationalization)
* [LaTeX/Спеціальні\_символи на 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/uk/movi/13-portuguese.md?ask=<question>&goal=<endgoal>
```

`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.
