> 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/overleaf-learn-latex-pt/formatacao/15-margin-notes.md). # Notas na margem ## Introdução Este artigo explica como criar notas marginais, uma alternativa popular às notas de rodapé como recurso para adicionar informação suplementar para dar suporte ao texto principal de um documento. Também temos uma [página de ajuda sobre o `todonotes` pacote](/latex/overleaf-learn-latex-pt/perguntas-e-respostas/04-can-i-add-inline-or-margin-comments-to-the-pdf.md) que fornece soluções alternativas às apresentadas neste artigo. ## O comando \marginpar Sem carregar quaisquer pacotes adicionais, você pode usar o LaTeX integrado `\marginpar` comando para adicionar notas marginais ao seu documento. A forma geral do `\marginpar` comando é `\marginpar[*left text*]{*right text*}` onde `*left text*` será usado se a nota marginal aparecer à esquerda de uma página do documento e `*right text*` se aparecer à direita. Para ser mais específico, as notas marginais são normalmente colocadas no “lado externo” da página — embora o significado de “externo” dependa da classe de documento que você está usando e de ter especificado a `twoside` opção de pacote: * `book` classe (`\documentclass{book})` os documentos são, por padrão, frente e verso (por conceção) * `article` classe (`\documentclass{report}`) e `article` classe (`\documentclass{article}`) os documentos são, por padrão, de um só lado. Para torná-los frente e verso, você tem de especificar a `twoside` : * `\documentclass[twoside]{report}`, ou * `\documentclass[twoside]{article}` Para documentos de um só lado, excluindo idiomas da direita para a esquerda, como o árabe, o “lado externo” é sempre a margem direita do texto e, para documentos frente e verso, é a margem esquerda do texto nas páginas ímpares e a margem direita do texto nas páginas pares. ### Invertendo a colocação das notas marginais O comando `\reversemarginpar` inverte o lado em que as notas marginais são compostas; o seu efeito pode ser desfeito com o comando `\normalmarginpar`. Como afirma a documentação do código-fonte do LaTeX, “Estes comandos não têm efeito para saída em duas colunas.” ### Comandos que afetam a composição das notas marginais A composição de `\marginpar` notas faz uso de vários comandos de dimensão que armazenam valores que podem ser alterados, se necessário: * `\marginparwidth`: determina a largura das notas marginais e, assim, o comprimento das linhas compostas na nota marginal. * `\marginparsep`: define o espaçamento (distância) entre as notas marginais e o texto do seu documento. * `\marginparpush`: define uma distância mínima de separação (vertical) entre `\marginpar` notas. ### Alterando a composição das notas marginais: alinhamento irregular à direita e à esquerda Por padrão, o texto de uma nota marginal é composto numa caixa que produz linhas compostas com largura `\marginparwidth`. Isso pode resultar em lacunas pouco estéticas entre as palavras compostas, à medida que o motor TeX tenta encontrar as “melhores” quebras de linha. Você pode usar os comandos `\raggedright` e `\raggedleft` para alterar o estilo de composição do texto. ### Exemplo Aqui está um exemplo que usa vários `\marginpar` comandos para demonstrar algumas das funcionalidades listadas acima. O exemplo também carrega o [`geometry`](https://ctan.org/pkg/geometry) pacote para criar um tamanho de página pequeno e o [`hyperref`](https://ctan.org/pkg/hyperref) pacote que fornece o `\url` comando usado para citar a fonte do texto (na nota de rodapé). ```latex \documentclass[twoside]{article} % Nota: usa a opção twoside \usepackage[a4paper, marginparwidth=75pt, total={10cm, 10cm}]{geometry} % Para criar uma página pequena \usepackage{hyperref} % Para usar o comando \url (na nota de rodapé) \usepackage{marginnote} \begin{document} \section{Lorem Ipsum} \footnote{Texto-fonte: Wikipedia (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}Mas preciso explicar-vos como surgiu toda esta ideia errada de condenar o prazer e exaltar a dor. Para isso, dar-vos-ei um relato completo do sistema e exporei os verdadeiros ensinamentos do grande explorador da verdade, o grande construtor da felicidade humana. \marginpar[Nota 1: texto para o lado esquerdo]{Nota 1: texto para o lado direito das páginas, é composto com alinhamento justificado.} Ninguém rejeita, desgosta ou evita o prazer em si, porque é prazer, mas porque aqueles que não sabem como perseguir o prazer racionalmente deparam com consequências extremamente dolorosas. Também não há ninguém que ame, persiga ou deseje obter a dor por si mesma, porque é dor, mas ocasionalmente surgem circunstâncias em que o esforço e a dor lhe podem proporcionar algum grande prazer. \marginpar[Nota 2: texto para o lado esquerdo]{\raggedright Nota 2: texto para o lado direito das páginas, não é justificado, mas usa \texttt{\string\raggedright}.} Para tomar um exemplo trivial, qual de nós alguma vez empreende exercício físico árduo, exceto para obter dele alguma vantagem? Mas quem tem algum direito de criticar um homem que escolhe desfrutar de um prazer que não tem consequências incómodas, ou que evita uma dor que não produz prazer resultante? [33] Por outro lado, denunciamos com indignação justa e não gostamos de homens que são tão seduzidos e desmoralizados pelos encantos do prazer do momento, tão cegados pelo desejo, que não conseguem prever a dor e os problemas que inevitavelmente se seguirão; e igual culpa pertence àqueles que falham no seu dever por fraqueza de vontade, o que é o mesmo que dizer por fugirem do esforço e da dor. Estes casos são perfeitamente simples e fáceis de distinguir. Numa hora livre, quando o nosso poder de escolha está desimpedido e nada impede a nossa capacidade de fazer o que mais gostamos, todo prazer deve ser acolhido e toda dor evitada. \marginpar[\raggedleft Nota 3: texto para o lado esquerdo das páginas, não é justificado, mas usa \texttt{\string\raggedleft}]{Nota 3: texto para o lado esquerdo das páginas}Mas, em certas circunstâncias e devido às exigências do dever ou às obrigações dos negócios, ocorrerá frequentemente que os prazeres tenham de ser repudiados e os incómodos aceites. O homem sábio, portanto, mantém sempre nestas matérias este princípio de seleção: rejeita prazeres para assegurar outros prazeres maiores, ou então suporta dores para evitar dores piores. \end{document} ``` Abra este `\marginpar` exemplo no Overleaf Este exemplo produz o seguinte resultado (duas páginas): Página 1: ![Exemplo do comando \marginpar](/files/2da594183c6ea172bb835cf89d024111c8e40b56) Página 2: ![Exemplo do comando \marginpar](/files/5e56c3fd8a1e20421b5713564d7bdb429209ab3f) ### O pacote mparhack: corrigindo a margem errada Internamente, o LaTeX processa as notas marginais como um tipo de componente “flutuante” do seu documento — semelhante à forma como o LaTeX lida com figuras e tabelas flutuantes. Devido a serem "floats", as notas marginais produzidas por `\marginpar` podem ocasionalmente aparecer na margem errada. O [`mparhack` pacote](https://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/mparhack/mparhack.pdf) foi escrito para corrigir este problema, por isso pode valer a pena usá-lo se você encontrar isso. ## Uma alternativa ao \marginpar: o pacote marginnote O [`marginnote` pacote](https://www.ctan.org/pkg/marginnote) oferece uma alternativa versátil ao `\marginpar` comando. `marginnote` implementa notas marginais usando um mecanismo não flutuante, o que é diferente de como `\marginpar` funciona: `marginnote` resolve alguns problemas, mas, como a documentação observa, pode introduzir outros. ### Exemplo O exemplo a seguir demonstra o `\marginnote` comando fornecido pelo `marginnote` pacote: ```latex \documentclass{article} \usepackage[a5paper, total={3in, 6in}]{geometry} % para criar uma página pequena \usepackage{hyperref} % Para usar o comando \url (na nota de rodapé) \usepackage{marginnote} \begin{document} \section{Lorem Ipsum} \footnote{Texto-fonte: Wikipedia (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}Mas preciso explicar-vos como surgiu toda esta ideia errada de condenar o prazer e exaltar a dor. Para isso, dar-vos-ei um relato completo do sistema e exporei os verdadeiros ensinamentos do grande explorador da verdade, o grande construtor da felicidade humana. \marginnote{Esta é uma nota marginal deslocada 2 cm, \textit{para baixo} na página, relativamente à linha em que é composta.}[2cm] Ninguém rejeita, desgosta ou evita o prazer em si, porque é prazer, mas porque aqueles que não sabem como perseguir o prazer racionalmente deparam com consequências extremamente dolorosas. Também não há ninguém que ame, persiga ou deseje obter a dor por si mesma, porque é dor, mas ocasionalmente surgem circunstâncias em que o esforço e a dor lhe podem proporcionar algum grande prazer. \reversemarginpar\marginnote{Esta é outra nota marginal, mas deslocada 2 cm \textit{para cima} na página, relativamente à linha em que é composta. Também está na margem esquerda.}[-2cm] Para tomar um exemplo trivial, qual de nós alguma vez empreende exercício físico árduo, exceto para obter dele alguma vantagem? Mas quem tem algum direito de criticar um homem que escolhe desfrutar de um prazer que não tem consequências incómodas, ou que evita uma dor que não produz prazer resultante? [33] Por outro lado, denunciamos com indignação justa e não gostamos de homens que são tão seduzidos e desmoralizados pelos encantos do prazer do momento, tão cegados pelo desejo, que não conseguem prever a dor e os problemas que inevitavelmente se seguirão; e igual culpa pertence àqueles que falham no seu dever por fraqueza de vontade, o que é o mesmo que dizer por fugirem do esforço e da dor. Estes casos são perfeitamente simples e fáceis de distinguir. Numa hora livre, quando o nosso poder de escolha está desimpedido e nada impede a nossa capacidade de fazer o que mais gostamos, todo prazer deve ser acolhido e toda dor evitada. Mas, em certas circunstâncias e devido às exigências do dever ou às obrigações dos negócios, ocorrerá frequentemente que os prazeres tenham de ser repudiados e os incómodos aceites. O homem sábio, portanto, mantém sempre nestas matérias este princípio de seleção: rejeita prazeres para assegurar outros prazeres maiores, ou então suporta dores para evitar dores piores. \end{document} ``` Abra este exemplo no Overleaf Este exemplo produz a seguinte saída: ![Usando o pacote marginnote](/files/e69749cbdd6f446ce67a1bd050494f7e60f93158) O exemplo acima também carrega o `geometry` pacote para criar um tamanho de página pequeno e o `hyperref` pacote que fornece o `\url` comando usado para citar a fonte do texto (na nota de rodapé). Depois de importar o `marginnote` pacote escrevendo `\usepackage{marginnote}` você pode usar o `\marginnote` comando, como mostrado pelas duas ocorrências no texto de exemplo: * `\marginnote{Esta é uma nota marginal deslocada 2 cm, \textit{para baixo} na página, relativamente à linha em que é composta.}[2cm]` * `\marginnote{Esta é outra nota marginal, mas deslocada 2 cm \textit{para cima} na página, relativamente à linha em que é composta. Também está na margem esquerda.}[-2cm]` Nestes exemplos, usamos um segundo parâmetro entre colchetes `[ ]` que determina o alinhamento vertical em relação à linha em que o comando é usado. O primeiro `\margingnote` o comando usa `[2cm]` para deslocar a nota marginal 2 cm *para baixo na página*, o segundo usa `[-2cm]` para deslocar a nota marginal 2 cm *para cima na página*. O segundo `\marginnote` comando atua após ter sido usado um `\reversemarginpar` ter sido usado, fazendo com que ele seja colocado na margem esquerda deste documento de um só lado: ```latex \reversemarginpar\marginnote{Esta é outra nota marginal, mas deslocada 2 cm \textit{para cima} na página, relativamente à linha em que é composta. Também está na margem esquerda.}[-2cm] ``` ## Leitura adicional Para mais informações, veja * [O `marginnote` documentação do pacote](http://www.ctan.org/pkg/marginnote) * [O `mparhack` documentação do pacote](http://www.ctan.org/pkg/mparhack) * [Tamanho da página e margens](/latex/overleaf-learn-latex-pt/formatacao/07-page-size-and-margins.md) * [Notas de rodapé](/latex/overleaf-learn-latex-pt/formatacao/14-footnotes.md) * [Comprimentos em LaTeX](/latex/overleaf-learn-latex-pt/formatacao/01-lengths-in-latex.md) * [Documentos de uma face e de dupla face](/latex/overleaf-learn-latex-pt/formatacao/08-single-sided-and-double-sided-documents.md) * [Múltiplas colunas](/latex/overleaf-learn-latex-pt/formatacao/09-multiple-columns.md) * [Cabeçalhos e rodapés](/latex/overleaf-learn-latex-pt/formatacao/02-headers-and-footers.md) * [Formatação de parágrafos](/latex/overleaf-learn-latex-pt/formatacao/04-articles-how-to-change-paragraph-spacing-in-latex.md) * [Negrito, itálico e sublinhado](/latex/overleaf-learn-latex-pt/nocoes-basicas-de-latex/03-bold-italics-and-underlining.md) * [Tamanhos, famílias e estilos de fonte](/latex/overleaf-learn-latex-pt/fontes/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/overleaf-learn-latex-pt/formatacao/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.