> 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/ko/document-structure/09-hyperlinks.md). # 하이퍼링크 LaTeX는 인쇄용 전문적인 문서를 만드는 데 매우 좋은 도구이지만, 뛰어난 탐색 도구를 갖춘 PDF 파일을 생성하는 데도 사용할 수 있습니다. 이 문서에서는 문서에 하이퍼링크를 만드는 방법과, PDF 리더에서 볼 수 있도록 LaTeX 문서를 설정하는 방법을 설명합니다. ## 소개 먼저 최소 동작 예제를 시작해 보겠습니다. 단순히 다음을 불러와서 **hyperref** 패키지를 모두 [상호 참조된 요소들이](/latex/ko/document-structure/03-cross-referencing-sections-equations-and-floats.md) 하이퍼링크가 됩니다. ```latex \documentclass{book} \usepackage{blindtext} \usepackage{hyperref} \title{하이퍼링크 예제} \author{Overleaf} \begin{document} \frontmatter \tableofcontents \clearpage \addcontentsline{toc}{chapter}{서문} {\huge {\bf 서문}} \Blindtext \clearpage \addcontentsline{toc}{chapter}{더미 항목} {\huge {\bf 더미 항목}} \Blindtext \mainmatter \chapter{First Chapter} 이것은 빈 장이 될 것입니다 \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} 방정식 \ref{eq:1}는 발산하는 합을 보여줍니다. 이 공식은 나중에 \pageref{second} 페이지에서 사용됩니다. \Blindtext \clearpage \section{두 번째 절} \label{second} \blindtext \Blinddocument \end{document} ``` [이 예제를 `hyperref` Overleaf의 예](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+hyperref+example\&snip=%5Cdocumentclass%7Bbook%7D%0A%5Cusepackage%7Bblindtext%7D%0A%5Cusepackage%7Bhyperref%7D%0A%0A%5Ctitle%7BExample+of+Hyperlinks%7D%0A%5Cauthor%7BOverleaf%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cfrontmatter%0A%5Ctableofcontents%0A%5Cclearpage%0A%0A%5Caddcontentsline%7Btoc%7D%7Bchapter%7D%7BForeword%7D%0A%7B%5Chuge+%7B%5Cbf+Foreword%7D%7D%0A%0A%5CBlindtext%0A%5Cclearpage%0A%0A%5Caddcontentsline%7Btoc%7D%7Bchapter%7D%7BDummy+entry%7D%0A%7B%5Chuge+%7B%5Cbf+Dummy+entry%7D%7D%0A%0A%5CBlindtext%0A%5Cmainmatter%0A%0A%5Cchapter%7BFirst+Chapter%7D%0A%0AThis+will+be+an+empty+chapter%0A%0A%5Cbegin%7Bequation%7D%0A%5Clabel%7Beq%3A1%7D%0A%5Csum_%7Bi%3D0%7D%5E%7B%5Cinfty%7D+a_i+x%5Ei%0A%5Cend%7Bequation%7D%0A%0AThe+equation+%5Cref%7Beq%3A1%7D+shows+a+sum+that+is+divergent.+This+formula+will+be+used+later+on+page+%5Cpageref%7Bsecond%7D.%0A%0A%5CBlindtext%0A%5Cclearpage%0A%0A%5Csection%7BSecond+section%7D+%5Clabel%7Bsecond%7D%0A%0A%5Cblindtext%0A%5CBlinddocument%0A%5Cend%7Bdocument%7D) ![하이퍼레프 예제 문서](/files/5753903405443eb49b3393a5cb05ce81fbe209ad) 문서의 서문에 다음 줄을 단순히 추가하면 목차의 항목들이 문서의 해당 페이지로 연결되는 링크가 됩니다. ```latex \usepackage{hyperref} ``` 다음을 불러올 때는 주의해야 합니다 `hyperref`: 일반적으로는 불러와야 하는 마지막 패키지여야 합니다. 하지만 이 규칙에는 몇 가지 예외가 있을 수 있습니다. ## 스타일과 색상 링크의 기본 서식을 변경하여 문서의 정보가 더 명확하게 표시되도록 할 수 있습니다. 아래에서 예제를 볼 수 있습니다: ```latex \documentclass{book} \usepackage{hyperref} \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Overleaf Example}, pdfpagemode=FullScreen, } \urlstyle{same} \begin{document} \tableofcontents \chapter{First Chapter} 이것은 빈 장이 될 것이며 여기에는 몇몇 텍스트를 넣겠습니다 \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} 방정식 \ref{eq:1}는 발산하는 합을 보여줍니다. 이 공식은 나중에 \pageref{second} 페이지에서 사용됩니다. 추가 참조는 \href{http://www.overleaf.com}{무언가 Linky}를 보거나 다음 URL로 이동하세요: \url{http://www.overleaf.com} 또는 열기 다음 파일 \href{run:./file.txt}{File.txt} 또한 어떤 단어나 \hyperlink{thesentence}{어떤 문장}도 문서에서 직접 링크하는 것이 가능합니다. \end{document} ``` [다음의 예제를 열어 보세요 `hyperref` Overleaf의 패키지](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Another+hyperref+example\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ![HyperrefEx2OverleafVa.png](/files/65a746c82fa4ec15c94e81332c348931d3d3c1f5) ![HyperrefEx2OverleafVb.png](/files/4f45e95415729a866f9676d6da372b17ea4929a0) 이것은 완전한 예제이며, 이 문서의 나머지 부분에서 자세히 설명할 것입니다. 아래에는 링크의 색상과 스타일과 관련된 명령에 대한 설명이 나와 있습니다. **\hypersetup{ ... }** 이것은 문서 내 링크의 동작을 설정하는 옵션을 지정합니다. 각 매개변수는 반드시 쉼표로 구분되어야 하며, 구문은 parameter=value 형식이어야 합니다. **colorlinks=true** 링크에 색상이 적용되며, 기본 색상은 빨간색입니다. **linkcolor=blue** 상호 참조된 요소로 생성된 내부 링크는 파란색으로 표시됩니다. **filecolor=magenta** 로컬 파일로 연결되는 링크는 자홍색으로 표시됩니다(로컬 파일 연결 참조). **urlcolor=cyan** 웹 사이트로 연결되는 링크는 청록색으로 설정됩니다(웹 주소 연결 참조). **urlstyle{same}** 기본 설정에서는 링크가 고정폭 간격 글꼴로 출력되며, 이 명령은 이를 변경하여 링크를 나머지 텍스트와 같은 스타일로 표시합니다. ## 웹 주소 연결 웹 주소나 이메일 링크는 LaTeX 파일에 다음을 사용하여 추가할 수 있습니다 `\url` 명령으로 실제 링크를 표시하거나 `\href` 숨겨진 링크를 사용하여 대신 단어나 문장을 표시할 수 있습니다. ```latex 추가 참조는 \href{http://www.overleaf.com}{무언가 Linky}를 보세요 또는 다음 URL로 이동하세요: \url{http://www.overleaf.com} ``` ![HyperlinkExampleUpdatedMore.png](/files/746671618087d528df9ed003b8efc82daaa633d9) 예제에는 최종 문서에서 링크를 생성하는 두 개의 명령이 있습니다: **\href{ Linky}** 이 명령에는 두 개의 매개변수가 전달되는데, 첫 번째는 링크의 URL이며, 이 경우 , 두 번째는 클릭 가능한 표시 텍스트이며, 무언가 Linky입니다. **\url{** 이 명령은 매개변수로 전달된 URL을 표시하고 이를 링크로 만들어 줍니다. 문서를 인쇄할 경우 유용합니다. [Overleaf에서 hyperref 패키지 예제 열기](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## 로컬 파일 연결 이전 섹션에서 소개한 `\href` 및 `\url` 명령은 로컬 파일을 여는 데 사용할 수 있습니다 ```latex 추가 참조는 \href{http://www.overleaf.com}{무언가 Linky}를 보세요 또는 다음 URL로 이동하세요: \url{http://www.overleaf.com} 또는 다음을 여세요 파일 \href{run:./file.txt}{File.txt} ``` ![HyperlinkExampleUpdatedMoreNext.png](/files/4412ead52234755ff5794e626a11251a02d2b94f) 명령은 `\href{run:./file.txt}{File.txt}` 텍스트 `File.txt` 라는 로컬 파일에 연결되며 `file.txt` 현재 작업 디렉터리에 있습니다. 텍스트 `run:` 가 파일 경로 앞에 온다는 점에 주목하세요. 파일 경로는 UNIX 시스템의 규칙을 따르며, `.` 는 현재 디렉터리를 가리키고 `..` 는 이전 디렉터리를 가리킵니다. 명령은 `\url{}` 도 경로에 대해 설명한 것과 같은 구문으로 사용할 수 있지만, 몇 가지 문제가 있다고 보고됩니다. [Overleaf에서 hyperref 패키지 예제 열기](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## 링크를 수동으로 삽입하기 이전에 상호 참조된 모든 요소는 한 번 **hyperref** 가 불러와지면 링크가 된다고 언급했습니다. 따라서 우리는 `\label` 문서의 어디에서나 사용할 수 있고, 나중에 해당 레이블을 참조하여 링크를 만들 수 있습니다. 이것이 하이퍼링크를 수동으로 삽입하는 유일한 방법은 아닙니다. ```latex 또한 어떤 단어나 또는 \hyperlink{thesentence}{어떤 문장}도 문서의 어느 곳에서나 직접 링크할 수 있습니다. 이 텍스트를 읽는다면, 아무 정보도 얻지 못할 것입니다. 정말인가요? 정말 정보가 없나요? 예를 들어 \hypertarget{thesentence}{이 문장}입니다. ``` ![HyperlinkExampleUpdatedMoreNextAgain.png](/files/7f7cd15f636efb4cf13d8f3ada7746a4d4c08eeb) 사용자 정의 링크를 만드는 명령은 두 가지가 있습니다. **\hypertarget{thesentence}{이 문장}** 이 명령의 중괄호 안에 전달되는 첫 번째 매개변수는 이 문장을 위한 고유 식별자입니다. 두 번째 매개변수는 "이 문장"이라는 텍스트이며, (anchorcolor 값에 따라, 참고 안내서를 보세요) 일반적으로 출력되지만, 식별자 "thesentence"를 가리키는 링크를 클릭하면 PDF 파일이 이 지점으로 스크롤됩니다. **\hyperlink{thesentence}{어떤 문장}** 이 명령은 "어떤 문장"이라는 텍스트를 클릭 가능한 요소로 출력하며, 식별자가 "thesentence"인 지점으로 이동시킵니다. [Overleaf에서 hyperref 패키지 예제 열기](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=\&mainFile=main.tex) ## PDF 관련 옵션 문서의 링크는 PDF 형식으로 읽힐 문서를 염두에 두고 만들어집니다. PDF 파일은 추가 정보를 넣고 PDF 뷰어가 표시하는 방식을 바꾸도록 더 개인화할 수 있습니다. 아래는 예제입니다: ```latex \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Overleaf Example}, pdfpagemode=FullScreen, } ``` ![Pdftitle.png](/files/003c65ef8f76fd04727439e65e79b265faf361c4) 명령을 사용하면 `\hypersetup`을(를), 다음 섹션에서 설명한 [스타일과 색상](#styles-and-colours)에서 추가 매개변수를 받아 최종 PDF 파일을 설정할 수 있습니다. **pdftitle={Overleaf Example}** 창의 제목 표시줄에 표시될 PDF 출력 파일의 제목입니다. 예제에서는 "Overleaf Example"입니다. **pdfpagemode=FullScreen** 문서는 PDF 리더에 의해 전체 화면 모드로 열립니다. 다음을 참조하세요 [참조 안내서](#reference-guide) 에 전달될 수 있는 전체 옵션 목록은 `\hypersetup`. [Overleaf에서 hyperref 패키지 예제 열기](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## 참조 안내서 **링크 스타일 옵션** | 옵션 | 기본값 | 설명 | | ------------- | ------- | --------------------------------------- | | `hyperindex` | true | 색인 항목의 페이지 번호를 하이퍼링크로 만듭니다 | | `linktocpage` | false | 목차에서 텍스트 대신 페이지 번호가 링크가 되게 합니다. | | `breaklinks` | false | 링크가 여러 줄로 나뉘는 것을 허용합니다. | | `colorlinks` | false | 링크와 앵커의 텍스트에 색상을 적용하며, 이 색상은 인쇄본에 나타납니다 | | `linkcolor` | red | 일반 내부 링크의 색상 | | `anchorcolor` | black | 앵커(대상) 텍스트의 색상 | | `citecolor` | green | 문헌 인용의 색상 | | `filecolor` | cyan | 로컬 파일을 여는 링크의 색상 | | `urlcolor` | magenta | 연결된 URL의 색상 | | `frenchlinks` | false | 링크에 색상 대신 스몰 캡스를 사용합니다 | **PDF 관련 옵션** | 옵션 | 기본값 | 설명 | | ----------------- | ------- | --------------------------------------------------------------------------- | | `bookmarks` | true | 목차와 유사하게 Acrobat 책갈피가 작성됩니다. | | `bookmarksopen` | false | 책갈피가 모든 하위 트리가 펼쳐진 상태로 표시됩니다. | | `citebordercolor` | 0 1 0 | 인용 주변 상자의 RGB 형식 색상입니다. | | `filebordercolor` | 0 .5 .5 | 파일 링크 주변 상자의 RGB 형식 색상입니다. | | `linkbordercolor` | 1 0 0 | 일반 링크 주변 상자의 RGB 형식 색상입니다. | | `menubordercolor` | 1 0 0 | 메뉴 링크 주변 상자의 RGB 형식 색상입니다. | | `urlbordercolor` | 0 1 1 | URL 링크 주변 상자의 RGB 형식 색상입니다. | | `pdfpagemode` | empty | 파일이 어떻게 열릴지를 결정합니다. 가능한 값은 UseThumbs(축소판), UseOutlines(책갈피), FullScreen입니다. | | `pdftitle` | | 문서 제목을 설정합니다. | | `pdfauthor` | | 문서 작성자를 설정합니다. | | `pdfstartpage` | 1 | PDF 파일이 어느 페이지에서 열릴지 결정합니다. | ## 추가 읽을거리 자세한 정보는 * [목차](/latex/ko/document-structure/02-table-of-contents.md) * [섹션과 장](/latex/ko/document-structure/01-sections-and-chapters.md) * [섹션과 방정식의 상호 참조](/latex/ko/document-structure/03-cross-referencing-sections-equations-and-floats.md) * [LaTeX에서 색상 사용](/latex/ko/formatting/13-using-colors-in-latex.md) * [대규모 프로젝트에서의 관리](/latex/ko/document-structure/07-management-in-a-large-project.md) * [Hyperref 설명서](http://repositorios.cpai.unb.br/ctan/macros/latex/contrib/hyperref/doc/manual.pdf) * [위키북스의 하이퍼링크 문서](http://en.wikibooks.org/wiki/LaTeX/Hyperlinks) --- # 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/ko/document-structure/09-hyperlinks.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.