> 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/ru/formatirovanie/15-margin-notes.md).

# Заметки на полях

## Введение

В этой статье объясняется, как создавать заметки на полях — популярную альтернативу сноскам, используемую для добавления дополнительной информации к основному тексту документа. У нас также есть [страница помощи по `todonotes` пакет](/latex/ru/voprosy-i-otvety/04-can-i-add-inline-or-margin-comments-to-the-pdf.md) который предлагает альтернативные решения по сравнению с теми, что представлены в этой статье.

## Команда \marginpar

Без загрузки каких-либо дополнительных пакетов вы можете использовать встроенную в LaTeX `\marginpar` команду, чтобы добавлять заметки на полях в ваш документ. Общий вид `\marginpar` команды таков

`\marginpar[*левый текст*]{*правый текст*}`

где `*левый текст*` будет использован, если заметка на полях появляется слева от страницы документа, и `*правый текст*` если она появляется справа. Если говорить точнее, заметки на полях обычно размещаются на «внешней» стороне страницы — хотя значение «внешней» зависит от класса документа, который вы используете, и от того, указали ли вы `twoside` опцию пакета:

* `книга` класс (`\documentclass{book})` документы по умолчанию двусторонние (по замыслу)
* `отчёт` класс (`\documentclass{report}`) и `статью` класс (`\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{Источник текста: Википедия (\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/7aa6b2fb01ff002673e44e82334eb9bdfd4f79ea)

Страница 2:

![Пример команды \marginpar](/files/2d8ef9204c5727b0061044063e38237b37703121)

### Пакет mparhack: исправление неправильного поля

Внутри LaTeX обрабатывает заметки на полях как разновидность «плавающего» элемента вашего документа — подобно тому, как LaTeX работает с плавающими рисунками и таблицами. Из-за того, что это «плавающие» объекты, заметки на полях, создаваемые `\marginpar` могут иногда появляться не на том поле. Пакет [`mparhack` пакет](https://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/mparhack/mparhack.pdf) был создан, чтобы исправить эту проблему, так что его стоит использовать, если вы с ней столкнётесь.

## Альтернатива \marginpar: пакет marginnote

Это [`marginnote` пакет](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{Источник текста: Википедия (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}Но я должен объяснить вам, как возникла вся эта ошибочная идея порицать удовольствие и восхвалять боль. Для этого я дам вам полное описание системы и изложу истинные учения великого исследователя истины, создателя человеческого счастья. \marginnote{Это заметка на полях, сдвинутая на 2 см \textit{вниз} по странице относительно строки, в которой она набрана.}[2cm] Никто не отвергает, не ненавидит и не избегает самого удовольствия, потому что это удовольствие, а потому, что те, кто не умеет разумно стремиться к удовольствию, сталкиваются с последствиями, которые крайне болезненны. И никто снова не любит, не стремится и не желает получить саму боль, потому что это боль, но иногда возникают обстоятельства, при которых труд и боль могут доставить ему некоторое великое удовольствие. \reversemarginpar\marginnote{Это еще одна заметка на полях, но сдвинутая на 2 см \textit{вверх} по странице относительно строки, в которой она набрана. Она также находится на левом поле.}[-2cm] Возьмем тривиальный пример: кто из нас когда-либо занимается изнурительными физическими упражнениями, кроме как ради какой-либо выгоды от них? Но кто имеет право упрекать человека, который предпочитает наслаждаться удовольствием, не влекущим за собой неприятных последствий, или того, кто избегает боли, не приносящей последующего удовольствия? [33] С другой стороны, мы с праведным негодованием осуждаем и не любим людей, которые так обмануты и развращены чарами мгновенного удовольствия, так ослеплены желанием, что не могут предвидеть боль и неприятности, которые неизбежно последуют; и равная вина лежит на тех, кто не исполняет свой долг из-за слабости воли, то есть из-за уклонения от труда и боли. Эти случаи совершенно просты и легко различимы. В свободный час, когда наша способность выбора ничем не стеснена и ничто не мешает нам делать то, что нам больше всего нравится, всякое удовольствие следует приветствовать, а всякой боли — избегать. Но в определенных обстоятельствах и вследствие требований долга или деловых обязательств нередко случается, что от удовольствий приходится отказываться, а неприятности — принимать. Поэтому мудрый человек всегда придерживается в этих вопросах принципа отбора: он отвергает удовольствия, чтобы обеспечить себе другие, более великие удовольствия, или же терпит боль, чтобы избежать еще более сильной боли.
\end{document}
```

Откройте этот пример в Overleaf

Этот пример выдаёт следующий результат:

![Использование пакета marginnote](/files/619a86a38fa9dccf9c333b65ac4fab1a819e264a)

Приведенный выше пример также подключает `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/ru/formatirovanie/07-page-size-and-margins.md)
* [Сноски](/latex/ru/formatirovanie/14-footnotes.md)
* [Длины в LaTeX](/latex/ru/formatirovanie/01-lengths-in-latex.md)
* [Односторонние и двусторонние документы](/latex/ru/formatirovanie/08-single-sided-and-double-sided-documents.md)
* [Несколько колонок](/latex/ru/formatirovanie/09-multiple-columns.md)
* [Верхние и нижние колонтитулы](/latex/ru/formatirovanie/02-headers-and-footers.md)
* [Форматирование абзацев](/latex/ru/formatirovanie/04-articles-how-to-change-paragraph-spacing-in-latex.md)
* [Полужирный, курсив и подчёркивание](/latex/ru/osnovy-latex/03-bold-italics-and-underlining.md)
* [Размеры, семейства и начертания шрифтов](/latex/ru/shrifty/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/ru/formatirovanie/15-margin-notes.md?ask=<question>&goal=<endgoal>
```

`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.
