links.adoc

= Links Sample
Gildong Hong <email1@bwg.com>
:description: The document's description. This document is about the links sample.
include::../attributes/common_attrs.adoc[]
include::../attributes/dir_attrs.adoc[]

[abstract]
.문서개요
--
This document has a header that specifies the {doctitle}.
This document is about the links.
--

== 자동 링크
* http
* https
* ftp
* irc
* mailto
----
The homepage for the Asciidoctor Project is https://www.asciidoctor.org.
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.
----

* 결과
+
====
The homepage for the Asciidoctor Project is https://www.asciidoctor.org.
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.
====

=== 링크 속성
* 빈 창을 대상으로 지정하도록 링크 텍스트 끝에 캐럿(^) 삽입 및 role 적용
** pass:[Chat with other AsciiDoc users in the https://chat.asciidoc.org[*project chat*^,role=green].]
*** 결과
+
====
Chat with other AsciiDoc users in the https://chat.asciidoc.org[*project chat*^,role=green].
====

* 링크 텍스트에 쉼표나 등호가 포함된 경우 큰따옴표로 묶어준다.
** pass:[https://example.org["Google, DuckDuckGo, Ecosia"^,role=teal]]
*** 결과
+
====
https://example.org["Google, DuckDuckGo, Ecosia"^,role=teal]
====
** pass:[https://example.org["1=2 posits the problem of inequality"^]]
*** 결과
+
====
https://example.org["1=2 posits the problem of inequality"^]
====

* URL에 밑줄(_) 또는 캐럿(^)과 같은 문자가 포함된 경우 ++ 로 감싼다.
** pass:[link:+++https://asciidoctor.org/now_this__link_works.html+++[문제 URL^]]
*** 결과
+
====
link:+++https://asciidoctor.org/now_this__link_works.html+++[문제 URL^]
====

* 링크를 클릭하면 이메일 클라이언트가 제목 줄에 "Subscribe me"를 입력한다.
** pass:[mailto:join@discuss.example.org[Subscribe,Subscribe me]]
*** 결과
+
====
mailto:join@discuss.example.org[Subscribe,Subscribe me]
====
** pass:[mailto:join@discuss.example.org[,Subscribe me]]
*** 결과
+
====
mailto:join@discuss.example.org[,Subscribe me]
====

== 상호 참조
=== 자동 앵커
AsciiDoc 프로세서는 모든 섹션 및 개별 제목에 대한 앵커를 자동으로 생성.

.자동 생성 규칙
* 인라인 서식 적용(제목 대체 순서).
* 모든 문자는 소문자로 변환
* 공백, 하이픈 및 마침표는 idseparator 특성의 값으로 대체(기본값)_
* 반복되는 구분 기호 문자 압축
* 필요한 경우 ID가 문서 내에서 고유할 때까지 시퀀스 번호 추가
====
== Auto Section
=> _auto_section

== Wiley & Sons, Inc.
=> _wiley_sons_inc
====
* 자동 섹션 ID 생성 비활성화
+
----
:!sectids:
== ID generation off
:sectids:

== ID generation on again
----

=== 수동 앵커
* 첫 번째 문자는 문자, 콜론 또는 밑줄
* 선택적 다음 문자는 문자, 콜론, 밑줄, 하이픈, 마침표 또는 숫자
* ID에 공백 문자를 사용 불가
* 가능하면 소문자를 사용
----
[#manual_id]
Manually set id
----

** 결과
+
====
[#manual_id]
Manually set id
====

=== 내부 상호 참조
* 대상 섹션의 ID를 사용한 상호 참조
+
----
The section <<_자동_앵커,Auto>> describes how automatic anchors work.
The section <<manual_id,Manual>> describes how manual anchors work.
----

** 결과
+
====
The section <<_자동_앵커,Auto>> describes how automatic anchors work.
The section <<manual_id,Manual>> describes how manual anchors work.
====

=== 문서간 상호 참조
문서 간 상호 참조에 대한 링크 텍스트는 (현재) 필수
----
Refer to xref:./section.adoc#_section_a[Section A] for more information.
----

* 결과
+
====
Refer to xref:./section.adoc#_section_a[Section A] for more information.
====

=== 각주
* 문장 부호 바로 뒤에 각주 매크로(pass:[footnote:[text]])를 삽입합니다.
** 각주 매크로는 단일 콜론(:)만 사용
** 대괄호([]) 안에 각주의 내용 입력. 멀티라인 가능
* 각주를 재사용하려는 경우 대상 위치에 고유 ID 지정
** pass:[footnote:id[text]]
* 기존 각주를 참조하려면 대상 슬롯에 각주의 ID만 지정하고 빈대괄호 사용
** pass:[footnote:id[]]
----
The hail-and-rainbow protocol can be initiated at five levels:

. doublefootnote:[The double hail-and-rainbow level makes my toes tingle.]
. tertiary
. supernumerary

A bold statement!footnote:disclaimer[Opinions are my own.]
Another outrageous statement.footnote:disclaimer[]
----
* 결과
+
====
The hail-and-rainbow protocol can be initiated at five levels:

. doublefootnote:[The double hail-and-rainbow level makes my toes tingle.]
. tertiary
. supernumerary

A bold statement!footnote:disclaimer[Opinions are my own.]
Another outrageous statement.footnote:disclaimer[]
====