Menggunakan Counter di Asciidoc

Selama saya menggunakan Asciidoctor, sering kali kita membutuhkan penomoran otomatis. Misalnya untuk langkah-langkah, contoh penggunaan, atau penanda urutan tanpa harus mengetik angka secara manual.

Asciidoctor menyediakan fitur counter attribute, yaitu atribut dokumen yang nilainya otomatis bertambah setiap kali digunakan. Fitur ini sangat berguna agar dokumentasi tetap konsisten dan mudah dirawat.

Artikel ini akan membahas konsep counter di Asciidoctor, cara penggunaannya, serta contoh penerapannya secara langsung.

Apa Itu Counter di Asciidoctor?

Counter di Asciidoctor adalah document attribute khusus yang nilainya akan bertambah (increment) setiap kali dipanggil menggunakan sintaks tertentu.

Beberapa karakteristik penting counter:

  • Nilai default dimulai dari 1

  • Bisa menggunakan angka atau huruf

  • Huruf yang didukung hanya latin (a–z atau A–Z)

  • Bisa di-increment dengan atau tanpa ditampilkan

Cara Membuat Counter Attribute

Untuk membuat counter, kita harus menambahkan prefix counter: di depan nama atribut.

Contoh dasar

{counter:steps}

Jika ini pertama kali dipanggil, hasilnya akan menjadi:

1

Pemanggilan berikutnya:

{counter:steps}

akan menghasilkan:

2

Setiap pemanggilan dengan counter: akan menampilkan sekaligus menaikkan nilai counter.

Nilai Counter Tanpa Increment

Jika kita hanya ingin menampilkan nilai saat ini tanpa menaikkan counter, cukup panggil nama atributnya saja (tanpa counter:).

{steps}

Ini berguna jika kita ingin menampilkan angka yang sama di beberapa tempat tanpa mengubah urutan.

Fungsinya mungkin mirip print di python.

Increment Tanpa Menampilkan Nilai (counter2)

Asciidoctor menyediakan counter2: untuk menaikkan nilai counter tanpa menampilkannya.

Contoh

{counter2:steps}

Perintah ini hanya menaikkan nilai steps, tetapi tidak menampilkan apa pun.

Untuk melihat nilainya setelah itu:

{counter:steps}

Mengatur Nilai Awal Counter

Secara default counter dimulai dari 1. Namun kita bisa mengatur nilai awal dengan menambahkan suffix :<nilai_awal> saat pertama kali digunakan.

Contoh mulai dari angka 10

{counter:sample:10}

Pemanggilan berikutnya:

{counter:sample}

Hasilnya:

11

Menggunakan Counter dengan Huruf

Selain angka, counter juga bisa menggunakan huruf.

Untuk memulainya, tentukan nilai awal berupa huruf:

{counter:usageChar:A}

Pemanggilan selanjutnya:

{counter:usageChar}

Hasilnya akan menjadi:

B

Catatan:

  • Hanya mendukung huruf A–Z atau a–z

  • Tidak mendukung karakter non-latin

Counter sangat cocok digunakan untuk:

  • Langkah-langkah prosedur

  • Penomoran contoh

  • Urutan konfigurasi

  • Dokumentasi panjang yang sering berubah

  • Menghindari kesalahan penomoran manual

  • Penomoran gambar secara otomatis

Comments

Post a Comment

Popular posts from this blog

Belajar Zimbra Mail Server

Image
Di era komunikasi digital, email masih menjadi sangat penting untuk komunikasi formal di organisasi. Salah satu solusi email server yang banyak digunakan di lingkungan enterprise dan institusi adalah Zimbra Mail Server. Pada tulisan ini, saya akan membagikan panduan belajar Zimbra Mail Server secara bertahap, ditujukan untuk pemula, peserta magang, maupun sysadmin yang ingin memperdalam pengelolaan email server. Mengenal Cara Kerja Email Server Sebelum mengenalkan apa itu zimbra, penting memahami bagaimana email bekerja. Secara umum, pengiriman email melibatkan beberapa komponen utama seperti SMTP untuk mengirim email, POP3/IMAP untuk mengambil email, serta peran Mail Transfer Agent (MTA), Mail Delivery Agent (MDA), dan Mail User Agent (MUA). Email server juga sangat bergantung pada konfigurasi DNS, seperti record MX, A, PTR, SPF, DKIM, dan DMARC (bisa coba dalami tentang ini). Kesalahan kecil pada DNS kadang menjadi penyebab utama email gagal terkirim atau masuk ke folder spam. La...
Read more

Mendalami tentang Linux (Sejarah dan Pelopor)

Image
Ringkasan Sejarah Linux Linux adalah sistem operasi komputer sumber terbuka yang awalnya dikembangkan untuk dan pada komputer pribadi berbasis Intel x86. Sistem ini kemudian diporting ke daftar platform hardware yang sangat panjang, mulai dari perangkat tertanam berukuran kecil hingga superkomputer terbesar di dunia. Pada bagian ini, kita akan mengikuti sejarah yang mengejutkan tentang bagaimana Linux berkembang dari proyek seorang mahasiswa perguruan tinggi Finlandia menjadi upaya besar yang memiliki dampak besar pada dunia saat ini. Linus Torvalds adalah seorang mahasiswa di Helsinki, Finlandia, pada tahun 1991, ketika ia memulai sebuah proyek: menulis kernel sistem operasi miliknya sendiri. Ia juga mengumpulkan dan/atau mengembangkan komponen-komponen esensial lainnya yang diperlukan untuk membangun sistem operasi lengkap dengan kernelnya sebagai inti. Tidak lama kemudian, ini dikenal sebagai kernel Linux. Pada tahun 1992, Linux dilisensikan ulang menggunakan General Public Licens...
Read more