VSCode에서 선행 태그가 있는 AsciiDoc 처리

Jekyll이나 Hugo 등으로 Asciidoc이나 Markdown을 쓸 때, 때때로 파일의 시작 부분에 YAML을 넣는다.
전 임산부(front matter)라고 불리는 녀석이야.

---
title: hello
description: hello to the world
---

VSCode에서 이 선행 태그가 있는 Asciidoc를 처리할 때 여러 가지 설정이 기록되어 있습니다.
그나저나 설정이 순조로울 때의 캡처는 이런 느낌이다.

AsciiDoc 플러그인 설치

먼저 AsciiDoc용 플러그인을 설치합니다.

AsciiDoc - João Pinto
https://marketplace.visualstudio.com/items?itemName=joaompinto.asciidoctor-vscode

Ctrl + P 를 누르고 아래 명령을 누르면 설치할 수 있습니다.

ext install joaompinto.asciidoctor-vscode

일반적인 AsciiDoc 파일만 편집하면 이제 구문 하이라이트와 미리보기 기능을 사용할 수 있습니다.

asciidoctor 설치

선행 태그가 있는 AsciiDoc 파일의 경우 문법 하이라이트에 문제가 없는 것 같지만 미리 보기 기능이 제대로 실행되지 않습니다.
예를 들어, 다음과 같이 지정된 AsciiDoc 파일을 미리 보려면 오류가 발생합니다.

---
title: hello
description: hello to the world
---

:source-highlighter: coderay

= hello

A _hello world_ program in C can be writtern as follows:

[source,c]
----
int main(void) {
    printf("hello, world\n");
    return 0;
}
----

CodeRay: uninitialized constant CodeRay

플러그인은 내부에서 사용하는 Asciidoctor.js 프론트 예의를 잘 처리하지 못하기 때문에 본가Asciidoctor를 설치하여 사용하도록 합니다.
따라서 설치Asciidoctor.
설치는gem로 진행할 수 있습니다.

$ gem install asciidoctor

다음 명령을 통해 Asciidoctor가 설치되었습니다.

$ asciidoctor --version
Asciidoctor 1.5.6.2 [http://asciidoctor.org]
Runtime Environment (ruby 2.3.1p112 (2016-04-26) [x86_64-linux-gnu]) (lc:UTF-8 fs:UTF-8 in:- ex:UTF-8)

VS 코드 측면 설정

[File]-[Preferences]-[Setting]을 열고 다음 두 줄을 추적합니다.

    "AsciiDoc.use_asciidoctor_js": false,
    "AsciiDoc.asciidoctor_command": "asciidoctor -a skip-front-matter",

이렇게 VS 코드를 다시 시작하면 미리보기 기능도 문제없이 실행되어야 합니다.