= 링크와 참조
Heywon Choi <heywon.choi@bankwareglobal.com>

[abstract]
.문서개요
--
이 문서는 AsciiDoc 에서 {doctitle} 를 표현하는 방법에 대해 설명합니다.
--

== Link
문서에서 주소 지정 가능한 다른 리소스에 대한 링크(일명 하이퍼링크)를 만드는 다양한 방법을 제공한다.
[NOTE]
====
* 링크의 대상: 웹 주소라고도 하는 URL(Uniform Resource Locator)
* 링크 텍스트: 해당 대상으로 이동하기 위해 클릭하는 텍스트
====
문서에서 링크를 표현하기 위해서는 pass:[link:+++URL+++["링크 텍스트"]] 를 사용하고 결과물은 다음과 같다.

[#link_asciidoc_source]
=== AsciiDoc 소스
Link를 작성하는 AsciiDoc 소스는 다음과 같다.
[source,asciidoc]
----
The homepage for the Asciidoctor Project is link:+++https://asciidoctor.org/+++["AsciiDoctor Home"].
Email us at hello@example.com to say hello.

-- <1>
Once launched, the site will be available at \https://example.org.
If you cannot access the site, email \help@example.org for assistance.
--
----
<1> 자동 링크를 피하려면 URL앞에 \ 를 붙인다.

=== 결과
Link를 사용하는 경우 본문 형태는 다음과 같다.
****
The homepage for the Asciidoctor Project is link:++https://asciidoctor.org/++["AsciiDoctor Home"].
Email us at hello@example.com to say hello.


Once launched, the site will be available at \https://example.org.
If you cannot access the site, email \help@example.org for assistance.
****

== 상호 참조 (xref)
문서에서 상호 참조를 표현하기 위헤서는 pass:[xref:문서명#앵커ID["링크 텍스트"]] 를 사용하고 결과물은 다음과 같다.

=== AsciiDoc 소스
상호 참조를 작성하는 AsciiDoc 소스는 다음과 같다.
[source,asciidoc]
----
[#manual_id] <1>
Manually set id

[#link_asciidoc_source] <2>
=== AsciiDoc 소스

xref:15link.adoc#manual_id["Manual ID"] <3>
xref:15link.adoc#link_asciidoc_source["링크 AsciiDoc 소스"] <3>
----
<1> 앵커 설정
<2> 현 문서의 링크의 AsciiDoc 소스 섹션에 앵커 설정
<3> 참조 호출

[CAUTION]
====
.앵커 설정 규칙
* # 다음에 오는 첫 번째 문자는 소문자로 한다.
* 선택적 다음 문자는 소문자, 콜론, 밑줄, 하이픈, 마침표 또는 숫자여야 한다.
* ID에는 공백 문자를 사용할 수 없다.
====

=== 결과
상호 참조를 사용하는 경우 본문 형태는 다음과 같다.
****
[#manual_id]
Manually set id

xref:15link.adoc#manual_id["Manual ID"]
xref:15link.adoc#link_asciidoc_source["링크 AsciiDoc 소스"]
****
