Memulai

Starlight adalah tema dokumentasi berfitur lengkap yang dibangun di atas framework Astro. Panduan ini akan membantu Anda memulai proyek baru. Lihat petunjuk penyiapan manual untuk menambahkan Starlight ke proyek Astro yang sudah ada.

Mulai Cepat

Membuat proyek baru

Buat proyek Astro + Starlight baru dengan menjalankan perintah berikut di terminal Anda:

npm

npm create astro@latest -- --template starlight

pnpm

pnpm create astro --template starlight

Yarn

yarn create astro --template starlight

Perintah tersebut akan membuat direktori proyek baru berisikan seluruh file dan konfigurasi yang diperlukan untuk website Anda.

Lihat itu beraksi

Cobalah Starlight di browser Anda: buka dengan StackBlitz.

Mulai server pengembangan

Ketika bekerja secara lokal, server pengembangan Astro memungkinkan Anda melihat pratinjau pekerjaan Anda dan secara otomatis me-refresh peramban ketika Anda membuat perubahan.

Di dalam direktori proyek Anda, jalankan perintah berikut untuk memulai server pengembangan:

npm

npm run dev

pnpm

pnpm dev

Yarn

yarn dev

Ini akan mencatat pesan ke terminal Anda dengan URL pratinjau lokal Anda. Buka URL tersebut untuk mulai menjelajahi situs Anda.

Tambahkan konten

Starlight siap untuk ditambahkan konten baru, atau pindahkan konten Anda yang sudah ada!

Tambahkan halaman baru ke website anda dengan membuat file Markdown di direktori src/content/docs/.

Baca selengkapnya tentang perutean berbasis file serta dukungan untuk MDX dan Markdoc di panduan “Halaman”.

Langkah selanjutnya

• Mengkonfigurasi: Pelajari tentang opsi umum dalam “Menyesuaikan Starlight”.
• Navigasi: Siapkan sidebar Anda dengan panduan “Navigasi Sidebar”.
• Komponen: Temukan kartu, tab dan bawaan lainnya di dalam panduan “Komponen”.
• Sebarkan: Publikasikan karya Anda dengan panduan “Deploy situs Anda” di dokumentasi Astro.

Memperbarui Starlight

Tips

Karena Starlight adalah perangkat lunak beta, akan ada pembaruan dan peningkatan yang sering dilakukan. Pastikan untuk memperbarui Starlight secara teratur!

Starlight adalah integrasi Astro, dan diperbarui seperti integrasi @astrojs/* lainnya:

npm

npm install @astrojs/starlight@latest

pnpm

pnpm upgrade @astrojs/starlight --latest

Yarn

yarn upgrade @astrojs/starlight --latest

Lihat changelog Starlight untuk daftar lengkap perubahan yang dibuat dalam setiap rilis.

Troubleshooting Starlight

Gunakan konfigurasi proyek dan halaman referensi konfigurasi frontmatter halaman individual untuk memastikan bahwa situs Starlight Anda telah dikonfigurasi dan berfungsi dengan baik. Lihat panduan di sidebar untuk bantuan menambahkan konten dan menyesuaikan situs Starlight Anda.

Jika jawaban Anda tidak dapat ditemukan dalam dokumentasi ini, silakan kunjungi Dokumentasi Astro untuk dokumentasi lengkap Astro. Pertanyaan Anda mungkin terjawab dengan memahami cara kerja Astro secara umum, di bawah tema Starlight ini.

Anda juga dapat memeriksa masalah Starlight yang diketahui di GitHub, dan dapatkan bantuan di Astro Discord dari komunitas kami yang aktif dan ramah! Kirimkan pertanyaan di forum #support kami dengan tag “starlight”, atau kunjungi kanal #starlight khusus kami untuk mendiskusikan perkembangan terkini dan banyak lagi!