> 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/czcionki/03-xelatex.md). # Obsługa nowoczesnych czcionek w XƎLaTeX ## Wstęp [XeTeX](https://tug.org/xetex/) jest silnikiem składu typograficznego wywodzącym się z oryginalnego oprogramowania TeX autorstwa Donalda Knutha. Jednak w przeciwieństwie do oryginalnego programu Knutha, XeTeX natywnie odczytuje (przyjmuje jako dane wejściowe) tekst Unicode zakodowany w UTF-8 i, z pomocą wbudowanego [HarfBuzz](https://harfbuzz.github.io/) silnika kształtowania, obsługuje nowoczesne formaty czcionek, takie jak [OpenType (OTF)](https://docs.microsoft.com/en-us/typography/opentype/) i [technologia czcionek Graphite firmy SIL](https://scripts.sil.org/cms/scripts/page.php?site_id=projects\&item_id=graphite_home). Odpowiedni kompilator LaTeX [kompilator](/latex/pl/wiecej-tematow/08-choosing-a-latex-compiler.md) w Overleaf nazywa się `xelatex`. Każdy, kto chce lepiej zrozumieć ewolucję różnych silników TeX, może przeczytać artykuł Overleaf [Co kryje się w nazwie: przewodnik po wielu odmianach TeX-a](/latex/pl/artykuly-szczegolowe/55-what-s-in-a-name-a-guide-to-the-many-flavours-of-tex.md). ## Podstawy: Times New Roman Times New Roman to często używana czcionka, a oto przykład jej użycia w Overleaf za pośrednictwem kompilatora XeLaTeX. W tym przykładzie czcionka dokumentu jest ustawiana za pomocą `\usemainfont{Times New Roman}`, gdzie polecenie `\usemainfont{...}` jest udostępniane przez pakiet `fontspec`. ```latex \documentclass[12pt]{article} \usepackage{fontspec} \setmainfont{Times New Roman} \title{Sample font document} \author{Overleaf} \date{\today} \begin{document} \maketitle To jest \textit{przykład} dokumentu skompilowanego za pomocą \textbf{XeLaTeX}. LuaLaTeX też powinien działać. \end{document} ``` [Otwórz przykład Times New Roman z użyciem XeLaTeX w Overleaf](https://www.overleaf.com/docs?engine=xelatex\&snip_name=Times+New+Roman+%28via+XeLaTeX%29\&snip=%5Cdocumentclass%5B12pt%5D%7Barticle%7D%0A%5Cusepackage%7Bfontspec%7D%0A+%0A%5Csetmainfont%7BTimes+New+Roman%7D%0A%5Ctitle%7BSample+font+document%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A+++%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A+++++%0AThis+is+an+%5Ctextit%7Bexample%7D+of+a+document+compiled+%0Awith+%5Ctextbf%7BXeLaTeX%7D.+LuaLaTeX+should+also+work+too.%0A%0A%5Cend%7Bdocument%7D) Ten przykład generuje następujący wynik: ![XeLaTeXOverleaf.png](/files/b763d13dc4f5b1d0f316e4ed6ba19a21bfa4ed37) Możesz także [użyć LuaLaTeX do uruchomienia tego samego kodu](https://www.overleaf.com/docs?engine=lualatex\&snip_name=Times+New+Roman+%28via+LuaLaTeX%29\&snip=%5Cdocumentclass%5B12pt%5D%7Barticle%7D%0A%5Cusepackage%7Bfontspec%7D%0A+%0A%5Csetmainfont%7BTimes+New+Roman%7D%0A%5Ctitle%7BSample+font+document%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A+++%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A+++++%0AThis+is+an+%5Ctextit%7Bexample%7D+of+a+document+compiled+%0Awith+%5Ctextbf%7BLuaLaTeX%7D.%0A%0A%5Cend%7Bdocument%7D) . ## Ustawianie czcionek dla różnych elementów LaTeX-a Różne elementy w dokumencie LaTeX są formatowane różnymi czcionkami; na przykład w `verbatim` środowisku tekst jest wyświetlany czcionką o stałej szerokości. Dla każdego kontekstu można ustawić różne style czcionek: ```latex \documentclass[12pt]{article} \usepackage{fontspec} %----------------------------------------------------------------------- \setmainfont{Times New Roman} \setsansfont{Arial} \setmonofont[Color={0019D4}]{Courier New} %----------------------------------------------------------------------- \title{Sample font document} \author{Overleaf} \date{\today} \begin{document} \maketitle To jest \textit{przykład} dokumentu skompilowanego za pomocą \textbf{XeLaTeX}. Jeśli musisz napisać trochę kodu, możesz użyć środowiska \texttt{verbatim}: \begin{verbatim} Zwykle to środowisko służy do wyświetlania kodu, więc oto prosty program w C. #include #define NUMYAYS 10 int main() { int i; for (i = 0; i <= NUMYAYS; i++) { printf("Yay! Overleaf is Awesome!\n"); } return 0; } \end{verbatim} {\sffamily To jest przykładowy tekst w \textbf{kroju pisma bezszeryfowego}} \end{document} ``` [Aby zobaczyć wynik, otwórz ten przykład XeLaTeX w Overleaf](https://www.overleaf.com/docs?engine=xelatex\&snip_name=Document+formatted+with+different+fonts\&snip=%5Cdocumentclass%5B12pt%5D%7Barticle%7D%0A%5Cusepackage%7Bfontspec%7D%0A%0A%25-----------------------------------------------------------------------%0A%5Csetmainfont%7BTimes+New+Roman%7D%0A%5Csetsansfont%7BArial%7D%0A%5Csetmonofont%5BColor%3D%7B0019D4%7D%5D%7BCourier+New%7D%0A%25-----------------------------------------------------------------------%0A%0A%5Ctitle%7BSample+font+document%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A%5Cbegin%7Bdocument%7D%0A++++%0A%5Cmaketitle%0A+++++%0AThis+an+%5Ctextit%7Bexample%7D+of+document+compiled+with+the++%0A%5Ctextbf%7BXeLaTeX%7D+compiler.+If+you+have+to+write+some+code+you+can+%0Ause+the+%5Ctexttt%7Bverbatim%7D+environment%3A%0A%0A++++%5Cbegin%7Bverbatim%7D%0A++++Usually+this+environment+is+used+to+display+code%2C+%0A++++so+here%27s+a+simple+C+program.%0A%0A++++%23include+%3Cstdio.h%3E%0A++++%23define+NUMYAYS+10%0A++++++%0A++++int+main%28%29%0A++++%7B%0A++++++++int+i%3B+++%0A++++++++for+%28i+%3D+0%3B+i+%3C%3D+NUMYAYS%3B+i%2B%2B%29+%0A++++++++%7B%0A++++++++++++printf%28%22Yay%21+Overleaf+is+Awesome%21%5Cn%22%29%3B%0A++++++++%7D%0A++++++++return+0%3B%0A++++%7D%0A++++%5Cend%7Bverbatim%7D%0A++++%7B%5Csffamily+This+is+a+sample+text+in+%5Ctextbf%7BSans+Serif+Font+Typeface%7D%7D%0A+++++++%0A%5Cend%7Bdocument%7D) W poprzednim przykładzie użyto trzech różnych czcionek, a następne wiersze określają elementy, które będą korzystać z tych czcionek: **\setmainfont{Times New Roman}** To jest czcionka normalna używana w większości dokumentu, w przykładzie Times New Roman. **\setsansfont{Arial}** Elementy wymagające czcionki bezszeryfowej, wyraźnie zadeklarowane przez \ssfamily w przykładzie, zostaną złożone czcionką Arial. **\setmonofont{Courier New}** Wszystko, co ma być sformatowane czcionką monospacjową (jak w maszynie do pisania), będzie używać czcionki Courier New. To polecenie ma dodatkowy opcjonalny parametr wewnątrz nawiasów klamrowych: **Color={0019D4}** To ustawia kolor tekstu, używając wartości Color= w szesnastkowym formacie HTML. Selektywne i ostrożne użycie koloru tekstu może być przydatne podczas tworzenia prezentacji. ## Czcionki w Overleaf Jest [duża liczba czcionek zainstalowanych w Overleaf](/latex/pl/pytania-i-odpowiedzi/85-which-otf-or-ttf-fonts-are-supported-via-fontspec.md) których możesz użyć w swoim projekcie, najłatwiej za pomocą `fontspec`. Poniższe przykłady pokazują użycie czcionek zawartych na serwerach Overleaf, takich jak Google Noto, wraz z czcionkami, które musisz przesłać z [Google Fonts](https://fonts.google.com/). ### Czcionki zainstalowane na serwerach Overleaf: czcionki Google Noto Ponieważ [TeX Live](https://www.tug.org/texlive/)—używany przez Overleaf—zawiera [czcionki Google Noto](https://www.google.com/get/noto/) możesz ich używać za pośrednictwem `fontspec` pakietu, w projektach Overleaf kompilowanych za pomocą kompilatorów XeLaTeX lub LuaLaTeX. Oto przykładowy projekt, który używa [`noto` pakietu](https://ctan.org/pkg/noto?lang=en) do skonfigurowania dokumentu do składu z rodzinami czcionek NotoSerif, NotoSans i NotoSansMono. Dokumentację pakietu `noto` można znaleźć w jego [pliku readme na CTAN](http://mirrors.ctan.org/fonts/noto/README). ```latex \documentclass{article} \usepackage{xcolor} \usepackage{noto} \usepackage{hyperref} \title{Używanie czcionek Google Noto} \author{Overleaf} \date{Kwiecień 2021} \begin{document} \maketitle \section{Wprowadzenie} Ten przykładowy projekt używa pakietu \href{https://ctan.org/pkg/noto?lang=en}{\color{blue}\texttt{noto}}, aby złożyć dokument przy użyciu czcionek Noto firmy Google\footnote{\url{https://www.google.com/get/noto/}}: \begin{itemize} \item \verb|\textbf{bold}| daje \textbf{pogrubienie} \item \verb|\textit{italic}| daje \textit{kursywę} \item \verb|\textbf{\textit{bold italic}}| daje \textbf{\textit{pogrubioną kursywę}} \item \verb|\emph{emphasis}| daje \emph{wyróżnienie} \item \verb|\textbf{\emph{bold italic}}| daje \textbf{\emph{pogrubioną kursywę}} \end{itemize} \subsection{Czcionki o stałej szerokości} Możesz używać czcionek o stałej szerokości Noto dla tekstu \texttt{zwykłego} i \texttt{\textbf{pogrubionego}}. \subsection{Czcionki bezszeryfowe} Oto trochę \textsf{tekstu złożonego czcionką bezszeryfową} wraz z \textbf{\textsf{tekstem złożonym pogrubioną czcionką bezszeryfową}}. \section{Dalsza lektura} Dokumentację pakietu \texttt{noto} można znaleźć w jego pliku \href{http://mirrors.ctan.org/fonts/noto/README}{\color{blue}\texttt{readme} na CTAN}. \end{document} ``` [Otwórz ten przykład XeLaTeX w Overleaf, aby poznać czcionki Noto](https://www.overleaf.com/docs?engine=xelatex\&snip_name=Using+Google+Noto+fonts\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxcolor%7D%0A%5Cusepackage%7Bnoto%7D%0A%5Cusepackage%7Bhyperref%7D%0A%5Ctitle%7BUsing+Google+Noto+fonts%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7BApril+2021%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cmaketitle%0A%0A%5Csection%7BIntroduction%7D%0AThis+example+project+uses+the+%5Chref%7Bhttps%3A%2F%2Fctan.org%2Fpkg%2Fnoto%3Flang%3Den%7D%7B%5Ccolor%7Bblue%7D%5Ctexttt%7Bnoto%7D%7D+package+to+typeset+your+document+using+Google%27s+Noto+fonts%5Cfootnote%7B%5Curl%7Bhttps%3A%2F%2Fwww.google.com%2Fget%2Fnoto%2F%7D%7D%3A%0A%5Cbegin%7Bitemize%7D%0A%5Citem+%5Cverb%7C%5Ctextbf%7Bbold%7D%7C+produces+%5Ctextbf%7Bbold%7D%0A%5Citem+%5Cverb%7C%5Ctextit%7Bitalic%7D%7C+produces+%5Ctextit%7Bitalic%7D%0A%5Citem+%5Cverb%7C%5Ctextbf%7B%5Ctextit%7Bbold+italic%7D%7D%7C+produces+%5Ctextbf%7B%5Ctextit%7Bbold+italic%7D%7D%0A%5Citem+%5Cverb%7C%5Cemph%7Bemphasis%7D%7C+produces+%5Cemph%7Bemphasis%7D%0A%5Citem+%5Cverb%7C%5Ctextbf%7B%5Cemph%7Bbold+italic%7D%7D%7C+produces+%5Ctextbf%7B%5Cemph%7Bbold+italic%7D%7D%0A%5Cend%7Bitemize%7D%0A%0A%5Csubsection%7BMonospaced+fonts%7D%0AYou+can+use+Noto%27s+monospaced+fonts+for+%5Ctexttt%7Bregular%7D+and+%5Ctexttt%7B%5Ctextbf%7Bbold%7D%7D+monospaced+text.%0A%0A%5Csubsection%7BSans+serif+fonts%7D%0AHere+is+some+%5Ctextsf%7Btext+is+typeset+in+a+sans+serif+font%7D+together+with+%5Ctextbf%7B%5Ctextsf%7Btext+typeset+in+bold+sans+serif%7D%7D.%0A%0A%5Csection%7BFurther+reading%7D%0ADocumentation+for+the+%5Ctexttt%7Bnoto%7D+package+can+be+found+in+its+%5Chref%7Bhttp%3A%2F%2Fmirrors.ctan.org%2Ffonts%2Fnoto%2FREADME%7D%7B%5Ccolor%7Bblue%7D%5Ctexttt%7Breadme%7D+file+on+CTAN%7D.%0A%0A%5Cend%7Bdocument%7D) ![Używanie czcionek Google Noto do składu dokumentu LaTeX](/files/497edb9e1eb20da08020669a6c9f44d2f89a8374) ### Używanie czcionek niezainstalowanych na serwerach Overleaf: przykład z Google Fonts Aby używać czcionek OpenType, które nie są zainstalowane na serwerach Overleaf, musisz najpierw przesłać pliki czcionek do swojego projektu Overleaf — o ile licencje na czcionki na to pozwalają. Po przesłaniu czcionek OpenType ustaw kompilator projektu na XƎLaTeX (lub LuaLaTeX) i użyj `fontspec` do skonfigurowania czcionek. Poniższy przykładowy projekt pokazuje, jak tworzyć foldery, przesyłać czcionki i konfigurować je za pomocą `fontspec`. W naszym przykładzie użyjemy następującego zestawu czcionek z [Google Fonts](https://fonts.google.com/): * Czcionka szeryfowa: [Brygada1918](https://fonts.google.com/specimen/Brygada+1918) * Czcionka bezszeryfowa: [Asap](https://fonts.google.com/specimen/Asap) * Czcionka o stałej szerokości: [JetBrains Mono](https://fonts.google.com/specimen/JetBrains+Mono) Uwaga: Nie sugerujemy, że ten przykład stanowi typograficznie harmonijne połączenie krojów pisma; pokazuje on jedynie, jak przesyłać, konfigurować i używać wybranych czcionek. Dla każdego kroju pisma musisz pobrać rodzinę czcionek z Google Fonts: ![GoogleDownload.png](/files/c6fa89b94cb2d6e65b9e5bd6b176961fccab0aca) Uwaga: Niektóre czcionki Google są dostępne jako statyczne czcionki OpenType oraz tzw. wariantowe czcionki OpenType. Jeśli pobrany plik ZIP zawiera folder o nazwie "static", należy przesłać czcionki z tego folderu, a nie wersje wariantowe: ![OpenTypeStatic.png](/files/c93915dd7cd5bdf9e3edba7d888738453759dc50) Następnie musisz przesłać pliki czcionek do swojego projektu, ale ponieważ rodziny czcionek zawierają wiele plików, możesz chcieć utworzyć osobne foldery projektu Overleaf, aby umieścić w nich pliki — po jednym folderze na rodzinę czcionek. Poniższy film pokazuje, jak to zrobić. Później będziemy musieli poinstruować XƎLaTeX, gdzie ma szukać czcionek w twoim projekcie — ponieważ nie są one wstępnie zainstalowane na serwerach Overleaf. {% embed url="" %} ### Konfigurowanie fontspec do użycia czcionek Po przesłaniu plików rodzin czcionek do folderów projektu Overleaf możemy skonfigurować je do użycia za pomocą `fontspec`. W poniższym kodzie LaTeX zauważ, jak użyliśmy parametru `Path` aby poinformować `fontspec` że pliki czcionek znajdują się w lokalnym folderze w systemie plików naszego projektu: ```latex \setmainfont{Brygada1918}[ Path=./BrygadaFontFiles/, Extension = .ttf, UprightFont=*-Regular, BoldFont=*-Bold, ItalicFont=*-Italic, BoldItalicFont=*-BoldItalic ] \setsansfont{Asap}[ Path=./AsapFontFiles/, Scale=0.9, Extension = .ttf, UprightFont=*-Regular, BoldFont=*-Bold, ItalicFont=*-Italic, BoldItalicFont=*-BoldItalic ] \setmonofont{JetBrainsMono}[ Path=./JetbrainsFontFiles/, Scale=0.85, Extension = .ttf, UprightFont=*-Regular, BoldFont=*-Bold, ItalicFont=*-Italic, BoldItalicFont=*-BoldItalic ] ``` ![FontSpecPathUpdated.png](/files/87940afb3dbedcd8fac07e88e31d6a4d71c5b8bb) [Otwórz demonstrację XeLaTeX i Google Fonts w Overleaf](https://www.overleaf.com/project/new/template/31226?id=835225587\&templateName=XeLaTeX+font+demo+with+Google+Fonts\&latexEngine=xelatex\&texImage=texlive-full%3A2022.1\&mainFile=) Ta [`fontspec` pakietu](https://ctan.org/pkg/fontspec?lang=en) oferuje wiele opcji konfiguracji czcionek OpenType do użycia z LuaLaTeX lub XƎLaTeX — jego [doskonała dokumentacja](http://mirrors.ctan.org/macros/unicodetex/latex/fontspec/fontspec.pdf) zawiera liczne przykłady, które możesz przejrzeć, aby dopracować projekt i skład typograficzny swoich dokumentów. ## Dalsza lektura Więcej informacji znajdziesz w: * [Pogrubienie, kursywa i podkreślenie](/latex/pl/podstawy-latex-a/03-bold-italics-and-underlining.md) * [Rozmiary czcionek, kroje i style](/latex/pl/czcionki/01-font-sizes-families-and-styles.md) * [Kroje pisma](/latex/pl/czcionki/02-font-typefaces.md) * [Formatowanie akapitów](/latex/pl/formatowanie/04-articles-how-to-change-paragraph-spacing-in-latex.md) * [Podziały wierszy i puste spacje](/latex/pl/formatowanie/05-line-breaks-and-blank-spaces.md) * [Wyrównanie tekstu](/latex/pl/formatowanie/06-text-alignment.md) * [Wiele kolumn](/latex/pl/formatowanie/09-multiple-columns.md) * [Zarządzanie w dużym projekcie](/latex/pl/struktura-dokumentu/07-management-in-a-large-project.md) * [Wieloplikowe projekty LaTeX](/latex/pl/struktura-dokumentu/08-multi-file-latex-projects.md) * [Obsługa języków międzynarodowych](/latex/pl/jezyki/03-international-language-support.md) * [Wybór kompilatora LaTeX](/latex/pl/wiecej-tematow/08-choosing-a-latex-compiler.md) * [Lista czcionek OTF i TTF zainstalowanych w Overleaf](/latex/pl/pytania-i-odpowiedzi/85-which-otf-or-ttf-fonts-are-supported-via-fontspec.md) * [kolekcja czcionek Google](http://www.google.com/fonts/) * [`fontspec` podręcznik pakietu](http://tug.ctan.org/tex-archive/macros/latex/contrib/fontspec/fontspec.pdf) --- # 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/czcionki/03-xelatex.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.