> 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/pl/jezyki/13-portuguese.md). # Portugalski ## Wstęp Ten artykuł wyjaśnia, jak składać tekst po portugalsku: jak włączyć poprawne składanie znaków diakrytycznych, takich jak ç, ã, é itp., oraz zapewnić obsługę funkcji specyficznych dla języka, takich jak dzielenie wyrazów. Jeśli szukasz instrukcji, jak używać więcej niż jednego języka w jednym dokumencie, na przykład angielskiego i portugalskiego, zobacz [Obsługa języków międzynarodowych](/latex/pl/jezyki/03-international-language-support.md) artykuł. ## Przykład portugalski z użyciem pdfLaTeX Zaczniemy od następującego przykładu pdfLaTeX, który możesz otworzyć w Overleaf za pomocą łącza poniżej kodu. ```latex \documentclass{article} % \usepackage[utf8]{inputenc} nie jest już wymagane (od 2018 roku) %Ustaw kodowanie czcionki (wyjściowe) %-------------------------------------- \usepackage[T1]{fontenc} %Niepotrzebne w LuaLaTeX ani XeLaTeX %-------------------------------------- %Polecenia specyficzne dla języka portugalskiego %-------------------------------------- \usepackage[portuguese]{babel} %-------------------------------------- %Zasady dzielenia wyrazów %-------------------------------------- \usepackage{hyphenat} \hyphenation{mate-mática recu-perar} %-------------------------------------- \begin{document} \tableofcontents \vspace{2cm} %Dodaj odstęp 2 cm \begin{abstract} To jest krótkie podsumowanie treści dokumentu napisanego po portugalsku. \end{abstract} \section{Sekcja wprowadzająca} To jest pierwsza sekcja, możemy dodać kilka dodatkowych elementów i wszystko zostanie zapisane poprawnie. Ponadto, jeśli słowo jest ścieżką bardzo długą i musi zostać obcięte, babel spróbuje obciąć je poprawnie, w zależności od języka. \section{Druga sekcja} Ta sekcja służy do sprawdzenia, co się dzieje z poleceniami tekstowymi, które definiują \[ \lim x = \theta + 152383.52 \] \end{document} ``` [Otwórz ten przykład pdfLaTeX w 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) Ten przykład generuje następujący wynik: ![OL2port1.png](/files/f27ef01887a5dcd3f8e6f7c63a8f8b9e25239698) ### Pliki tekstowe: liczby całkowite i znaki Każdy plik tekstowy, taki jak plik wejściowy LaTeX `.tex` plik, to nic więcej niż strumień wartości numerycznych (całkowitych), które są używane jako mechanizm do *reprezentowania* znaków tekstu; w konsekwencji przetwarzanie pliku tekstowego obejmuje skanowanie (odczytywanie/przetwarzanie) ciągu wartości całkowitych. Jednak pojawia się ważne pytanie: *który zestaw znaków* jest właściwie reprezentowany przez wartości całkowite zawarte w danym pliku tekstowym? Innymi słowy, w jaki sposób te wartości całkowite zostały *zakodowane*: jakie jest poprawne (zamierzone) „odwzorowanie” (kodowanie) liczb całkowitych w pliku tekstowym na odpowiadające im znaki, które mają one *reprezentowania*? Pliki tekstowe mogą być generowane w niezliczonych środowiskach obliczeniowych: w różnych krajach i na różnych kontynentach, przy użyciu wielu różnych urządzeń, systemów operacyjnych i narzędzi do edycji. Twórcy plików tekstowych mogą potencjalnie używać lub stosować różne kodowania tekstu zgodnie z lokalnymi wymaganiami, takimi jak język, podczas generowania i zapisywania sekwencji wartości całkowitych wybranych do reprezentowania poszczególnych znaków zawartych w pliku tekstowym. Może to działać dobrze, jeśli wygenerowane pliki tekstowe pozostają w zgodnych technicznie ekosystemach, które używają tego samego kodowania, ale co się stanie, gdy pliki te zostaną przeniesione do zupełnie innych środowisk — ponieważ wiele plików tekstowych nie zawiera żadnych informacji wskazujących kodowanie użyte do ich utworzenia. Oczywiste jest, że producent (twórca) i odbiorca (użytkownik) danych tekstowych muszą jakoś uzgodnić używane kodowanie (odwzorowanie), w przeciwnym razie *błędy kodowania* prawdopodobnie pojawią się z powodu niezgodności między danymi całkowitymi w pliku a zestawem znaków, które ma on rzekomo reprezentować. Oprócz poprawnego odwzorowania wartości całkowitych w pliku tekstowym na znaki, jakiekolwiek późniejsze wizualne wyświetlenie tych znaków wymaga pewnej formy czcionki, która jest w stanie dostarczyć dane (kształty, a nawet bitmapy), aby wygenerować wizualną reprezentację pożądanych znaków. ### Kodowanie wejściowe: inputenc, UTF-8 i zmiana w LaTeX z 2018 roku Historycznie do generowania/przetwarzania plików tekstowych, w tym wejść LaTeX, używano różnych 8-bitowych kodowań. Aby skrócić bardzo długą historię, twórcy LaTeX stworzyli pakiet `inputenc` aby rozwiązać problemy z kodowaniem — umożliwiając przesyłanie plików tekstowych utworzonych przy użyciu różnych kodowań między odmiennymi instalacjami LaTeX. Jednak z czasem użytkownicy i twórcy oprogramowania odeszli od wielu 8-bitowych kodowań na rzecz Unicode i schematu kodowania UTF-8, który stał się de facto standardem kodowania plików tekstowych. Przed 2018 rokiem, aby przetwarzać pliki zakodowane w UTF-8, w preambułach dokumentów LaTeX umieszczano wiersz ```latex \usepackage[utf8]{inputenc} ``` Czytelnicy mogą zauważyć, że powyższy przykład nie zawiera wiersza `\usepackage[utf8]{inputenc}` w preambule dokumentu: dlaczego? Wynika to z ważnej zmiany wprowadzonej w LaTeX w 2018 roku: przejścia na UTF-8 jako domyślne *wejściowe* kodowanie. Dokumenty składane za pomocą pdfLaTeX i wykorzystujące tekst zakodowany w UTF-8, w tym tworzone i składane w Overleaf, nie muszą już *muszą* zawierać `\usepackage[utf8]{inputenc}` ale jest [nic nie szkodzi, jeśli to zrobisz](https://www.latex-project.org/news/2018/04/10/issue28-of-latex2e-news-released/). Więcej informacji znajdziesz w [wydaniu LaTeX News z kwietnia 2018 r.](https://www.latex-project.org/news/2018/04/10/issue28-of-latex2e-news-released/) oraz wpisie na blogu Overleaf [*aktualizacja TeX Live — wrzesień 2019*](https://www.overleaf.com/blog/tex-live-upgrade-september-2019). Wszystkie pliki tekstowe tworzone w Overleaf są kodowane w UTF-8. ### Kodowanie wyjściowe: pakiet fontenc Aby poprawnie składać znaki zawarte w plikach wejściowych, należy odwzorować je na odpowiednie *kształty wyjściowe* (glify) zawarte w czcionkach używanych do składu dokumentu. Tym „kodowaniem wyjściowym” zajmuje się inny pakiet o nazwie `fontenc`. Aby użyć `fontenc` umieść w preambule dokumentu następujący wiersz, używając kodowania takiego jak [kodowanie T1](http://mirrors.ctan.org/macros/latex/base/encguide.pdf), które obsługuje znaki z akcentami występujące w językach opartych na alfabecie łacińskim: ```latex \usepackage[T1]{fontenc} ``` Użycie `T1` kodowanie czcionki, poprzez `\usepackage[T1]{fontenc}`, ma też inne zalety: * Domyślne kodowanie czcionki LaTeX OT1 („wyjściowe”) jest 7-bitowe, co oznacza, że może kodować tylko 128 znaków i nie zapewnia dostępu do prawdziwych kształtów znaków z akcentami (glifów) zawartych w czcionkach. Kodowanie `OT1` powoduje, że silniki TeX „udają” znaki z akcentami, składając (łącząc) znak podstawowy z nałożonym i przesuniętym znakiem akcentu. * Jeśli silnik TeX musi uciec się do *tworzenia* znaków z akcentami, ma to konsekwencje dla kopiowania i wklejania tekstu z plików PDF: skopiowanie tekstu zawierającego skonstruowane znaki z akcentami spowoduje *wklejenie dwóch oddzielnych znaków* : znaku podstawowego i znaku akcentu. Użycie `T1` tego kodowania pozwala tego uniknąć. * Użycie `T1` kodowania, aby uzyskać dostęp do prawdziwych znaków z akcentami, poprawia dzielenie wyrazów. ### Kodowanie czcionki T1 w LaTeX Poniższa tabela przedstawia `T1` kodowanie czcionki. Została odtworzona ze strony 22 dokumentu *Kodowania czcionek LaTeX* który jest [dostępny w CTAN](http://mirrors.ctan.org/macros/latex/base/encguide.pdf). ![](/files/e33d597b993b267d0787c8a8594c164f19db5908) ### Przykład kopiowania i wklejania Poniższy minimalny przykład, który nie używa `fontenc`, pokazuje problemy z kopiowaniem i wklejaniem tekstu zawierającego znaki z akcentami. ```latex \documentclass{article} \begin{document} Sekcja wprowadzająca (kodowanie OT1) { \fontencoding{T1}\selectfont Sekcja wprowadzająca (kodowanie T1) } \end{document} ``` [Otwórz ten przykład w 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) Pierwszy fragment tekstu jest składany przy użyciu domyślnego `OT1` kodowania, co skutkuje „fałszywymi” znakami z akcentami. Poniższy fragment kodu LaTeX: ```latex \fontencoding{T1}\selectfont ``` przełącza na używanie `T1` kodowania, co powoduje, że LaTeX składa glify znaków z akcentami. Jeśli skopiujesz tekst z pliku PDF wygenerowanego przez powyższy przykład, powinieneś zobaczyć coś takiego: Sekcja wprowadzająca (kodowanie OT1) Sekcja wprowadzająca (kodowanie T1) Zwróć uwagę, że `OT1` zakodowany tekst nie zawiera rzeczywistych znaków z akcentami, podczas gdy tekst zakodowany za pomocą `T1` takich znaków zawiera. Wynik kopiowania i wklejania może również zależeć od aplikacji używanej do przeglądania pliku PDF, z którego kopiujesz/wklejasz tekst zawierający znaki z akcentami. ## Pakiety i polecenia specyficzne dla języka Aby rozszerzyć domyślne możliwości LaTeX, zapewniając poprawne dzielenie wyrazów i tłumaczenie nazw elementów dokumentu, zaimportuj `babel` pakiet, używając `portugalski` opcji językowej. ```latex \usepackage[portuguese]{babel} ``` Jak możesz zobaczyć w [przykładzie z użyciem pdfLaTeX](#portuguese-example-using-pdflatex), zamiast „Abstract” i „Contents” używane są portugalskie słowa „Resumo” i „Conteúdo”. Jeśli musisz użyć brazylijskiej lokalizacji portugalskiej, użyj `brazilian` zamiast `portugalski` jako parametru języka podczas importowania `babel`. ## Dzielenie wyrazów Ta `babel` pakiet zwykle dobrze radzi sobie z zapewnianiem możliwości dzielenia wyrazów specyficznych dla języka, ale jeśli dane słowo nie dzieli się poprawnie, dostępne są pakiety pomocnicze. Na przykład możesz dodać `hyphenat` pakiet w preambule dokumentu: ```latex \usepackage{hyphenat} \hyphenation{mate-mática recu-perar} ``` Druga linia to lista słów rozdzielonych spacjami z zdefiniowanymi regułami dzielenia wyrazów. Jeśli chcesz uniemożliwić dzielenie konkretnego *słowo*, wpisz `{\nobreak word}` w swoim dokumencie albo umieść je w `\mbox{word}`. ## Dalsza lektura Więcej informacji znajdziesz w * [Obsługa nowoczesnych czcionek w XƎLaTeX](/latex/pl/czcionki/03-xelatex.md) * [Skład cytatów i znaków cudzysłowu](/latex/pl/jezyki/04-typesetting-quotations.md) * [Obsługa języków międzynarodowych](/latex/pl/jezyki/03-international-language-support.md) * [chiński](/latex/pl/jezyki/06-chinese.md) * [francuski](/latex/pl/jezyki/07-french.md) * [niemiecki](/latex/pl/jezyki/08-german.md) * [grecki](/latex/pl/jezyki/09-greek.md) * [włoski](/latex/pl/jezyki/10-italian.md) * [Japoński](/latex/pl/jezyki/11-japanese.md) * [koreański](/latex/pl/jezyki/12-korean.md) * [arabski](/latex/pl/jezyki/05-arabic.md) * [rosyjski](/latex/pl/jezyki/14-russian.md) * [hiszpański](/latex/pl/jezyki/15-spanish.md) * [Niezbyt krótki wstęp do LaTeX2ε](http://www.ctan.org/tex-archive/info/lshort/) * [LaTeX/Internacjonalizacja w WikiBooks](http://en.wikibooks.org/wiki/LaTeX/Internationalization) * [LaTeX/Znaki\_specjalne w 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/pl/jezyki/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.