Links Sample

문서개요

This document has a header that specifies the Links Sample.
This document is about the links.

1. 자동 링크

  • 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 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.

1.1. 링크 속성

  • 빈 창을 대상으로 지정하도록 링크 텍스트 끝에 캐럿(^) 삽입 및 role 적용

    • Chat with other AsciiDoc users in the https://chat.asciidoc.org[*project chat*^,role=green.]

      • 결과

        Chat with other AsciiDoc users in the project chat.

  • 링크 텍스트에 쉼표나 등호가 포함된 경우 큰따옴표로 묶어준다.

  • URL에 밑줄(_) 또는 캐럿(^)과 같은 문자가 포함된 경우 ++ 로 감싼다.

    • link:+++https://asciidoctor.org/now_this__link_works.html+++[문제 URL^]

  • 링크를 클릭하면 이메일 클라이언트가 제목 줄에 "Subscribe me"를 입력한다.

2. 상호 참조

2.1. 자동 앵커

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

자동 생성 규칙
  • 인라인 서식 적용(제목 대체 순서).

  • 모든 문자는 소문자로 변환

  • 공백, 하이픈 및 마침표는 idseparator 특성의 값으로 대체(기본값)_

  • 반복되는 구분 기호 문자 압축

  • 필요한 경우 ID가 문서 내에서 고유할 때까지 시퀀스 번호 추가

== Auto Section
⇒ _auto_section

== Wiley & Sons, Inc.
⇒ _wiley_sons_inc

  • 자동 섹션 ID 생성 비활성화

    :!sectids:
    == ID generation off
    :sectids:
    
    == ID generation on again

2.2. 수동 앵커

  • 첫 번째 문자는 문자, 콜론 또는 밑줄

  • 선택적 다음 문자는 문자, 콜론, 밑줄, 하이픈, 마침표 또는 숫자

  • ID에 공백 문자를 사용 불가

  • 가능하면 소문자를 사용

[#manual_id]
Manually set id
  • 결과

    Manually set id

2.3. 내부 상호 참조

  • 대상 섹션의 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 describes how manual anchors work.

2.4. 문서간 상호 참조

문서 간 상호 참조에 대한 링크 텍스트는 (현재) 필수

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

    Refer to Section A for more information.

2.5. 각주

  • 문장 부호 바로 뒤에 각주 매크로(footnote:[text])를 삽입합니다.

    • 각주 매크로는 단일 콜론(:)만 사용

    • 대괄호([]) 안에 각주의 내용 입력. 멀티라인 가능

  • 각주를 재사용하려는 경우 대상 위치에 고유 ID 지정

    • footnote:id[text]

  • 기존 각주를 참조하려면 대상 슬롯에 각주의 ID만 지정하고 빈대괄호 사용

    • 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:

    1. double[1]

    2. tertiary

    3. supernumerary

    A bold statement![2]
    Another outrageous statement.[2]


1. The double hail-and-rainbow level makes my toes tingle.
2. Opinions are my own.