Cara Instal Asciidoctor di Windows 10

Asciidoctor adalah pemrosesan teks menggunakan plain text yang bersifat open source dan bisa kita pakai untuk mengonversi AsciiDoc ke HTML5, DocBook, PDF, EPUB, dan lain-lainnya. Karena Asciidoctor ditulis dengan Ruby maka bisa berjalan di semua sistem operasi, yaitu Linux, Mac, dan Windows.



Untuk instalasi Asciidoctor, kita memerlukan Ruby. Versi Ruby yang kompatibel untuk Asciidoctor adalah versi Ruby + Devkit 2.6.5-1 x64. Versi ini lebih aman dari error yang terjadi ketika menjalankan perintah-perintah Asciidoctor terutama Asciidoctor-PDF.

Apakah di komputer kamu sudah terinstal Ruby? Jika belum, kamu bisa membaca Cara Install Ruby di Windows 10.

Instalasi Asciidoctor

Asciidoctor yang akan instal terdiri dari Asciidoctor, Asciidoctor-PDF, dan Asciidoctor-EPUB3. Cara instalasinya sebenarnya cukup mudah jika versi Ruby yang kita gunakan sudah kompatibel. Instalasi dilakukan dengan perintah command prompt, kecuali Asciidoctor EPUB3 yang kita instal menggunakan Git Bash.

Perintah instalasi Asciidoctor

gem install asciidoctor --pre

Kamu bisa mengecek versi yang terinstal dengan perintah
asciidoctor --version

Perintah instalasi Asciidoctor PDF

gem install asciidoctor-pdf --pre

Setelah itu instal juga syntax highlighter (opsional) jika anda menginginkannya untuk menulis code.
Rouge
gem install rouge
Pygments
gem install pygments.rb
CodeRay
gem install coderay

Untuk mengecek versi Asciidoctor PDF dan EPUB 3 bisa digunakan perintah yang sama dengan menyesuaikan namanya, misal: asciidoctor-pdf --version. Sementara untuk cek versi gem, gunakan perintah berikut, contoh:
gem list rouge
.

Perintah instalasi Asciidoctor EPUB3

Buka Git Bash (Git Bash tersedia jika kamu menginstal Git untuk Windows). Ketik perintah di bawah ini:
NOKOGIRI_USE_SYSTEM_LIBRARIES=1 gem install asciidoctor-epub3 --pre


Setelah ketiganya berhasil kita instal, berarti kita sudah selesai menginstal Asciidoctor. Kalian bisa mencoba menginstal toolchain lainnya dari Asiidoctor di Github-nya.

Selamat mencoba.