> 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/formatuvannya/15-margin-notes.md). # Примітки на полях ## Вступ Ця стаття пояснює, як створювати примітки на полях — популярну альтернативу виноскам як засіб додавання додаткової інформації для підтримки основного тексту документа. Також у нас є [сторінка довідки про `todonotes` accents](/latex/uk/zapitannya-ta-vidpovidi/04-can-i-add-inline-or-margin-comments-to-the-pdf.md) який пропонує альтернативні рішення до тих, що подані в цій статті. ## Команда \marginpar Без завантаження будь-яких додаткових пакетів ви можете використовувати вбудовану в LaTeX `\marginpar` команду, щоб додавати примітки на полях до вашого документа. Загальний вигляд `\marginpar` команди такий `\marginpar[*left text*]{*right text*}` де `*left text*` буде використано, якщо примітка на полі з’являється ліворуч на сторінці документа, а `*right text*` — якщо вона з’являється праворуч. Якщо точніше, примітки на полях зазвичай розміщують на «зовнішньому» боці сторінки — хоча значення «зовнішнього» залежить від класу документа, який ви використовуєте, і від того, чи вказали ви `twoside` параметр пакета: * `book` класу (`\documentclass{book})` документи за замовчуванням двосторонні (за дизайном) * `report` класу (`\documentclass{report}`) і `article` класу (`\documentclass{article}`) документи за замовчуванням односторонні. Щоб зробити їх двосторонніми, потрібно вказати `twoside` параметром: * `\documentclass[twoside]{report}`, або * `\documentclass[twoside]{article}` Для односторонніх документів, за винятком мов, що пишуться справа наліво, таких як арабська, «зовнішній» бік завжди є правим краєм тексту, а для двосторонніх документів — це лівий край тексту для лівих сторінок і правий край тексту для правих сторінок. ### Зміна розташування приміток на полях Команда `\reversemarginpar` змінює бік, на якому верстаються примітки на полях; його дію можна скасувати командою `\normalmarginpar`. Як зазначено в документації до вихідного коду LaTeX: «Ці команди не мають ефекту для двоколонкового виведення». ### Команди, що впливають на верстку приміток на полях Верстка `\marginpar` приміток використовує кілька команд розмірів, які зберігають значення, що за потреби можна змінити: * `\marginparwidth`: визначає ширину приміток на полях і, отже, довжину рядків, набраних у примітці на полі. * `\marginparsep`: задає проміжок (відстань) між примітками на полях і текстом вашого документа. * `\marginparpush`: визначає мінімальну вертикальну відстань розділення між `\marginpar` примітками. ### Зміна верстки приміток на полях: нерівний правий і нерівний лівий край За замовчуванням текст примітки на полі верстається у боксі, який створює рядки шириною `\marginparwidth`. Це може призвести до неестетичних проміжків між словами, оскільки рушій TeX намагається знайти «найкращі» переноси рядків. Ви можете використовувати команди `\raggedright` та `\raggedleft` щоб змінити стиль верстки тексту. ### Приклад Ось приклад, який використовує кілька `\marginpar` команд, щоб продемонструвати деякі з наведених вище можливостей. У прикладі також завантажується [`geometry`](https://ctan.org/pkg/geometry) пакет для створення малого розміру сторінки та [`hyperref`](https://ctan.org/pkg/hyperref) пакет, який надає `\url` команду, що використовується для зазначення джерела тексту (у виносці). ```latex \documentclass[twoside]{article} % Примітка: використовує параметр twoside \usepackage[a4paper, marginparwidth=75pt, total={10cm, 10cm}]{geometry} % Щоб створити невелику сторінку \usepackage{hyperref} % Щоб використовувати команду \url (у виносці) \usepackage{marginnote} \begin{document} \section{Lorem Ipsum} \footnote{Вихідний текст: Wikipedia (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}Але я мушу пояснити вам, як виникла вся ця хибна ідея засудження задоволення й возвеличення болю. Для цього я дам вам повний виклад системи та розтлумачу справжні вчення великого шукача істини, творця людського щастя. \marginpar[Примітка 1: текст для лівого боку]{Примітка 1: текст для правого боку сторінок, він вирівняний по ширині.} Ніхто не відкидає, не зневажає і не уникає самого задоволення, тому що це задоволення, а тому, що ті, хто не вміє раціонально прагнути задоволення, стикаються з надзвичайно болісними наслідками. Так само немає нікого, хто любив би, прагнув або бажав би здобути сам біль, тому що це біль, але іноді трапляються обставини, за яких праця й біль можуть принести йому велике задоволення. \marginpar[Примітка 2: текст для лівого боку]{\raggedright Примітка 2: текст для правого боку сторінок, він не вирівняний по ширині, а використовує \texttt{\string\raggedright}.} Взяти банальний приклад: хто з нас коли-небудь виконує виснажливі фізичні вправи, хіба що для того, щоб отримати від цього якусь користь? Але хто має право дорікати людині, яка обирає насолоджуватися задоволенням, що не має неприємних наслідків, або тій, яка уникає болю, що не приносить жодного подальшого задоволення? [33] З іншого боку, ми засуджуємо з праведним обуренням і не любимо людей, які настільки зваблені й розбещені чарами миттєвого задоволення, настільки засліплені бажанням, що не можуть передбачити біль і клопоти, які неминуче настануть; і така сама вина лежить на тих, хто не виконує свій обов’язок через слабкість волі, що, іншими словами, означає відступ перед працею і болем. Ці випадки цілком прості й легко відрізняються. У вільну годину, коли наша здатність вибору не скута і ніщо не заважає нам робити те, що ми любимо найбільше, кожне задоволення слід вітати, а кожного болю уникати. \marginpar[\raggedleft Примітка 3: текст для лівого боку сторінок, він не вирівняний по ширині, а використовує \texttt{\string\raggedleft}]{Примітка 3: текст для лівого боку сторінок} Але за певних обставин і через вимоги обов’язку або ділових зобов’язань часто трапляється так, що задоволення доводиться відкидати, а неприємності — приймати. Отже, мудра людина завжди дотримується в цих питаннях цього принципу добору: вона відкидає задоволення, щоб забезпечити інші, більші задоволення, або ж терпить болі, щоб уникнути гірших болів. \end{document} ``` Відкрийте цей `\marginpar` приклад в Overleaf Цей приклад дає такий результат (дві сторінки): Сторінка 1: ![Приклад команди \marginpar](/files/9f405d3c3936203cce671f3842b24664612d22ac) Сторінка 2: ![Приклад команди \marginpar](/files/2c47707f0d84d7c3469efad0509c0e215521e0ec) ### Пакет mparhack: виправлення неправильного поля Внутрішньо LaTeX обробляє примітки на полях як тип «плаваючого» елемента вашого документа — подібно до того, як LaTeX обробляє плаваючі рисунки й таблиці. Через те, що це «плаваючі» об’єкти, примітки на полях, створені за допомогою `\marginpar` інколи можуть з’являтися на неправильному полі. Пакет [`mparhack` accents](https://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/mparhack/mparhack.pdf) було створено, щоб виправити цю проблему, тож варто використовувати його, якщо ви з нею зіткнетеся. ## Альтернатива \marginpar: пакет marginnote Функція [`marginnote` accents](https://www.ctan.org/pkg/marginnote) пропонує універсальну альтернативу `\marginpar` команду. `marginnote` реалізує примітки на полях за допомогою механізму, що не є плаваючим, що відрізняється від того, як `\marginpar` працює: `marginnote` вирішує деякі проблеми, але, як зазначено в його документації, може створити інші. ### Приклад Наступний приклад демонструє `\marginnote` команди, наданої `marginnote` пакета: ```latex \documentclass{article} \usepackage[a5paper, total={3in, 6in}]{geometry} % щоб створити невелику сторінку \usepackage{hyperref} % Щоб використовувати команду \url (у виносці) \usepackage{marginnote} \begin{document} \section{Lorem Ipsum} \footnote{Вихідний текст: Wikipedia (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}Але я мушу пояснити вам, як виникла вся ця хибна ідея засудження задоволення й возвеличення болю. Для цього я дам вам повний виклад системи та розтлумачу справжні вчення великого шукача істини, творця людського щастя. \marginnote{Це примітка на полі, зміщена на 2 см \textit{вниз} по сторінці відносно рядка, у якому її набрано.}[2cm] Ніхто не відкидає, не зневажає і не уникає самого задоволення, тому що це задоволення, а тому, що ті, хто не вміє раціонально прагнути задоволення, стикаються з надзвичайно болісними наслідками. Так само немає нікого, хто любив би, прагнув або бажав би здобути сам біль, тому що це біль, але іноді трапляються обставини, за яких праця й біль можуть принести йому велике задоволення. \reversemarginpar\marginnote{Це ще одна примітка на полі, але зміщена на 2 см \textit{вгору} по сторінці відносно рядка, у якому її набрано. Вона також розміщена в лівому полі.}[-2cm] Взяти банальний приклад: хто з нас коли-небудь виконує виснажливі фізичні вправи, хіба що для того, щоб отримати від цього якусь користь? Але хто має право дорікати людині, яка обирає насолоджуватися задоволенням, що не має неприємних наслідків, або тій, яка уникає болю, що не приносить жодного подальшого задоволення? [33] З іншого боку, ми засуджуємо з праведним обуренням і не любимо людей, які настільки зваблені й розбещені чарами миттєвого задоволення, настільки засліплені бажанням, що не можуть передбачити біль і клопоти, які неминуче настануть; і така сама вина лежить на тих, хто не виконує свій обов’язок через слабкість волі, що, іншими словами, означає відступ перед працею і болем. Ці випадки цілком прості й легко відрізняються. У вільну годину, коли наша здатність вибору не скута і ніщо не заважає нам робити те, що ми любимо найбільше, кожне задоволення слід вітати, а кожного болю уникати. Але за певних обставин і через вимоги обов’язку або ділових зобов’язань часто трапляється так, що задоволення доводиться відкидати, а неприємності — приймати. Отже, мудра людина завжди дотримується в цих питаннях цього принципу добору: вона відкидає задоволення, щоб забезпечити інші, більші задоволення, або ж терпить болі, щоб уникнути гірших болів. \end{document} ``` Відкрити цей приклад в Overleaf Цей приклад дає такий результат: ![Використання пакета marginnote](/files/9b67883a0c6f0db6490855bb146091162da5cfb4) Наведений вище приклад також завантажує `geometry` пакет для створення малого розміру сторінки та `hyperref` пакет, який надає `\url` команду, що використовується для зазначення джерела тексту (у виносці). Після імпорту `marginnote` пакет, написавши `\usepackage{marginnote}` ви можете використовувати `\marginnote` команду, як показують два випадки в тексті прикладу: * `\marginnote{Це примітка на полі, зміщена на 2 см, \textit{вниз} по сторінці відносно рядка, у якому її набрано.}[2cm]` * `\marginnote{Це ще одна примітка на полі, але зміщена на 2 см \textit{вгору} по сторінці відносно рядка, у якому її набрано. Вона також розміщена в лівому полі.}[-2cm]` У цих прикладах ми використовуємо другий параметр у квадратних дужках `[ ]` який визначає вертикальне вирівнювання відносно рядка, де використовується команда. Перший `\margingnote` команда використовує `[2cm]` щоб змістити примітку на полі на 2 см *вниз по сторінці*, другий використовує `[-2cm]` щоб змістити примітку на полі на 2 см *вгору по сторінці*. Другий `\marginnote` команда працює після того, як `\reversemarginpar` була використана, через що її розміщено в лівому полі цього одностороннього документа: ```latex \reversemarginpar\marginnote{Це ще одна примітка на полі, але зміщена на 2 см \textit{вгору} по сторінці відносно рядка, у якому її набрано. Вона також розміщена в лівому полі.}[-2cm] ``` ## Додаткове читання Для отримання додаткової інформації див. * [Функція `marginnote` документація пакета](http://www.ctan.org/pkg/marginnote) * [Функція `mparhack` документація пакета](http://www.ctan.org/pkg/mparhack) * [Розмір сторінки та поля](/latex/uk/formatuvannya/07-page-size-and-margins.md) * [Виноски](/latex/uk/formatuvannya/14-footnotes.md) * [Довжини в LaTeX](/latex/uk/formatuvannya/01-lengths-in-latex.md) * [Односторонні та двосторонні документи](/latex/uk/formatuvannya/08-single-sided-and-double-sided-documents.md) * [Кілька колонок](/latex/uk/formatuvannya/09-multiple-columns.md) * [Верхні та нижні колонтитули](/latex/uk/formatuvannya/02-headers-and-footers.md) * [Форматування абзацу](/latex/uk/formatuvannya/04-articles-how-to-change-paragraph-spacing-in-latex.md) * [Жирний, курсив і підкреслення](/latex/uk/osnovi-latex/03-bold-italics-and-underlining.md) * [Розміри, гарнітури та стилі шрифтів](/latex/uk/shrifti/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/uk/formatuvannya/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.