> 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/polecenia/01-commands.md). # Polecenia ## Wstęp Ten artykuł stanowi wprowadzenie do *polecenia*, które są istotnym elementem możliwości składu tekstu w LaTeX-u. Większość poleceń LaTeX to proste słowa poprzedzone specjalnym znakiem, zwykle `\`, znakiem ukośnika wstecznego. Przyjrzyjmy się kilku przykładom: ```latex \documentclass{article} \begin{document} W dokumencie istnieją różne rodzaje \textbf{poleceń} określających sposób wyświetlania elementów. To polecenia mogą wstawiać specjalne elementy: $\alpha \beta \Gamma$ \end{document} ``` [Otwórz ten przykład w Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+commands+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AIn+a+document+there+are+different+types+of+%5Ctextbf%7Bcommands%7D+%0Athat+define+the+way+the+elements+are+displayed.+This+%0Acommands+may+insert+special+elements%3A+%24%5Calpha+%5Cbeta+%5CGamma%24%0A%5Cend%7Bdocument%7D) Ten przykład generuje następujący wynik: ![Podstawowe formatowanie tekstu w LaTeX-u](/files/ae9889845bc383ec744fd708386bdd22aae64183) W poprzednim przykładzie istnieją różne rodzaje poleceń; na przykład, `\textbf` pogrubi tekst przekazany jako parametr do polecenia. W trybie matematycznym istnieją specjalne polecenia, takie jak `\alpha`, `\beta` i `\Gamma` do wyświetlania greckich znaków. ## Polecenia Oto przykład kodu LaTeX z poleceniami tworzącymi listę punktowaną: ```latex \documentclass{article} \begin{document} Przykład listy: \begin{itemize} \item[\S] Pierwszy element \item Drugi element \end{itemize} \end{document} ``` [Otwórz ten przykład w Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+itemized+list+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AA+list+example%3A%0A%5Cbegin%7Bitemize%7D%0A++%5Citem%5B%5CS%5D+First+item%0A++%5Citem+Second+item%0A%5Cend%7Bitemize%7D%0A%5Cend%7Bdocument%7D) Ten przykład generuje następujący wynik: ![Podstawowa lista składu w LaTeX-u](/files/1fa3279cef03a78b6bc2e69d5dc9f99e5bc9ed1f) Polecenie `\begin{itemize}` rozpoczyna `itemize` *środowisko*—zobacz [artykuł o środowiskach](/latex/pl/polecenia/02-environments.md) po więcej szczegółów. Poniżej deklaracji środowiska znajduje się polecenie `\item` które mówi LaTeX-owi, aby rozpoczął nową pozycję listy: aby ją sformatować, dodać specjalny znacznik (małą czarną kropkę zwaną bullet) i wciąć pozycję. Niektóre polecenia wymagają jednego lub więcej *parametrami*; na przykład `\textbf` polecenie (użyte powyżej), które przyjmuje jeden parametr — tekst wyświetlany pogrubioną czcionką, zapisywany w nawiasach klamrowych tak: `\textbf{make this bold}`. Istnieją również *opcjonalny* parametrów, które można przekazać do polecenia, aby zmienić jego działanie; te opcjonalne parametry trzeba umieścić w nawiasach kwadratowych: `[...]`. W powyższym przykładzie polecenie `\item[\S]` działa tak samo jak `\item`, z tą różnicą, że w nawiasach znajduje się `\S`, który zastępuje inny znak zamiast czarnej kropki przed tekstem pozycji. ## Definiowanie nowego polecenia Chociaż LaTeX zawiera ogromną liczbę poleceń, często konieczne staje się zdefiniowanie własnych specjalnych poleceń, aby uprościć pracę, ograniczyć powtarzalne zadania lub wykonać bardziej złożone formatowanie. ### Proste polecenia Nowe polecenia definiuje się za pomocą `\newcommand`; zobaczmy więc prosty przykład: ```latex \documentclass{article} \usepackage{amssymb} \begin{document} \newcommand{\R}{\mathbb{R}} Zbiór liczb rzeczywistych jest zwykle oznaczany za pomocą wielkiej litery R pisanej krojem tablicowym pogrubionym: \( \R \). \end{document} ``` [Otwórz ten przykład w Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Creating+a+simple+command\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bamssymb%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewcommand%7B%5CR%7D%7B%5Cmathbb%7BR%7D%7D%0AThe+set+of+real+numbers+are+usually+represented+%0Aby+a+blackboard+bold+capital+R%3A+%5C%28+%5CR+%5C%29.%0A%5Cend%7Bdocument%7D) Ten przykład generuje następujący wynik: ![Wynik nowego polecenia](/files/9e67b722835182b42b622539ab94f9344d04db2e) Instrukcja `\newcommand{\R}{\mathbb{R}}` ma dwa parametry, które definiują nowe polecenie, gdzie: * `\R`: jest nazwą nowego polecenia. * `\mathbb{R}`: określa, co robi nowe polecenie. W tym przypadku litera R zostanie zapisana krojem tablicowym pogrubionym. Użycie polecenia `\mathbb` wymaga pakietu `amssymb` pakietu, który został dodany w powyższym przykładzie (w preambule). Po zdefiniowaniu polecenia możemy używać go w tekście, jak pokazano powyżej. W tym przykładzie nowe polecenie jest zdefiniowane bezpośrednio przed akapitem, w którym jest używane; jednak rozrzucanie takich definicji po całym dokumencie nie jest uznawane za najlepszą praktykę. Zwykle definicje nowych poleceń są zbierane razem w preambule dokumentu lub, w przypadku większych zbiorów, umieszczane w osobnym pliku, który można [zaimportować do głównego dokumentu](/latex/pl/struktura-dokumentu/07-management-in-a-large-project.md#inputting-and-including-files). ### Polecenia z parametrami Można także tworzyć nowe polecenia przyjmujące pewne parametry; na przykład: ```latex \documentclass{article} \usepackage{amssymb} \begin{document} \newcommand{\bb}[1]{\mathbb{#1}} Inne systemy liczbowe mają podobne oznaczenia. Liczby zespolone \( \bb{C} \), liczby wymierne liczby \( \bb{Q} \) oraz liczby całkowite \( \bb{Z} \). \end{document} ``` [Otwórz ten przykład w Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+command+with+1+parameter\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bamssymb%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cnewcommand%7B%5Cbb%7D%5B1%5D%7B%5Cmathbb%7B%231%7D%7D%0AOther+numerical+systems+have+similar+notations.+%0AThe+complex+numbers+%5C%28+%5Cbb%7BC%7D+%5C%29%2C+the+rational+%0Anumbers+%5C%28+%5Cbb%7BQ%7D+%5C%29+and+the+integer+numbers+%5C%28+%5Cbb%7BZ%7D+%5C%29.%0A%5Cend%7Bdocument%7D) Ten przykład generuje następujący wynik: ![Wynik polecenia LaTeX z parametrem](/files/1654330f3fb2ad9f4b79336378301b3d63360d95) Linia `\newcommand{\bb}[1]{\mathbb{#1}}` definiuje nowe polecenie przyjmujące jeden parametr, gdzie: * `\bb` jest nazwą nowego polecenia. * `[1]` jest liczbą parametrów, które będzie przyjmować nowe polecenie. * `\mathbb{#1}` jest tym, co polecenie faktycznie robi — jego definicją. W tym przypadku parametr, oznaczony jako `#1`, zostanie zapisany znakami kroju tablicowego pogrubionego. Jeśli polecenie wymaga więcej niż jednego parametru, możesz odwoływać się do każdego parametru za pomocą `#1`, `#2` i tak dalej. Obsługiwanych jest do 9 parametrów. ### Polecenia z parametrami opcjonalnymi Polecenia definiowane przez użytkownika można uczynić jeszcze bardziej elastycznymi niż przykłady pokazane do tej pory: można definiować polecenia przyjmujące *opcjonalny* parametry: ```latex \documentclass{article} \begin{document} Podczas zapisywania wielu wyrażeń z wykładnikami możemy uprościć zadanie i zaoszczędzić czas, definiując odpowiednie polecenie: \newcommand{\plusbinomial}[3][2]{(#2 + #3)^#1} Możemy użyć go tak: \[ \plusbinomial{x}{y} \] A nawet wykładnik można zmienić: \[ \plusbinomial[4]{a}{b} \] \end{document} ``` [Otwórz ten przykład w Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+command+with+optional+parameters\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%0AWhen+writing+many+expressions+with+exponents+we+can+simplify+our+task%2C+and+save+time%2C+by+defining+a+suitable+command%3A%0A%0A%5Cnewcommand%7B%5Cplusbinomial%7D%5B3%5D%5B2%5D%7B%28%232+%2B+%233%29%5E%231%7D%0A%0AWe+can+use+it+like+this%3A+%5C%5B+%5Cplusbinomial%7Bx%7D%7By%7D+%5C%5D%0A%0AAnd+even+the+exponent+can+be+changed%3A%0A%0A%5C%5B+%5Cplusbinomial%5B4%5D%7Ba%7D%7Bb%7D+%5C%5D%0A%5Cend%7Bdocument%7D) Ten przykład generuje następujący wynik: ![Wynik polecenia z parametrami opcjonalnymi](/files/2099074a3cf8712b35f63e9820921de98fa2a816) Przeanalizujmy składnię wiersza `\newcommand{\plusbinomial}[3][2]{(#2 + #3)^#1}`: * `\plusbinomial` jest nazwą nowego polecenia. * `[3]` jest liczbą parametrów, które będzie przyjmować polecenie; w tym przypadku 3. * `[2]` jest wartością domyślną pierwszego parametru. To właśnie sprawia, że pierwszy parametr jest opcjonalny; jeśli nie zostanie przekazany, użyta zostanie ta wartość domyślna. * `(#2 + #3)^#1` jest tym, co polecenie robi. W tym przypadku umieści drugi i trzeci parametr w „dwumianowym formacie” podniesionym do potęgi określonej przez pierwszy parametr. ## Nadpisywanie istniejących poleceń Jeśli spróbujesz zdefiniować nowe polecenie o tej samej nazwie co *już istniejące* polecenie LaTeX, kompilacja zakończy się niepowodzeniem z komunikatem o błędzie. Pokazuje to poniższy przykład, który próbuje zdefiniować (istniejące) `\textbf` polecenia: ```latex \documentclass{article} \newcommand{\textbf}[1]{#1}% To nie zadziała \begin{document} \section{To się nie powiedzie} \end{document} ``` [Otwórz ten (**generujący błąd**) przykład w Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Duplicate+command+name\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cnewcommand%7B%5Ctextbf%7D%5B1%5D%7B%231%7D%25+This+will+not+work%0A%5Cbegin%7Bdocument%7D%0A%0A%5Csection%7BThis+will+fail%7D%0A%5Cend%7Bdocument%7D) Kompilacja tego przykładu daje następujący wynik: ![Błąd spowodowany zduplikowaną definicją polecenia LaTeX](/files/78257f181a70144fbcbc95c93d9f8911c4cb6b64) Jak pokazano na zrzucie ekranu, nasza próba zdefiniowania `\textbf` nie powiodła się: LaTeX wygenerował komunikat o błędzie **Błąd LaTeX: polecenie \textbf jest już zdefiniowane**. Jeśli naprawdę chcesz zastąpić istniejące polecenie, można to zrobić za pomocą `\renewcommand`, które używa tej samej składni co `\newcommand`: ```latex \documentclass{article} \usepackage{amssymb} \begin{document} \renewcommand{\S}{\mathbb{S}} Sfera Riemanna (liczby zespolone plus $\infty$) jest czasami oznaczana przez \( \S \). \end{document} ``` [Otwórz ten przykład w Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Redefine+existing+command\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bamssymb%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Crenewcommand%7B%5CS%7D%7B%5Cmathbb%7BS%7D%7D%0A%0AThe+Riemann+sphere+%28the+complex+numbers+plus+%24%5Cinfty%24%29+is+%0Asometimes+represented+by+%5C%28+%5CS+%5C%29.%0A%5Cend%7Bdocument%7D) Ten przykład generuje następujący wynik: ![Wynik redefiniowanego polecenia LaTeX](/files/f9959154d0559ac21d929b297ccc98c5ac99df55) W tym przykładzie polecenie `\S` (zobacz przykład w [polecenia](#commands) sekcji) zostaje nadpisane tak, aby wyświetlać wielką literę S krojem tablicowym pogrubionym. ## Dalsza lektura Więcej informacji znajdziesz w: * [Środowiska](/latex/pl/polecenia/02-environments.md) * [Zrozumienie pakietów i plików klas](/latex/pl/pliki-klas/01-understanding-packages-and-class-files.md) * [Pisanie własnego pakietu](/latex/pl/pliki-klas/03-writing-your-own-package.md) * [Pisanie własnej klasy](/latex/pl/pliki-klas/04-writing-your-own-class.md) * [Długości w LaTeX-u](/latex/pl/formatowanie/01-lengths-in-latex.md) * [Używanie kolorów w LaTeX](/latex/pl/formatowanie/13-using-colors-in-latex.md) * [Rozmiar strony i marginesy](/latex/pl/formatowanie/07-page-size-and-margins.md) * [Lista pakietów i plików klas](/latex/pl/pliki-klas/02-overleaf-and-tex-live.md) * [Niezbyt krótki wstęp do LaTeX2ε](http://www.ctan.org/tex-archive/info/lshort/) * [LaTeX/Tworzenie\_pakietów na Wikibooks](http://en.wikibooks.org/wiki/LaTeX/Creating_Packages) --- # 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/polecenia/01-commands.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.