PDF 하이퍼링크를 위해서는 HyperRef 패키지를 이용한다.

[[TableOfContents]]

== hyper-참조 ==
=== `\href` 명령 ===
{{{
\href{URL}{text}
}}}
 * URL은 Full URL이어야 한다. 예를 들면, http://www.ktug.or.kr/. 또, `~` 문자와 `#` 문자는 LaTeX의 사용방식으로 쓰이지 않고 URL의 일부로 받아들여진다.
 * `baseurl` 옵션을 설정한 경우라면 baseurl에 대한 상대 주소 입력이 가능하다.
 {{{
\hypersetup{baseurl={http://www.ktug.or.kr}}
}}}
 {{{
\href{document.php}{KTUG Documents}
}}}
 * `baseurl`을 설정할 때 `\hyperbaseurl{URL}` 명령을 쓸 수도 있다.
 * href 를 이용하여 인터넷 뿐만 아니라 로컬 디렉토리에 있는 파일도 연결하는 것이 가능하다. 로컬 디렉토리의 경우 상대 경로를 지정하는 것이 가능하다. 
  * 상대 디렉토리를 지정하는 경우 경우 {{{ \usepackage[dvipdfm]{hyperref} }}} 처럼 드라이버를 지정해 주어야 한다. 
  * 실제 사용은 다음과 같다. {{{ 예제 파일을 보려면 \href{./example/heading1.pdf}{예제파일}를 참고하기 바란다 }}}

=== `\hyperref` 명령 ===
이 명령은 주로 내부 명령으로 쓰이지만 필요하다면 다음 형식으로 사용하는 것이 가능하다.
{{{
\hyperref{URL}{category}{name}{text}
}}}
 * ''text''는 `URL#category.name`을 참조하여 링크된다.

=== `\hypertarget`과 `\hyperlink` ===
임의의 텍스트 위치에 하이퍼링크될 타겟을 만들고 그것을 참조할 수 있다.
{{{
\hyperlink{myhptarget}{see MyTarget}
.........
\hypertarget{myhptarget}{text} will be referred and linked.
}}}

=== `\url` 명령 ===

== Colorlink ==
HyperRef 패키지의 옵션 또는 `\hypersetup` 옵션으로 colorlink가 켜져(true) 있다면 링크되는 위치의 색상을 설정할 수 있다. 다음은 링크 칼러 관련 옵션과 기본값이다.

|| 색상 확장 옵션 || 기본값 || Description ||
|| linkcolor || red || normal links ||
|| anchorcolor || black || anchor text ||
|| citecolor || green || bibliographic citations ||
|| filecolor || magenta || URL''''''s which open local files ||
|| menucolor || red || Acrobat menu items ||
|| pagecolor || red || links to other pages ||
|| urlcolor || cyan || linked URL''''''s ||

{{{
\hypersetup{%
   colorlinks=true,%
   citecolor=black,%
   pagecolor=black,%
   urlcolor=red,%
}
}}} 

== TIP : link to external file ==
=== xr-hyper ===
외부 PDF 파일의 특정 위치를 참조(\ref, \pageref)하려 하는 경우 사용합니다. KTUGOperate:8270.

외부 PDF 파일이 HyperRef을 이용해서 작성되었다면, xr-hyper.sty를 써서 문서간 참조가 가능합니다.
xr-hyper.sty는 hyperref 패키지와 함께 배포됩니다.
 <!> 이 문서간 상호참조 기능은 HyperRef의 드라이버에 민감합니다. 즉, DVIPDFMx로 PDF를 만들 것인지, PDFLaTeX을 이용할 것인지 아니면 GhostScript의 ps2pdf를 이용할 것인지를 미리 옵션으로 지시해두도록 합니다.

{{{
%%%-----참조되는 문서 linked.tex-----
\documentclass{article}
\usepackage{hyperref}
\begin{document}
\section{T2}
\begin{equation}
foo=bar
\end{equation}
\begin{equation}
1+1=2\label{eq:2}
\end{equation}
\end{document}
}}}

이 문서로부터 linked.pdf를 얻었고, 그것이 같은 디렉토리에 있다면, 다음과 같은 참조하는 문서 main.tex을 작성합니다.
 /!\ 만약 온라인 문서를 참조하려 한다면 주석처리한 행과 같이 그 문서의 위치를 지정할 수 있습니다.

{{{
%%======main.tex=========
\documentclass{article}
\usepackage{xr-hyper}
\usepackage[dvipdfm,bookmarks=false]{hyperref}
   %%% 반드시 드라이버를 밝혀줌. 이 드라이버 지정 옵션이 없으면 PDFLaTeX을 이용해야 함.
\externaldocument[x-]{linked}
   %%% [x-]를 붙이는 이유는 같은 문서 내에서 동일한 reference가 있을 경우 혼동을 피하기
   %%% 위해서이다.
%\externaldocument[x-]{linked}[http://myhost.mydomain/mydocument/linked.dvi]
   %%% 온라인 문서라면 위와 같이 URL을 모두 적어준다.
\begin{document}
\section{CROSS-DOCUMENT hyperlink}
\begin{equation}
1+0=1\label{eq:1}
\end{equation}
See \ref{eq:1} and in the other document \ref{x-eq:2}.
   %%% 외부 문서의 label이 eq:2 라면 이것을 부를 때 \ref{x-eq:2}와 같이
   %%% 호출한다. 위의 \externaldocument의 [x-] 선택인자를 지정하지
   %%% 않았다면 이 문서 내에 eq:2가 없어야 하고, 단순히 \ref{eq:2}와
   %%% 같이 부를 수 있다.
\end{document}
}}}

이제 main.pdf로부터 linked.pdf를 바로 링크할 수 있게 되었습니다.

=== xr-hyper 없이 외부 파일의 특정 위치 링크 ===
Q. 그러니까 xr-hyper를 이용하지 않고 외부에 있는 2 개의 pdf의 특정 페이지나 절을 링크할 수 있으면 합니다.(KTUGOperate:11899'''''')

A. 외부 PDF가 hyperref으로 만들어진 것이라면 가능할 듯합니다.

예제입니다. b.pdf에서 a.pdf를 부르는 것입니다.
{{{
%%-------------a.tex------------------------
\documentclass{article}
\usepackage{hangul-k}
\usepackage[dvipdfm,bookmarks=false]{hyperref}
\usepackage{color}
\begin{document}
\pagecolor{blue}
\section{참조되는 문서}
\hypertarget{omom}{엄마야} 나는 왜 자꾸만 보고 싶지
엄마야 나는 왜 자꾸만 생각나지

\clearpage
\pagecolor{red}
\section{참조될 문서 두번째 절}\label{sectwo}
\hypertarget{yourtarget}{여기가 참조점}
아마 나는 아직은 어린가봐 그런가봐
엄마야
엄마야

\clearpage
\pagecolor{green}
\hypertarget{hereistarget}{요기를 보세요}
하나둘셋
\end{document}
%%--------------------------------------------
}}}
{{{
%%-------------b.tex--------------------------
\documentclass{article}
%\usepackage{xr-hyper}
\usepackage{hangul-k}
\usepackage[dvipdfm,bookmarks=false]{hyperref}
%\externaldocument{a}
\begin{document}
\section{xr-hyper 없이 참조하기}
이 대목에서 우리는 \href{a.pdf#section.2}{외부문서의 제2절}을
참조하려 한다.
\textsf{xr-hyper} 없이 참조하는 것이 과연 가능하겠는가?
\begin{itemize}
\item 초록: \href{a.pdf#hereistarget}{요기를} 보세요라고 쓰여 있나요?
\item 빨강: \href{a.pdf#yourtarget}{여기는} 또 어떨는지?
\item 파랑: \href{a.pdf#omom}{맨처음 절}로 가보세요.
\end{itemize}

\end{document}
%%---------------------------------------------
}}}

----
CategoryFaq