> 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/formatowanie/15-margin-notes.md). # Notatki na marginesie ## Wstęp Ten artykuł wyjaśnia, jak tworzyć notatki na marginesie, popularną alternatywę dla przypisów, służącą do dodawania informacji uzupełniających wspierających główny tekst dokumentu. Mamy również [stronę pomocy dotyczącą `todonotes` pakietu](/latex/pl/pytania-i-odpowiedzi/04-can-i-add-inline-or-margin-comments-to-the-pdf.md) która oferuje alternatywne rozwiązania do tych przedstawionych w tym artykule. ## Polecenie \marginpar Bez ładowania dodatkowych pakietów możesz użyć wbudowanego w LaTeX `\marginpar` polecenia, aby dodać notatki na marginesie do dokumentu. Ogólna postać `\marginpar` polecenia to `\marginpar[*lewy tekst*]{*prawy tekst*}` gdzie `*lewy tekst*` zostanie użyty, jeśli notatka na marginesie pojawi się po lewej stronie strony dokumentu, a `*prawy tekst*` jeśli pojawi się po prawej. Dokładniej mówiąc, notatki marginalne są zwykle umieszczane na „zewnętrznej” stronie strony — choć znaczenie „zewnętrznej” zależy od używanej klasy dokumentu i od tego, czy określono `twoside` opcja pakietu: * `book` klasa (`\documentclass{book})` dokumenty są domyślnie dwustronne (układ) * `report` klasa (`\documentclass{report}`) `article` klasa (`\documentclass{article}`) dokumenty są domyślnie jednostronne. Aby uczynić je dwustronnymi, trzeba określić `twoside` opcja: * `\documentclass[twoside]{report}`, lub * `\documentclass[twoside]{article}` W przypadku dokumentów jednostronnych, z wyłączeniem języków pisanych od prawej do lewej, takich jak arabski, „zewnętrzna” strona to zawsze prawy brzeg tekstu, a w dokumentach dwustronnych jest to lewy brzeg tekstu na lewych stronach i prawy brzeg tekstu na prawych stronach. ### Odwracanie położenia notatek na marginesie Polecenie `\reversemarginpar` odwraca stronę, po której składane są notatki na marginesie; jego efekt można cofnąć poleceniem `\normalmarginpar`. Jak stwierdzono w dokumentacji kodu źródłowego LaTeX: „Te polecenia nie mają wpływu na skład w układzie dwukolumnowym.” ### Polecenia wpływające na skład notatek na marginesie Skład `\marginpar` notatek wykorzystuje kilka poleceń wymiarowych, które przechowują wartości mogące zostać zmienione, jeśli zajdzie taka potrzeba: * `\marginparwidth`: określa szerokość notatek na marginesie, a tym samym długość wierszy składanych w notatce na marginesie. * `\marginparsep`: ustawia odstęp (odległość) między notatkami na marginesie a tekstem dokumentu. * `\marginparpush`: określa minimalną odległość separacji (pionową) między `\marginpar` notatkami. ### Zmiana składu notatek na marginesie: wyrównanie do prawej i wyrównanie do lewej Domyślnie tekst notatki na marginesie jest składany w ramce, która generuje wiersze o szerokości `\marginparwidth`. Może to prowadzić do nieestetycznych przerw między składanymi słowami, gdy silnik TeX próbuje znaleźć „najlepsze” podziały wierszy. Możesz użyć poleceń `\raggedright` i `\raggedleft` aby zmienić styl składu tekstu. ### Przykład Oto przykład wykorzystujący kilka `\marginpar` poleceń, aby zademonstrować niektóre z funkcji wymienionych powyżej. Przykład ładuje również [`geometry`](https://ctan.org/pkg/geometry) pakiet, aby utworzyć mały rozmiar strony, oraz [`hyperref`](https://ctan.org/pkg/hyperref) pakiet, który udostępnia `\\url` polecenie używane do podania źródła tekstu (w przypisie). ```latex \documentclass[twoside]{article} % Uwaga: używa opcji twoside \usepackage[a4paper, marginparwidth=75pt, total={10cm, 10cm}]{geometry} % Aby utworzyć małą stronę \usepackage{hyperref} % Aby użyć polecenia \url (w przypisie) \usepackage{marginnote} \begin{document} \section{Lorem Ipsum} \footnote{Tekst źródłowy: Wikipedia (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}Lecz muszę ci wyjaśnić, jak powstała ta błędna idea potępiania przyjemności i wychwalania bólu. Aby to uczynić, przedstawię ci pełny opis systemu i wyłożę rzeczywiste nauki wielkiego odkrywcy prawdy, mistrza-architekta ludzkiego szczęścia. \marginpar[Notatka 1: tekst dla lewej strony]{Notatka 1: tekst dla prawej strony stron, jest wyjustowany.} Nikt nie odrzuca, nie lubi ani nie unika samej przyjemności, ponieważ jest przyjemnością, lecz dlatego, że ci, którzy nie wiedzą, jak dążyć do przyjemności w sposób racjonalny, napotykają konsekwencje niezwykle bolesne. Nie ma też nikogo, kto kochałby, dążyłby lub pragnąłby osiągnąć ból sam w sobie, ponieważ jest bólem, lecz czasami zdarzają się okoliczności, w których trud i ból mogą sprawić mu wielką przyjemność. \marginpar[Notatka 2: tekst dla lewej strony]{\raggedright Notatka 2: tekst dla prawej strony stron, nie jest wyjustowany, lecz używa \texttt{\string\raggedright}.} Dla trywialnego przykładu, który z nas kiedykolwiek podejmuje się żmudnych ćwiczeń fizycznych, poza po to, by osiągnąć z tego jakąś korzyść? Ale kto ma jakiekolwiek prawo ganić człowieka, który wybiera przyjemność bez przykrych następstw albo unika bólu, który nie przynosi żadnej wynikowej przyjemności? [33] Z drugiej strony potępiamy z oburzeniem i pogardzamy ludźmi, którzy są tak omamieni i zdemoralizowani urokami chwilowej przyjemności, tak zaślepieni pożądaniem, że nie potrafią przewidzieć bólu i kłopotów, które nieuchronnie nastąpią; i równa wina spada na tych, którzy zawodzą w swoim obowiązku z powodu słabości woli, co jest tym samym, co powiedzieć: z powodu uchylania się od trudu i bólu. Przypadki te są całkowicie proste i łatwe do rozróżnienia. W wolnej chwili, gdy nasza swoboda wyboru jest nieskrępowana i nic nie przeszkadza nam robić tego, co lubimy najbardziej, każdą przyjemność należy witać, a każdego bólu unikać. \marginpar[\raggedleft Notatka 3: tekst dla lewej strony stron, nie jest wyjustowany, lecz używa \texttt{\string\raggedleft}]{Notatka 3: tekst dla lewej strony stron}Ale w pewnych okolicznościach i z powodu wymagań obowiązku lub zobowiązań zawodowych często zdarza się, że przyjemności trzeba się wyrzec, a niedogodności zaakceptować. Mędrzec zatem zawsze trzyma się w tych sprawach tej zasady wyboru: odrzuca przyjemności, by zapewnić sobie inne, większe przyjemności, albo znosi bóle, by uniknąć gorszych bólów. \end{document} ``` Otwórz ten `\marginpar` przykład w Overleaf Ten przykład generuje następujący wynik (dwie strony): Strona 1: ![Przykład polecenia \marginpar](/files/c0825c9a1ee3ade7df69e67d7f646739cc2fd0a2) Strona 2: ![Przykład polecenia \marginpar](/files/452b7eec9fb5b481cca813a340c3966fa634b2a4) ### Pakiet mparhack: naprawianie niewłaściwego marginesu Wewnętrznie LaTeX przetwarza notatki na marginesie jako rodzaj „pływającego” elementu dokumentu — podobnie jak LaTeX obsługuje pływające rysunki i tabele. Ponieważ są „floatami”, notatki na marginesie tworzone przez `\marginpar` mogą czasami pojawić się na niewłaściwym marginesie. Pakiet [`mparhack` pakietu](https://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/mparhack/mparhack.pdf) został napisany, aby naprawić ten problem, więc warto go użyć, jeśli się z nim spotkasz. ## Alternatywa dla \marginpar: pakiet marginnote Ta [`marginnote` pakietu](https://www.ctan.org/pkg/marginnote) oferuje wszechstronną alternatywę dla `\marginpar` polecenie. `marginnote` implementuje notatki na marginesie za pomocą mechanizmu niepływającego, co różni się od tego, jak `\marginpar` działa: `marginnote` rozwiązuje niektóre problemy, ale jak zauważono w dokumentacji, może wprowadzać inne. ### Przykład Poniższy przykład demonstruje `\marginnote` polecenia udostępnianego przez `marginnote` pakiet: ```latex \documentclass{article} \usepackage[a5paper, total={3in, 6in}]{geometry} % aby utworzyć małą stronę \usepackage{hyperref} % Aby użyć polecenia \url (w przypisie) \usepackage{marginnote} \begin{document} \section{Lorem Ipsum} \footnote{Tekst źródłowy: Wikipedia (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}Lecz muszę ci wyjaśnić, jak powstała ta błędna idea potępiania przyjemności i wychwalania bólu. Aby to uczynić, przedstawię ci pełny opis systemu i wyłożę rzeczywiste nauki wielkiego odkrywcy prawdy, mistrza-architekta ludzkiego szczęścia. \marginnote{To jest notatka na marginesie przesunięta o 2 cm w dół strony względem wiersza, w którym jest składana.}[2cm] Nikt nie odrzuca, nie lubi ani nie unika samej przyjemności, ponieważ jest przyjemnością, lecz dlatego, że ci, którzy nie wiedzą, jak dążyć do przyjemności w sposób racjonalny, napotykają konsekwencje niezwykle bolesne. Nie ma też nikogo, kto kochałby, dążyłby lub pragnąłby osiągnąć ból sam w sobie, ponieważ jest bólem, lecz czasami zdarzają się okoliczności, w których trud i ból mogą sprawić mu wielką przyjemność. \reversemarginpar\marginnote{To jest kolejna notatka na marginesie, ale przesunięta o 2 cm w górę strony względem wiersza, w którym jest składana. Znajduje się również na lewym marginesie.}[-2cm] Dla trywialnego przykładu, który z nas kiedykolwiek podejmuje się żmudnych ćwiczeń fizycznych, poza po to, by osiągnąć z tego jakąś korzyść? Ale kto ma jakiekolwiek prawo ganić człowieka, który wybiera przyjemność bez przykrych następstw albo unika bólu, który nie przynosi żadnej wynikowej przyjemności? [33] Z drugiej strony potępiamy z oburzeniem i pogardzamy ludźmi, którzy są tak omamieni i zdemoralizowani urokami chwilowej przyjemności, tak zaślepieni pożądaniem, że nie potrafią przewidzieć bólu i kłopotów, które nieuchronnie nastąpią; i równa wina spada na tych, którzy zawodzą w swoim obowiązku z powodu słabości woli, co jest tym samym, co powiedzieć: z powodu uchylania się od trudu i bólu. Przypadki te są całkowicie proste i łatwe do rozróżnienia. W wolnej chwili, gdy nasza swoboda wyboru jest nieskrępowana i nic nie przeszkadza nam robić tego, co lubimy najbardziej, każdą przyjemność należy witać, a każdego bólu unikać. Ale w pewnych okolicznościach i z powodu wymagań obowiązku lub zobowiązań zawodowych często zdarza się, że przyjemności trzeba się wyrzec, a niedogodności zaakceptować. Mędrzec zatem zawsze trzyma się w tych sprawach tej zasady wyboru: odrzuca przyjemności, by zapewnić sobie inne, większe przyjemności, albo znosi bóle, by uniknąć gorszych bólów. \end{document} ``` Otwórz ten przykład w Overleaf Ten przykład generuje następujący wynik: ![Korzystanie z pakietu marginnote](/files/c310f530017dfc76b1c09cdc5659bc4e1500bf2f) Powyższy przykład ładuje również `geometry` pakiet, aby utworzyć mały rozmiar strony, oraz `hyperref` pakiet, który udostępnia `\\url` polecenie używane do podania źródła tekstu (w przypisie). Po zaimportowaniu `marginnote` pakiet, wpisując `\usepackage{marginnote}` możesz użyć `\marginnote` polecenia, jak pokazują dwa wystąpienia w tekście przykładu: * `\marginnote{To jest notatka na marginesie przesunięta o 2 cm w dół strony względem wiersza, w którym jest składana.}[2cm]` * `\marginnote{To jest kolejna notatka na marginesie, ale przesunięta o 2 cm w górę strony względem wiersza, w którym jest składana. Znajduje się również na lewym marginesie.}[-2cm]` W tych przykładach używamy drugiego parametru w nawiasach `[ ]` który określa wyrównanie pionowe względem wiersza, w którym użyto polecenia. Pierwszy `\margingnote` polecenie używa `[2cm]` przesuwa notatkę na marginesie o 2 cm *w dół strony*, drugi używa `[-2cm]` przesuwa notatkę na marginesie o 2 cm *w górę strony*. Drugie `\marginnote` polecenie działa po użyciu `\reversemarginpar` zostało użyte, powodując umieszczenie go na lewym marginesie tego jednostronnego dokumentu: ```latex \reversemarginpar\marginnote{To jest kolejna notatka na marginesie, ale przesunięta o 2 cm w górę strony względem wiersza, w którym jest składana. Znajduje się również na lewym marginesie.}[-2cm] ``` ## Dalsza lektura Więcej informacji znajdziesz w * [Ta `marginnote` dokumentacja pakietu](http://www.ctan.org/pkg/marginnote) * [Ta `mparhack` dokumentacja pakietu](http://www.ctan.org/pkg/mparhack) * [Rozmiar strony i marginesy](/latex/pl/formatowanie/07-page-size-and-margins.md) * [Przypisy dolne](/latex/pl/formatowanie/14-footnotes.md) * [Długości w LaTeX-u](/latex/pl/formatowanie/01-lengths-in-latex.md) * [Dokumenty jednostronne i dwustronne](/latex/pl/formatowanie/08-single-sided-and-double-sided-documents.md) * [Wiele kolumn](/latex/pl/formatowanie/09-multiple-columns.md) * [Nagłówki i stopki](/latex/pl/formatowanie/02-headers-and-footers.md) * [Formatowanie akapitu](/latex/pl/formatowanie/04-articles-how-to-change-paragraph-spacing-in-latex.md) * [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) --- # 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/formatowanie/15-margin-notes.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.