AsciiDoc 도구
여기서는 AsciiDoc 문서를 미리 보고 편집하는 다양한 AsciiDoc 도구에 대하여 설명합니다.
AsciiDoc 구문은 일반 텍스트이므로 텍스트 편집기를 사용하여 AsciiDoc 문서를 작성할 수 있습니다.
2. IDE 및 텍스트 편집기
2.1. Visual Studio Code
-
"Visual Studio Code" 를 설치합니다.
-
VS Code를 실행한 후, 확장 기능 탭에서 "AsciiDoc"을 검색하여 설치합니다.
2.2. Eclipse
Eclipse에서 AsciiDoc을 사용하기 위해 AsciiDoc 문서를 작성하고 미리 보기할 수 있는 플러그인을 설치하는 방법을 안내하겠습니다. 가장 인기 있는 방법 중 하나는 "Asciidoctor Editor" 플러그인을 사용하는 것입니다. 이 플러그인을 통해 Eclipse 내에서 AsciiDoc 파일을 편집하고, 실시간 미리 보기를 볼 수 있습니다.
2.2.1. Eclipse Marketplace에서 설치하기
-
Eclipse를 실행하고, 상단 메뉴에서 Help > Eclipse Marketplace…를 선택합니다.
-
검색창에 "Asciidoctor Editor"를 입력하고 검색합니다.
-
나타난 결과 중 "Asciidoctor Editor"를 찾아 Install 버튼을 클릭합니다.
-
설치 마법사의 지시에 따라 설치를 완료하고, 필요한 경우 Eclipse를 재시작합니다.
-
또는 "Eclipse Marketplace"에서도 설치 가능
2.2.2. 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를 따라 설치 프로세스를 완료합니다.
3. Hosted git repositories
git 리포지토리 호스트인 GitHub와 GitLab은 AsciiDoc 파일 편집 및 미리보기를 지원합니다.
이 지원을 활성화하려면 파일에 지원되는 AsciiDoc 확장자(예: .adoc)가 있어야 합니다.
-
리포지토리 보기에서 AsciiDoc 파일을 찾으면 AsciiDoc 콘텐츠의 HTML 미리 보기가 표시됩니다. 해당 미리보기는 Asciidoctor에서 제공합니다.
-
렌더링되는 HTML은 기본 제공 HTML 변환기에서 생성된 포함된 출력입니다.
즉, Asciidoctor에서 생성 한 독립 실행 형 HTML 문서처럼 보이지 않습니다.
대신 HTML은 호스팅 서비스의 테마에 맞게 스타일이 지정되고 삭제되므로 페이지 렌더링에 영향을 주지 않습니다. 따라서, 특정 기능을 사용하지 못할 수 있습니다.
4. Web browser add-ons (미리보기 전용)
웹 브라우저에서 AsciiDoc 문서를 미리 보려면 "Chrome 확장 프로그램", "Edge 추가 기능", "Firefox 추가 기능" 또는 "Opera 확장 프로그램"(모두 동일한 코드 베이스에서 생성됨)을 설치합니다. 그런 다음 AsciiDoc 파일을 방문하기만 하면 HTML로 렌더링된 AsciiDoc 파일을 볼 수 있습니다.