아이콘 (Inline Image)

문서개요

이 문서는 AsciiDoc 에서 아이콘(Inline Image)을 표현하는 방법에 대해 설명합니다.

1. Inline Image

문서에서 아이콘을 표현하기 위해서는 image:파일명["대체 텍스트",너비]를 사용하고 결과물은 다음과 같다.

이미지 파일명 규칙

"모듈명_"을 접두어로 붙이고 파일명이 겹치지 않도록한다.
(예)
- concepts 모듈에서 사용되는 이미지
  - 접두어: concepts_
  - 파일명: concepts_overview.png
images 폴더 아래 하위 폴더가 있다면 "폴더명_"도 추가한다.
(예)
- concepts 모듈의 images 폴더 하위의 architecture 폴더의 이미지
  - 접두어: concepts_architecture_
  - 파일명: concepts_architecture_01.png

1.1. AsciiDoc 소스

아이콘을 사용하는 AsciiDoc 소스는 다음과 같다.

Click image:guide-like-bgbook_play.png["Play",20] to get the party started.

////
대상 이미지가 ROOT 모듈에 속한 경우 ROOT 모듈 좌표를 지정해야 한다.
형식: image:ROOT:target-image-filename.ext[optional attribute]
////
Click image:ROOT:ROOT_pause.png["Pause",20] when you need a break.

공통으로 사용되는 이미지는 ROOT 모듈을 이용하고 다른 모듈의 이미지를 직접 접근해서 사용하지 않는다.

1.2. 결과

아이콘을 사용하는 경우 본문 형태는 다음과 같다.

Click Play to get the party started.

Click Pause when you need a break.