Formatting Dasar Asciidoc

Hai semuanya, apa kabar? Semoga kalian semua sehat ya. Kali ini, saya mau berbagi tentang formatting dasar di Asciidoc. Asciidoc memungkinkan kita melakukan formatting dasar seperti bold , italic , monospace , subscript, dan superscript . Ayo kita mulai!

  1. Bold
    Teks tebal dapat membantu pembaca lebih fokus pada suatu topik yang sedang dijelaskan. Pada Asciidoc memungkinkan untuk membuat teks tebal. Caranya adalah menggunakan simbol bintang (*). Teks yang ingin ditebalkan diletakkan diantara dua tanda bintang. Contohnya dapat dilihat pada gambar 1.


    Gambar 1
    Ada dua jenis formatting yang ada dalam Asciidoc, yaitu constrained dan unconstrained. Constrained artinya adalah teks yang ingin diformat dipisahkan oleh spasi atau karakter tertentu (umum untuk formatting) seperti titik (.), koma (,), titik dua (:), dan titik koma (;).

    Sedangkan unconstrained artinya teks yang ingin diformat diapit oleh huruf atau karakter lain seperti yang dapat dilihat pada Gambar 1, pada tulisan Teks ini sebagian tebal, pada tulisan Te, di sampingnya teredapat huruf lain yaitu “ks”, kemudian sebelum tulisan bagian,terdapat tulisan “Se”.

    Juga, pada Asciidoc, untuk melakukan “Enter” pada kalimat atau paragraf biasa, diperlukan tanda plus “+”. Apabila tidak, maka tulisan yang ditampilkan akan bersambung dari kalimat sebelumnya (tidak di baris baru).
  2. Italic
    Dalam Asciidoc, teks italic juga biasa disebut emphasis. Teks italic biasanya digunakan untuk menegaskan sesuatu atau menuliskan istilah dalam bahasa asing. Untuk membuat teks italic di Asciidoc, caranya adalah menggunakan karakter underscore (_). Contoh penggunaan dapat dilihat pada gambar 2 (termasuk penggunaan format constrained dan unconstrained).

    Gambar 2
    Pada gambar 2 terlihat contoh penggunaan format italic pada Asciidoc, yaitu dengan menggunakan tanda underscore diantara kalimat yang ingin dibuat miring. Untuk format unconstrained, digunakan tanda underscore ganda.
  3. Monospace
    Format monospace biasanya digunakan untuk menampilkan kode program komputer. Untuk menggunakan format ini, digunakan tanda backtick (`, tombol di sebelah kiri tombol 1 pada keyboard). Contoh penggunaan dapat dilihat pada gambar 3.

    Gambar 3
    Gambar 3 menampilkan contoh penggunaan format monospace baik format constrained maupun unconstrained. Format constrained menggunakan backtick tunggal dan untuk format unconstrained menggunakan backtick ganda. Ditampilkan juga contoh penggunaan format ini untuk penulisan kode sudo asciidoctor posting.adoc.
  4. Subscript dan Superscript.
    Penggunaan subscript dan superscript biasanya digunakan dalam penulisan notasi ilmiah seperti matematika atau kimia (seperti nama unsur). Format subscript ditampilkan dengan ukuran tulisan yang lebih kecil daripada tulisan normal dan terletak di bawah baseline (garis atau tempat tulisan normal terletak). Penggunaan subscript dapat digunakan pada Asciidoc menggunakan simbol tilde (~) sedangkan penggunaan superscript pada Asciidoc menggunakan simbol caret (^). Contoh penggunaan dapat dilihat pada gambar 4.

    Gambar 4
    Penggunaan subscript dan superscript pada Asciidoc berbeda dari formatting sebelumnya. Pada format kali ini, subscript dan superscript bukan termasuk dalam format constrained maupun unconstrained. Namun memiliki format khusus, yaitu kalimat yang ingin dibuat sub atau superscript tidak bisa ada spasi di dalamnya. Apabila memiliki spasi, harus ditambahkan teks {sp} pada bagian yang memiliki spasi. Contohnya dapat dilihat pada gambar 4, bagian paling bawah.
  5. Gabungan atau Campuran Semuanya
    Saya mau coba campur semuanya, bisa gak ya. Hehe. Coba liat gambar 5 di bawah.

    Gambar 5
    Ternyata bisa. Pada Gambar 5, saya mencoba menulis kalimat dengan campuran beberapa formatting.
    the quick brown fox jumps over the lazy dog
    the quick: bold, italic, monospace
    brown fox: italic-unconstrained, monospace
    jumps over : superscript, bold
    the lazy dog: subscript, monospace, italic

    Perlu diperhatikan juga, sintaks italic (_) harus berada di sisi paling dalam, bold (*)di luar italic, dan monospace (`) terletak di paling luar.

Itu dulu yang bisa saya bagikan di kiriman ini. Bye!

Leave a Comment