Asciidoctor란

Asciidoctor란

Asciidoctor 는 AsciiDoc 문서를 HTML, PDF 및 기타 형식으로 변환하는 텍스트 프로세서 이다 . Ruby로 작성되었으며 RubyGem으로 패키징된다.

• 즉 Asciidoc 언어로 된 .adoc 파일을 만들어주거나 변환시켜주는 프로세서이다.
• AsciiDoc은 문서 작성에 매우 널리 사용되는 형식이므로 Ubuntu, Debian, Fedora 및 Arch와 같은 많은 GNU Linux 배포판에서 Asciidoctor를 표준 패키지로 쉽게 찾을 수 있다.

또한 Asciidoctor에는 AsciiDoc 으로 작성된 콘텐츠를 작성하고 게시하는 데 도움이 되는 extension, translator, 빌드 플러그인 및 도구로 구성된 생태계가 있다 . https://docs.asciidoctor.org 에서 이러한 프로젝트에 대한 문서를 찾을 수 있다 .

Ruby에서 실행하는 것 외에도 Asciidoctor는 AsciidoctorJ를 사용하여 JVM에서 실행하거나 Asciidoctor.js를 사용하여 JavaScript 환경에서 실행할 수 있다 .

• 즉 다음과 같은 환경에서 사용 할 수 있다.
  • ruby
  • js
  • jvm

 

공식 홈페이지는 다음과 같다

• 공식 홈페이지
• 깃허브
• 공식 documentation
• JVM에서 사용할 수 있는 asciidoctorj 깃허브

Spring Rest Docs 에서 기본 정책으로 Asciidoc을 사용한다.

참조

• https://www.baeldung.com/asciidoctor