= AsciiDoc 도구
Heywon Choi <heywon.choi@bankwareglobal.com>
:description: This document is about the conversion of documents.
include::../attributes/common_attrs.adoc[]
include::../attributes/dir_attrs.adoc[]
include::../attributes/common_css.adoc[]

:source-highlighter: pygments
:pygments-style: manni
:pygments-linenums-mode: inline

[abstract]
.문서개요
--
여기서는 AsciiDoc 문서를 미리 보고 편집하는 다양한 {doctitle} 에 대하여 설명합니다.
AsciiDoc 구문은 일반 텍스트이므로 텍스트 편집기를 사용하여 AsciiDoc 문서를 작성할 수 있습니다.
--

== IDE 및 텍스트 편집기
=== Visual Studio Code
. https://code.visualstudio.com/[Visual Studio Code^] 를 설치합니다.
. VS Code를 실행한 후, 확장 기능 탭에서 "AsciiDoc"을 검색하여 설치합니다.

=== Eclipse
Eclipse에서 AsciiDoc을 사용하기 위해 AsciiDoc 문서를 작성하고 미리 보기할 수 있는 플러그인을 설치하는 방법을 안내하겠습니다. 가장 인기 있는 방법 중 하나는 "Asciidoctor Editor" 플러그인을 사용하는 것입니다. 이 플러그인을 통해 Eclipse 내에서 AsciiDoc 파일을 편집하고, 실시간 미리 보기를 볼 수 있습니다.

==== Eclipse Marketplace에서 설치하기
. Eclipse를 실행하고, 상단 메뉴에서 Help > Eclipse Marketplace...를 선택합니다.
. 검색창에 "Asciidoctor Editor"를 입력하고 검색합니다.
. 나타난 결과 중 "Asciidoctor Editor"를 찾아 Install 버튼을 클릭합니다.
. 설치 마법사의 지시에 따라 설치를 완료하고, 필요한 경우 Eclipse를 재시작합니다.

// -
* 또는 https://marketplace.eclipse.org/content/asciidoctor-editor[Eclipse Marketplace^]에서도 설치 가능


==== Update Site를 통해 설치하기
특정 버전의 플러그인을 설치하고자 할 때 또는 Marketplace에서 찾을 수 없는 경우 Update Site를 사용할 수 있습니다.

. Eclipse에서 Help > Install New Software...를 선택합니다.
. "Work with" 입력란에 Asciidoctor Editor의 Update Site URL을 입력합니다. 
+
----
https://de-jcup.github.io/update-site-eclipse-asciidoctor-editor/update-site/​
----
Asciidoctor Editor의 GitHub 페이지 또는 공식 문서에서 최신 URL을 찾을 수 있습니다.

. 목록에서 "Asciidoctor Editor"를 선택하고 Next > Finish를 따라 설치 프로세스를 완료합니다.

==== 문서 작성 및 미리 보기
* **문서 작성**: 설치가 완료되면, Eclipse에서 새로운 AsciiDoc 파일(.adoc)을 생성하고 문서를 작성할 수 있습니다.
* **미리 보기**: Asciidoctor Editor를 사용하면, AsciiDoc 문서를 작성하는 동안 자동으로 실시간 미리 보기를 볼 수 있습니다. 일부 설정이나 특정 미리 보기 기능은 플러그인 설정에서 조정할 수 있습니다.

== Hosted git repositories
git 리포지토리 호스트인 GitHub와 GitLab은 AsciiDoc 파일 편집 및 미리보기를 지원합니다.
이 지원을 활성화하려면 파일에 지원되는 AsciiDoc 확장자(예: .adoc)가 있어야 합니다.

* 리포지토리 보기에서 AsciiDoc 파일을 찾으면 AsciiDoc 콘텐츠의 HTML 미리 보기가 표시됩니다. 해당 미리보기는 Asciidoctor에서 제공합니다.
* 렌더링되는 HTML은 기본 제공 HTML 변환기에서 생성된 포함된 출력입니다.
즉, Asciidoctor에서 생성 한 독립 실행 형 HTML 문서처럼 보이지 않습니다.
대신 HTML은 호스팅 서비스의 테마에 맞게 스타일이 지정되고 삭제되므로 페이지 렌더링에 영향을 주지 않습니다. 따라서, 특정 기능을 사용하지 못할 수 있습니다.

== Web browser add-ons (미리보기 전용)
웹 브라우저에서 AsciiDoc 문서를 미리 보려면 https://chromewebstore.google.com/detail/asciidoctorjs-live-previe/iaalpfgpbocpdfblpnhhgllgbdbchmia?pli=1[Chrome 확장 프로그램^], https://microsoftedge.microsoft.com/addons/detail/asciidoctorjs-live-previ/pefkelkanablhjdekgdahplkccnbdggd[Edge 추가 기능^], https://addons.mozilla.org/en-US/firefox/addon/asciidoctorjs-live-preview/[Firefox 추가 기능^] 또는 https://addons.opera.com/en/extensions/details/asciidoctorjs-live-preview/[Opera 확장 프로그램^](모두 동일한 코드 베이스에서 생성됨)을 설치합니다. 그런 다음 AsciiDoc 파일을 방문하기만 하면 HTML로 렌더링된 AsciiDoc 파일을 볼 수 있습니다.