Tabel Referensi

Pembaca yang terburu-buru tidak membaca uraian — ia memindai tabel. Bagian ini menutup section Perintah dengan tabel ringkasan enam perintah, lalu mengisi Konfigurasi dengan daftar opsi dan tabel variabel lingkungan. Sekaligus kita melatih keputusan yang paling sering muncul saat menyusun dokumentasi: kapan memakai dl, kapan memakai tabel.

Tabel Ringkasan Perintah #

Tambahkan tabel berikut di akhir section Perintah, tepat setelah paragraf uraian tugas bantuan:

<table>
  <caption>Ringkasan perintah Tugas CLI v1.0</caption>
  <thead>
    <tr><th scope="col">Perintah</th><th scope="col">Fungsi</th><th scope="col">Contoh</th></tr>
  </thead>
  <tbody>
    <tr><th scope="row">tugas tambah</th><td>mencatat tugas baru</td><td><code>tugas tambah "beli gula"</code></td></tr>
    <tr><th scope="row">tugas daftar</th><td>menampilkan daftar tugas</td><td><code>tugas daftar --semua</code></td></tr>
    <tr><th scope="row">tugas selesai</th><td>menandai tugas selesai</td><td><code>tugas selesai 1</code></td></tr>
    <tr><th scope="row">tugas hapus</th><td>menghapus satu tugas</td><td><code>tugas hapus 3</code></td></tr>
    <tr><th scope="row">tugas ekspor</th><td>menyimpan daftar ke berkas CSV</td><td><code>tugas ekspor arsip.csv</code></td></tr>
    <tr><th scope="row">tugas bantuan</th><td>menampilkan ringkasan sintaks</td><td><code>tugas bantuan</code></td></tr>
  </tbody>
</table>

Mari kita bedah sel demi sel:

1. caption anak pertama table (baris 2): judul yang melekat secara semantik — pembaca layar mengumumkannya sebelum sel pertama. Redaksinya menyebut nama alat dan versinya: konteks yang tidak muat di sel mana pun.
2. thead dengan th scope="col" (baris 3-5): judul tiga kolom — Perintah, Fungsi, Contoh; scope menegaskan relasi tiap judul ke sel-sel di bawahnya.
3. th scope="row" pada kolom pertama (baris 7-12): nama perintah menjadi judul baris — sel Fungsi dan Contoh dinyatakan milik barisnya. Tabel referensi adalah tabel dua arah, dan scope menghapus keraguan arahnya. Pola lengkapnya dibedah pada chapter Accessible Tables.
4. code inline pada kolom Contoh (baris 7 dst.): contoh ditulis sebagai perintah nyata yang bisa langsung disalin — lengkap dengan tanda petiknya.
5. Satu baris kode per baris tabel (baris 7-12): keenam tr ditulis masing-masing satu baris — sel-selnya cukup pendek sehingga format ini memudahkan pemeriksaan ulang.
6. Tanpa tfoot: tidak ada baris ringkasan yang bermakna — banyaknya perintah bukan data yang perlu dijumlahkan.

Opsi dan Variabel Lingkungan #

Section Konfigurasi diisi dua struktur: pasangan opsi sebagai dl, lalu tabel variabel lingkungan:

<section id="konfigurasi">
  <h2>Konfigurasi</h2>
  <p>Tiga pengaturan mengatur perilaku bawaan Tugas; semuanya ditulis pada berkas <code>~/.tugasrc</code>:</p>
  <dl>
    <dt>format</dt>
    <dd>Bentuk baris daftar: <code>nomor</code> (bawaan), <code>tabel</code>, atau <code>ringkas</code>.</dd>
    <dt>berkas</dt>
    <dd>Lokasi penyimpanan data; bawaannya <code>~/.tugas.csv</code>.</dd>
    <dt>warna</dt>
    <dd>Warna keluaran terminal: <code>aktif</code> atau <code>nonaktif</code>.</dd>
  </dl>
  <p>Variabel lingkungan menimpa berkas konfigurasi — berguna saat Tugas dipakai di dalam skrip:</p>
  <table>
    <caption>Variabel lingkungan Tugas CLI</caption>
    <thead>
      <tr><th scope="col">Variabel</th><th scope="col">Nilai bawaan</th><th scope="col">Fungsi</th></tr>
    </thead>
    <tbody>
      <tr><th scope="row">TUGAS_BERKAS</th><td>~/.tugas.csv</td><td>lokasi berkas data</td></tr>
      <tr><th scope="row">TUGAS_FORMAT</th><td>nomor</td><td>bentuk baris daftar</td></tr>
      <tr><th scope="row">TUGAS_WARNA</th><td>aktif</td><td>warna keluaran terminal</td></tr>
    </tbody>
  </table>
</section>

Tiga keputusan pada blok ini:

1. dl tiga pasangan (baris 4-11): nama opsi sebagai dt, penjelasan sebagai dd. Nilai-nilainya ditulis code inline supaya terbaca sebagai isian, bukan kata biasa.
2. Paragraf transisi (baris 12): satu kalimat yang menjelaskan hubungan kedua struktur — variabel lingkungan menimpa berkas. Tanpa kalimat ini, dl dan tabel hanya tampak seperti dua daftar yang tidak bersambung.
3. Tabel variabel (baris 13-23): pola yang sama dengan tabel perintah — caption deskriptif, thead ber-scope="col", th scope="row" pada kolom pertama.

Kapan dl, Kapan Tabel #

Aturannya satu kalimat: begitu data memiliki lebih dari satu kolom yang dibandingkan sebaris, ia tabel; begitu isinya hanya nama beserta artinya, dl sudah memadai. Ujian lengkapnya dibedah pada chapter Kapan Menggunakan Tabel dan Description List.

Hasil pada Browser #

Tabel perintah tampil dengan caption di atas, judul kolom tebal, dan nama perintah tebal di kiri tiap baris. Daftar opsi menampilkan tiap istilah diikuti penjelasan yang menjorok satu tingkat — bentuk bawaan dd. Tabel variabel lingkungan menutup bagian dengan tiga barisnya yang lapang.

Inilah tabel ringkasan perintah persis seperti hasil Bagian 5 — perhatikan caption di atasnya, judul kolom yang dicetak tebal, dan nama perintah yang menjadi judul baris di kolom kiri:

Dan inilah section Konfigurasi lengkap — dl tiga opsi dengan penjelasan yang menjorok satu tingkat, lalu tabel variabel lingkungan menutup bagian:

Ringkasan Bagian 5 #

• Tabel referensi memakai struktur lengkap: caption anak pertama, thead dengan th scope="col", tbody eksplisit, dan th scope="row" pada kolom pertama.
• dl untuk pasangan istilah-nilai satu sumbu; tabel untuk data yang dibandingkan sebaris.
• Paragraf transisi menyambungkan dua struktur yang berbeda dalam satu section.

Bagian berikutnya menutup halaman: pertanyaan lazim, metadata, dan uji akhir.