ASCIIDocの導入とGitHubスライドページでの公開

Rubyのインストール(MacOS X)

Note

Mac High Sierraでは、システムにデフォルトでインストールされているRubyを使用して管理者権限が必要など煩雑になるので、rbenvをインストールし、ユーザーローカル環境にRubyをインストールする。

  1. homebrewでrbenvをインストール
1
> brew install rbenv ruby-build
  1. ターミナルを開いたときに、rbenv initコマンドを実行するよう、~/.bash_profileに以下のコマンドを追記する。
1
2
3
4
5
# rbenv PATH

if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi
export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"
  1. 設定を読み込み、rbenvのバージョンやインストールされているRubyのバージョンを確認する。
1
2
3
4
> source ~/.bash_profile
> rbenv -v
> rbenv versions
  * system (set by /Users/XXXXXX/.rbenv/version)
  1. 最新版のRubyのバージョンを確認し、インストール、使用するRubyを変更する。
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
> rbenv install -l
  ...
  2.6.0
  2.6.1
  2.6.2
  2.6.3
  ...

> rbenv install 2.6.1
> rbenv global 2.6.1
> rbenv versions
  system
* 2.6.1 (set by /Users/XXXXXX/.rbenv/version)

AsciiDocをインストール

1
2
3
4
> gem install asciidoctor
> gem install asciidoctor-diagram
> gem install --pre asciidoctor-pdf
> asciidoctor --version

HTMLを生成

1
> asciidoctor sample.adoc