Astro Starlight

Astro Starlight adalah tema dokumentasi yang dibangun di atas kerangka kerja web Astro. Ini menyediakan struktur siap pakai untuk membuat situs web dokumentasi yang cepat, dapat diakses, dan mudah dipelihara. Berbeda dengan alat dokumentasi lainnya, Starlight mengirimkan JavaScript minimal ke browser, menghasilkan waktu muat yang lebih cepat dan kinerja yang lebih baik.

Alat ini mendukung penulisan konten dalam format Markdown, MDX, dan Markdoc, memberi Anda fleksibilitas dalam cara membuat dokumentasi Anda. Ini mencakup pembuatan navigasi otomatis, pencarian bawaan yang didukung oleh Pagefind, dan desain responsif yang bekerja di semua perangkat. Starlight juga mendukung banyak bahasa secara langsung, membuatnya cocok untuk proyek dokumentasi global. Tema ini sangat dapat disesuaikan melalui file konfigurasi, memungkinkan Anda menyesuaikan dengan merek Anda sambil menjaga kesederhanaan pengaturan.

Memulai dengan Astro Starlight itu sederhana dan hanya memerlukan beberapa langkah:

• Pasang Starlight menggunakan baris perintah dengan menjalankan npm create astro@latest -- --template starlight di terminal Anda. Ini akan mengatur semuanya secara otomatis.

• Setelah terpasang, mulai server pengembangan dengan npm run dev untuk melihat pratinjau situs dokumentasi Anda secara lokal di browser.

• Tambahkan halaman dokumentasi baru dengan membuat file Markdown atau MDX di direktori src/content/docs/. Setiap file secara otomatis menjadi sebuah halaman.

• Konfigurasikan pengaturan situs Anda di file astro.config.mjs. Di sini Anda dapat mengatur judul situs, menambahkan tautan media sosial, dan menyesuaikan sidebar navigasi.

• Atur halaman dengan membuat folder di dalam direktori docs. Starlight secara otomatis menghasilkan navigasi berdasarkan struktur file Anda.

• Ketika siap untuk dipublikasikan, bangun situs Anda dengan npm run build dan deploy ke layanan hosting statis seperti Netlify, Vercel, atau GitHub Pages.

• Generasi situs statis cepat dengan JavaScript minimal

• Pencarian bawaan dengan Pagefind

• Dukungan internasionalisasi penuh

• Generasi navigasi otomatis

• Tema gelap dan terang disertakan

• Dukungan Markdown, MDX, dan Markdoc

• Integrasi beberapa kerangka kerja (React, Vue, Svelte)

• Desain berfokus pada aksesibilitas

• Tata letak responsif untuk perangkat mobile

• Tema dan warna yang dapat disesuaikan

• Tautan edit halaman

• Integrasi media sosial

• Dioptimalkan untuk SEO