なんと、Asciidocはソースコードをインポートできるよ！

markdownよりもカスタマイズしほうだいのAsciidocを紹介するよ！

対象の方

markdownに限界を感じているあなたへ。

かと言ってWordではないツールをお探しのあなたへ。

Asciidocがあります！！

Asciidocは、Webページ、本、記事などを書くための軽量マークアップ言語です。拡張子は.asciidocもしくは.adoc

でも、このままだとmarkdownと同じような感じがしますね。でもでも、Asciidocには、markdownにはない便利な機能がたくさんあります。

その便利な機能を紹介しますね。

なんと、Asciidocはソースコードをインポートできます！ざっとこんな感じで。

[source,java]
----
include::Something.java[]
----

include::`のあとに、ソースコードのパスを記述できます。

そして、最後の[]`ですが、ここに以下のように記述すると、、、

[source,java]
----
include::Something.java[lines=5..10]
----

５行目から１０行目だけを指定して表示することができます!!

以下をインストールしてから、

sudo gem install coderay

Asciidocファイルの冒頭に、

:source-highlighter: coderay

を追加しましょう。きれいにハイライトされるはずです。

asciidocファイルの冒頭に以下の記述をすると、自動で目次を作ってくれます。

:toc:
:toclevels: 2

公式のリファレンスを日本語に訳してくれた素晴らしい方がいらっしゃいました。

ここでは簡単に、何もテーマを指定せずにPDFに変換したいと思います。

まず、以下のものをインストールします。

sudo gem install --pre asciidoctor-pdf

あとは、以下のコマンドを打つだけです。

asciidoctor-pdf ファイル名.adoc

Atomでは、 AsciiDoc Preview というプラグインを入れるとAtomでAsciidocを編集することができます。

IntelliJでは、 Asciidoc というプラグインがあるので、それを使いましょう。

以下にAsciidocでかかれた技術書などが一覧になっています。 http://asciidoc.org/#X6

これを見てみると、オライリー本の Programming Scala は、Asciidocでかかれていたんですね！

テキストベースで管理できて、markdownよりも機能が豊富なAsciidoc。

テーマとかいろいろ変えてみると、面白そうです。