Home
Komputer

Cara Instalasi Asciidoctor PDF di macOS Catalina

Asciidoctor PDF

Asciidoctor PDF adalah konverter untuk mengonversi dokumen AsciiDoc ke PDF. AsciiDoc sendiri merupakan format dokumen untuk menulis catatan, dokumentasi, artikel, buku, ebook, slideshow, halaman web, dan blog yang juga dapat dikonversikan ke berbagai format, antara lain HTML, PDF, EPUB, dan man page.


Instalasi Asciidoctor PDF

Instal RVM (Ruby Version Manager)

RVM adalah command-line tool yang memudahkan anda untuk menginstal, memanage, dan bekerja dengan banyak ruby environments. RVM akan menginstalkan Ruby pada direktori Home dan anda bisa memilih versi Ruby yang anda inginkan, apakah versi pada system-wide Ruby atau veri RVM-managed Ruby.

Sebelum Menginstal RVM

  • Untuk menginstal RVM, anda perlu menginstal Xcode. Apa itu Xcode? Xcode adalah semacam IDE untuk pengembangan aplikasi di lingkungan Apple. Anda bisa menginstal Xcode melalui App Store
  • Instal Git

Buka Terminal

Proses instalasi akan dilakukan di terminal.

Lakukan cek lisensi Xcode dengan perintah:

xcodebuild -license

Akan tampil persetujuan lisensi

Selanjutnya mulai instalasi RVM dengan perintah:

\curl -#L https://get.rvm.io | bash -s stable --autolibs=3 --ruby

Peritah di atas akan menginstal RVM dengan versi Ruby terbaru.

Jika anda menemukan tampilan error pada terminal

Error running 'requirements_osx_brew_libs_install autoconf automake libtool pkg-config coreutils libyaml libksba readline zlib',
please read /Users/fatoni/.rvm/log/1576561555_ruby-2.6.3/package_install_autoconf_automake_libtool_pkg-config_coreutils_libyaml_libksba_readline_zlib.log
Requirements installation failed with status: 1.

Langkah yang harus anda lakukan adalah melakukan diagnosa dengan perintah:

brew tap --repair
brew doctor

Akan tampil permasalahan yang terjadi serta solusi yang diberikan oleh Homebrew.

Salah satu contoh dari masalah yang kami alami:

Warning: The following directories are not writable by your user:
/usr/local/share/man/man5
/usr/local/share/man/man7

You should change the ownership of these directories to your user.
  sudo chown -R $(whoami) /usr/local/share/man/man5 /usr/local/share/man/man7

And make sure that your user has write permission.
  chmod u+w /usr/local/share/man/man5 /usr/local/share/man/man7

Warning: Homebrew's sbin was not found in your PATH but you have installed
formulae that put executables in /usr/local/sbin.
Consider setting the PATH for example like so:
  echo 'export PATH="/usr/local/sbin:$PATH"' >> ~/.zshrc

Berdasarkan solusi yang diberikan, kami menjalankan perintah berikut:

sudo chown -R $(whoami) /usr/local/share/man/man5 /usr/local/share/man/man7
chmod u+w /usr/local/share/man/man5 /usr/local/share/man/man7
echo 'export PATH="/usr/local/sbin:$PATH"' >> ~/.zshrc

Setelah itu, buka terminal baru. Kalau kita cek lagi dengan perintah brew doctor lalu hasilnya "Your system is ready to brew." itu artinya permasalahn anda sudah teratasi, anda bisa melanjutkan kembali perintah menginstal RVM:

\curl -#L https://get.rvm.io | bash -s stable --autolibs=3 --ruby

Jika muncul error:

zsh: no matches found: -#L

Anda hanya perlu menambahkan unsetopt nomatch pada file .zshrc

open -a textedit ~/.zshrc

Lalu tambahkan pada baris terakhir:

unsetopt nomatch

Kemudian save, lalu jalankan kembali:

\curl -#L https://get.rvm.io | bash -s stable --autolibs=3 --ruby

Proses penginstalan akan dilakukan, tunggu hingga proses selesai.

Langkah terakhir, instal Asciidoctor PDF

gem install asciidoctor-pdf --pre
Instal juga untuk sintak highlighter-nya

gem install rouge
gem install pygments.rb
gem install pygments.rb

Selamat mencoba.

Post a Comment