Why not login to Qiita and try out its useful features?

We'll deliver articles that match you.

You can read useful information later.

6
11

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 5 years have passed since last update.

VSCodeにAsciidoc執筆環境を構築する

Posted at

VSCodeにAsciidoc執筆環境を構築する

背景

今までドキュメントはMarkdownで作成していたのですが、もう少し自由度のあるドキュメントを作成したいと思い、Asciidocを採用することにしました。

環境

  • OS:windows 10 pro
  • VSCode:1.31.1

手順

1. Rubyのインストール

WindowsのRubyインストーラーをダウンロードし、インストールしてください。今回は、Ruby 2.6.1を採用しています。

$ ruby -v
ruby 2.6.1p33 (2019-01-30 revision 66950) [x64-mingw32]

2. asciidoctorとエクステンションのインストール

以下のコマンドを実行し、必要なパッケージをインストールします。

$ gem install asciidoctor
$ gem install asciidoctor-diagram
$ gem install --pre asciidoctor-pdf

3. VSCodeのAsciiDocエクステンションを追加する

VSCodeの拡張機能で、AsciiDocで検索するとできてきます。

asciidoc.PNG

4. VSCodeの設定を変更する

VSCodeのsetting.jsonに以下を追加します。

"AsciiDoc.use_asciidoctor_js": false,
"AsciiDoc.asciidoctor_command": "asciidoctor -a outdir=tmp -a imagesdir=tmp -a imagesoutdir=tmp -r asciidoctor-diagram -o-",

上記で環境構築完了です。

プレビュー.PNG

参考にさせていただきました。ありがとうございます。

6
11
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up

Qiita Advent Calendar is held!

Qiita Advent Calendar is an article posting event where you post articles by filling a calendar 🎅

Some calendars come with gifts and some gifts are drawn from all calendars 👀

Please tie the article to your calendar and let's enjoy Christmas together!

6
11

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?