Skip to content

zaidan's blog

a newbie, writing IT-related stuff and some personal experiences

Menu
  • IT
  • Personal life/opinion
  • Linux
  • Sepeda
  • Proxmox
  • VM/Container
  • Kuliah/Catatan Kuliah
Menu

Mempelajari Asciidoc

Posted on 28/07/202305/04/2025 by Zaidan

Hai semuanya. Kali ini saya mau sharing pengalaman lagi nih. Kali ini tentang pengalaman saya di tempat kerja. Kaya gimana sih? Yuk simak ceritanya!

Jadi, saya sebagai seorang IT Support saat masuk perusahaan ini diinstruksikan untuk mempelajari Linux. Kemudian juga diinstruksikan untuk belajar tentang Asciidoc dan Asciidoctor. Awalnya saya juga kurang paham apa itu ASciidoc dan Asciidoctor. Berarti saya harus belajar lebih banyak. Hehe.

Singkatnya, Asciidoc merupakan bahasa markup untuk membuat tulisan yang kemudian dapat diubah menjadi bentuk .HTML ataupun .pdf. Asciidoc memungkinkan kita untuk bikin artikel atau tutorial dengan lebih rapi dibandingkan apabila ingin langsung membuat dokumentasi atau artikel dengan format .HTML.

Sedangkan, Asciidoctor merupakan alat yang digunakan untuk merubah file Asciidoc tadi (file Asciidoc menggunakan ekstensi .adoc) menjadi berbagai bentuk file seperti .HTML ataupun .pdf.

Dalam Asciidoc terdapat format yang memungkinkan untuk membuat dokumen dengan terstruktur, mudah dibaca, dan enak dipandang. Asciidoc biasanya digunakan untuk membuat dokumen seperti:

  1. User Manual
  2. Panduan Teknis
  3. Dokumentasi Aplikasi
  4. Buku

Saya menggunakan Linux (Zorin) dalam kegiatan bekerja sehari-hari. Secara umum, proses yang dilakukan untuk membuat dokumen menggunakan Asciidoc adalah:

  1. Buat file .adoc menggunakan text editor. Saya biasanya menggunakan editor vi di Linux. Buat file dengan berbagai format editing, kemudian simpan dokumen.
  2. Render file .adoc ke format yang diinginkan deperti .HTML atau .pdf menggunakan Asciidoctor. Tunggu sesaat, kemudian,
  3. Dokumen selesai di-render. Gunakan aplikasi lain seperti peramban web untuk membuka file .HTML atau .pdf.

Segitu dulu yang saya share kali ini. Mungkin di kiriman selanjutnya saya akan bagikan tutorial lebih lanjut mengenai Asciidoc dan Asciidoctor. Bye.

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

Tulisan saya yang lain:

  • Gowes Pantai – part 3
  • Auto-start VM/Container di Proxmox VE
  • Membuat Voting di Telegram menggunakan VoteBot (@vote)
  • Coba Instal NGINX (lagi) + SSL-nya

Arsip blog

  • September 2025
  • August 2025
  • July 2025
  • June 2025
  • May 2025
  • April 2025
  • March 2025
  • February 2025
  • January 2025
  • December 2024
  • November 2024
  • October 2024
  • September 2024
  • August 2024
  • July 2024
  • June 2024
  • May 2024
  • April 2024
  • March 2024
  • February 2024
  • January 2024
  • December 2023
  • November 2023
  • October 2023
  • September 2023
  • August 2023
  • July 2023
  • June 2023
  • May 2023
© 2025 zaidan's blog | Powered by Superbs Personal Blog theme