Halaman dokumentasi yang baik membuat pengunjung sampai ke jawabannya dengan tiga lapis navigasi: daftar topik di sidebar untuk berpindah topik, breadcrumb untuk menunjukkan posisi halaman di dalam situs, dan daftar “Di halaman ini” untuk melompat antarbagian artikel yang panjang. Bagian ini mengisi kerangka kosong dari Bagian 1 dengan ketiganya. Kuncinya satu: setiap bagian artikel diberi atribut id, lalu seluruh tautan navigasi menunjuk fragment #id tersebut, sehingga satu klik langsung menggulir halaman ke bagian yang dituju.
Tiga Lapis Navigasi #
Setiap lapis memakai elemen berbeda sesuai perannya:
| Lapis | Elemen | Peran |
|---|---|---|
| Daftar topik (sidebar) | nav berisi ul | Peta seluruh topik dokumentasi; selalu terlihat |
| Breadcrumb | nav berisi ol | Jejak posisi: Beranda hingga halaman yang sedang dibaca |
| Di halaman ini (toc) | nav berisi ol | Peta bagian artikel yang sedang dibaca |
Daftar topik memakai ul karena urutan butirnya tidak wajib, sedangkan breadcrumb memakai ol karena jejaknya justru berurutan dari akar situs ke halaman kini. Perbedaan makna inilah alasan dua daftar itu tidak boleh saling dipertukarkan.
Mengisi Nav dan Article #
File berikut melengkapi dokumentasi.html dari Bagian 1 dengan daftar topik, breadcrumb, toc, dan lima bagian artikel:
<!doctype html>
<html lang="id">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="Dokumentasi CatatKu: panduan penggunaan aplikasi pencatat ringan dari Komunitas Belajar Web.">
<title>Dokumentasi CatatKu</title>
</head>
<body>
<header>
<img src="../assets/logo-docs.svg" alt="Logo Dokumentasi CatatKu" width="48" height="48">
<div>
<h1>Dokumentasi CatatKu</h1>
<p>Panduan pengguna aplikasi pencatat ringan</p>
</div>
</header>
<main>
<nav aria-label="Daftar topik">
<ul>
<li><a href="#pengenalan">Pengenalan</a></li>
<li><a href="#memulai">Memulai</a></li>
<li><a href="#memformat">Memformat Catatan</a></li>
<li><a href="#pintasan">Pintasan Keyboard</a></li>
<li><a href="#berbagi">Menyimpan dan Berbagi</a></li>
</ul>
</nav>
<article>
<nav class="breadcrumb" aria-label="Breadcrumb">
<ol>
<li><a href="www.example.com">Beranda</a></li>
<li aria-current="page">Dokumentasi</li>
</ol>
</nav>
<nav class="toc" aria-label="Di halaman ini">
<p class="toc-label">Di halaman ini</p>
<ol>
<li><a href="#pengenalan">Pengenalan</a></li>
<li><a href="#memulai">Memulai</a></li>
<li><a href="#memformat">Memformat Catatan</a></li>
<li><a href="#pintasan">Pintasan Keyboard</a></li>
<li><a href="#berbagi">Menyimpan dan Berbagi</a></li>
<li><a href="#dukungan">Dukungan</a></li>
</ol>
</nav>
<h2 id="pengenalan">Pengenalan</h2>
<p>CatatKu adalah aplikasi pencatat ringan untuk komputer dan ponsel yang dikembangkan oleh Komunitas Belajar Web. Aplikasi ini menyimpan catatan secara lokal, sehingga tulisan tetap terbaca meski perangkat tidak terhubung ke internet. Halaman dokumentasi ini merangkum topik yang paling sering dicari pengguna baru.</p>
<h2 id="memulai">Memulai</h2>
<p>Tiga langkah berikut menyiapkan catatan pertama di CatatKu:</p>
<ol>
<li>Unduh CatatKu dari halaman unduhan di situs Komunitas Belajar Web, lalu pasang seperti aplikasi biasa.</li>
<li>Buka aplikasi, tekan pintasan <kbd>Ctrl</kbd>+<kbd>N</kbd>, atau pilih menu Catatan lalu Catatan Baru.</li>
<li>Tulis isi catatan; CatatKu menyimpan perubahan secara otomatis setiap beberapa detik.</li>
</ol>
<h2 id="memformat">Memformat Catatan</h2>
<p>CatatKu memakai penanda sederhana untuk memformat teks. Tanda bintang ganda membuat teks tampil tebal, tanda bintang tunggal membuat teks tampil miring, dan tanda pagar di awal baris menjadikan baris tersebut judul bagian.</p>
<pre><code># Rencana belajar pekan ini
- Menulis ulang catatan *struktur tabel*
- Membaca catatan **pintasan keyboard** dua kali</code></pre>
<h2 id="pintasan">Pintasan Keyboard</h2>
<p>Pintasan berikut mempercepat pekerjaan sehari-hari tanpa menyentuh menu:</p>
<table>
<caption>Pintasan keyboard pada CatatKu versi desktop</caption>
<thead>
<tr>
<th scope="col">Pintasan</th>
<th scope="col">Fungsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><kbd>Ctrl</kbd>+<kbd>N</kbd></td>
<td>Membuat catatan baru</td>
</tr>
<tr>
<td><kbd>Ctrl</kbd>+<kbd>S</kbd></td>
<td>Menyimpan salinan catatan aktif</td>
</tr>
<tr>
<td><kbd>Ctrl</kbd>+<kbd>F</kbd></td>
<td>Mencari teks di dalam catatan terbuka</td>
</tr>
</tbody>
</table>
<h2 id="berbagi">Menyimpan dan Berbagi</h2>
<p>Selain menyimpan otomatis, menu Berkas menyediakan opsi Ekspor Catatan. Hasil ekspor berupa berkas teks yang dapat dikirim lewat surel atau dibuka di aplikasi teks apa pun. Untuk berbagi seluruh arsip, menu yang sama menyediakan opsi Cadangkan.</p>
<h2 id="dukungan">Dukungan</h2>
<p>Menemui kendala saat memakai CatatKu? Tim dokumentasi memantau surel dukungan pada hari kerja. Sertakan versi aplikasi dan langkah yang memunculkan kendala agar pertanyaan cepat terjawab.</p>
<address>
Surel dukungan: <a href="mailto:[email protected]">[email protected]</a>
</address>
</article>
</main>
<footer>
<p>Dokumentasi CatatKu — dikelola oleh Komunitas Belajar Web.</p>
</footer>
</body>
</html>Output yang Dihasilkan:
Di bawah header kini tampil dua wilayah berdampingan secara konsep:
- Kiri: daftar lima topik dokumentasi
- Kanan: breadcrumb "Beranda › Dokumentasi", daftar "Di halaman ini",
lalu enam bagian artikel berurutan
Klik "Pintasan Keyboard" pada daftar mana pun:
- Halaman langsung tergulir ke tabel pintasan keyboardMari kita bedah bagian-bagian navigasi yang baru:
- Baris 18-26: nav sidebar memuat
ulberisi lima tautan; setiap nilaihrefberupa fragment seperti#pintasanyang menunjuk id pada bagian artikel. - Baris 28-33: nav breadcrumb memakai
ol; butir terakhir membawaaria-current="page"yang memberi tahu pembaca layar bahwa itulah halaman yang sedang dibaca. Nilaihref="www.example.com"adalah alamat situs fiktif sesuai konvensi proyek. - Baris 34-44: nav toc membawa
aria-label="Di halaman ini"sebagai namanya, paragraf label untuk pengunjung yang melihat, danolberisi enam bagian artikel — lima topik ditambah section Dukungan. - Baris 45-58: lima section artikel dimulai heading
h2ber-id unik, misalnyaid="memformat"; id inilah target seluruh fragment di atas. - Baris 56-58: blok
preberisicodememperlihatkan contoh format catatan; tipografinya ditata khusus pada Bagian 3. - Baris 61-83: tabel pintasan membawa
captiondan sel judul beratributscope="col", sesuai materi section Tables. - Baris 88-90: section Dukungan ditutup
addressberisi tautan surel fiktif milik tim dokumentasi.
Pemeriksaan Hasil Tahap Ini #
- Buka dokumentasi-navigasi.html di browser, lalu klik setiap tautan sidebar; halaman harus tergulir ke bagian yang dituju.
- Gunakan tombol Back pada browser setelah mengklik fragment, lalu amati riwayat navigasi tercatat.
- Pastikan breadcrumb menampilkan dua butir dan toc menampilkan enam butir.
- Buka tests/cek-struktur.html, lalu centang butir-butir navigasi yang telah dipenuhi.
Seluruh konten dan navigasi telah berdiri, tetapi tampilannya masih mengikuti gaya bawaan browser: dua wilayah menumpuk dan daftar terlihat seperti daftar biasa. Bagian berikutnya menatanya dengan stylesheet proyek.
Referensi resmi untuk pendalaman:
- MDN Web Docs — nav: The Navigation Section element
- MDN Web Docs — a: The Anchor element
- MDN Web Docs — Learn: Creating links
Berkas Sumber
Berkas pendukung halaman ini dapat diunduh dan dijalankan langsung sesuai penjelasan di atas.
dokumentasi-navigasi.html
Unduh berkas<!doctype html>
<html lang="id">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="Dokumentasi CatatKu: panduan penggunaan aplikasi pencatat ringan dari Komunitas Belajar Web.">
<title>Dokumentasi CatatKu</title>
</head>
<body>
<header>
<img src="../assets/logo-docs.svg" alt="Logo Dokumentasi CatatKu" width="48" height="48">
<div>
<h1>Dokumentasi CatatKu</h1>
<p>Panduan pengguna aplikasi pencatat ringan</p>
</div>
</header>
<main>
<nav aria-label="Daftar topik">
<ul>
<li><a href="#pengenalan">Pengenalan</a></li>
<li><a href="#memulai">Memulai</a></li>
<li><a href="#memformat">Memformat Catatan</a></li>
<li><a href="#pintasan">Pintasan Keyboard</a></li>
<li><a href="#berbagi">Menyimpan dan Berbagi</a></li>
</ul>
</nav>
<article>
<nav class="breadcrumb" aria-label="Breadcrumb">
<ol>
<li><a href="www.example.com">Beranda</a></li>
<li aria-current="page">Dokumentasi</li>
</ol>
</nav>
<nav class="toc" aria-label="Di halaman ini">
<p class="toc-label">Di halaman ini</p>
<ol>
<li><a href="#pengenalan">Pengenalan</a></li>
<li><a href="#memulai">Memulai</a></li>
<li><a href="#memformat">Memformat Catatan</a></li>
<li><a href="#pintasan">Pintasan Keyboard</a></li>
<li><a href="#berbagi">Menyimpan dan Berbagi</a></li>
<li><a href="#dukungan">Dukungan</a></li>
</ol>
</nav>
<h2 id="pengenalan">Pengenalan</h2>
<p>CatatKu adalah aplikasi pencatat ringan untuk komputer dan ponsel yang dikembangkan oleh Komunitas Belajar Web. Aplikasi ini menyimpan catatan secara lokal, sehingga tulisan tetap terbaca meski perangkat tidak terhubung ke internet. Halaman dokumentasi ini merangkum topik yang paling sering dicari pengguna baru.</p>
<h2 id="memulai">Memulai</h2>
<p>Tiga langkah berikut menyiapkan catatan pertama di CatatKu:</p>
<ol>
<li>Unduh CatatKu dari halaman unduhan di situs Komunitas Belajar Web, lalu pasang seperti aplikasi biasa.</li>
<li>Buka aplikasi, tekan pintasan <kbd>Ctrl</kbd>+<kbd>N</kbd>, atau pilih menu Catatan lalu Catatan Baru.</li>
<li>Tulis isi catatan; CatatKu menyimpan perubahan secara otomatis setiap beberapa detik.</li>
</ol>
<h2 id="memformat">Memformat Catatan</h2>
<p>CatatKu memakai penanda sederhana untuk memformat teks. Tanda bintang ganda membuat teks tampil tebal, tanda bintang tunggal membuat teks tampil miring, dan tanda pagar di awal baris menjadikan baris tersebut judul bagian.</p>
<pre><code># Rencana belajar pekan ini
- Menulis ulang catatan *struktur tabel*
- Membaca catatan **pintasan keyboard** dua kali</code></pre>
<h2 id="pintasan">Pintasan Keyboard</h2>
<p>Pintasan berikut mempercepat pekerjaan sehari-hari tanpa menyentuh menu:</p>
<table>
<caption>Pintasan keyboard pada CatatKu versi desktop</caption>
<thead>
<tr>
<th scope="col">Pintasan</th>
<th scope="col">Fungsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><kbd>Ctrl</kbd>+<kbd>N</kbd></td>
<td>Membuat catatan baru</td>
</tr>
<tr>
<td><kbd>Ctrl</kbd>+<kbd>S</kbd></td>
<td>Menyimpan salinan catatan aktif</td>
</tr>
<tr>
<td><kbd>Ctrl</kbd>+<kbd>F</kbd></td>
<td>Mencari teks di dalam catatan terbuka</td>
</tr>
</tbody>
</table>
<h2 id="berbagi">Menyimpan dan Berbagi</h2>
<p>Selain menyimpan otomatis, menu Berkas menyediakan opsi Ekspor Catatan. Hasil ekspor berupa berkas teks yang dapat dikirim lewat surel atau dibuka di aplikasi teks apa pun. Untuk berbagi seluruh arsip, menu yang sama menyediakan opsi Cadangkan.</p>
<h2 id="dukungan">Dukungan</h2>
<p>Menemui kendala saat memakai CatatKu? Tim dokumentasi memantau surel dukungan pada hari kerja. Sertakan versi aplikasi dan langkah yang memunculkan kendala agar pertanyaan cepat terjawab.</p>
<address>
Surel dukungan: <a href="mailto:[email protected]">[email protected]</a>
</address>
</article>
</main>
<footer>
<p>Dokumentasi CatatKu — dikelola oleh Komunitas Belajar Web.</p>
</footer>
</body>
</html>