Windows 10에서 Asciidoc(Ascidoctor)을 가져옵니다.VScode를 사용합니다.

AsciiDoc에 대해 물어보았기 때문에 가져오는 방법을 적어두고 싶습니다.

개요


1. Chocolatey 설치
2. Ruby 설치
3. Asciidoctor 설치
4. CodeRay 설치
5.VScode 확장 설치
6. 확장 설정
7. 사용해 보기

1. Chocolatey 설치


아래 내용을 참고하여 설치하십시오.
https://chocolatey.org/install
예전에 자기가 쓴 기사도 있으니까 영어로 잘 모르는 사람도 이쪽으로 오세요.
https://qiita.com/shiro01/items/a300b6d5b572a314ce5e

2. Ruby 설치


관리자 권한으로 명령 프롬프트를 시작하여 Chocolatey에 Ruby를 설치합니다.
> choco install ruby

> ruby -v
ruby 2.5.3p105 (2018-10-18 revision 65156) [x64-mingw32]
> gem -v
2.7.6
※ 루비 명령 또는gem 명령이 없는 경우(인식되지 않음) 명령 프롬프트를 다시 시작합니다.

3. Asciidoctor 설치, 4. CodeRay 설치


gem 명령을 사용하여 Asciidoctor 및 CodeRay를 설치합니다.
> gem install asciidoctor
> gem install coderay
코드 블록에 강조 표시하기 위해 CodeRay가 설치되었습니다.

5.VScode 확장 설치


이번에는 VScode의 확장 기능을 사용하여 미리보기를 보면서 편집하고 싶습니다.
※ 크롬과 파이어폭스도 확장 기능이 있어 넣으면 미리 볼 수 있습니다.
다음 확장자를 검색하고 설치합니다.
AsciiDoc

6. 확장 설정


초기 설정에서 미리보기에는 Asciidoctor가 있습니다.js를 사용하고 있습니다.
나에게 말한 사람은 행동이 이상할 때가 있기 때문에 루비 버전의 Asciidoctor로 바꿨다고 말했다.
AsciiDoc의 설명과 같이 settings.설정을 json에 추가합니다.
If you want to use the Ruby version of Asciidoctor
you need to change the AsciiDoc.use_asciidoctor_js setting to false.
"AsciiDoc.use_asciidoctor_js": false
아래도 같은 설정을 할 수 있다.
단축키Ctrl + ,로 설정 화면 열기
설정된 검색에'asciidoc'를 입력하고 표시된 설정 화면에서 아래의 검사를 빼고 설정합니다.
Ascii Doc: Use_asciidoctor_js
□ Use asciidoctor js instead of the 'html_generator'
이상은 설정입니다.

7. 사용해 보기


파일은 AsciiDoc으로 인식되도록 저장해야 합니다.

파일 확장자 저장


파일을 저장하는 확장자는 다음 세 개를 사용할 수 있습니다.
.asciidoc
.adoc
.asc
근데asc가 VScode에 있는 아이콘은 열쇠 표시입니다. 조사해 봤습니다.
공개 키 파일 확장자도 사용된다.

asciidoc나 adoc를 사용하는 것이 좋습니다.

표시


VSCode에서 AsciDoc의 파일이 열린 상태에서 윈도우의 오른쪽 상단에서 미리보기가 열립니다.

열면 다음과 같이 표시됩니다.

소스 코드를 강조 표시하려면 다음을 처음에 추가해야 합니다.
:source-highlighter: coderay

끝내다


느낌이 좋아서 쓰고 싶어요.
어쨌든 이번에는 여기까지입니다.

참고 자료


http://asciidoc.org/
https://asciidoctor.org/
http://coderay.rubychan.de/
https://asciidoctor.org/docs/user-manual/
https://takumon.github.io/asciidoc-syntax-quick-reference-japanese-translation/

좋은 웹페이지 즐겨찾기