| title | description |
|---|---|
Memulai |
Pelajari cara membuat website dokumentasi baru Anda dengan Starlight oleh Astro. |
import { Tabs, TabItem } from '@astrojs/starlight/components';
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.
Buat proyek Astro + Starlight baru dengan menjalankan perintah berikut di terminal Anda:
npm create astro@latest -- --template starlightpnpm create astro --template starlightyarn create astro --template starlightPerintah tersebut akan membuat direktori proyek baru berisikan seluruh file dan konfigurasi yang diperlukan untuk website Anda.
:::tip[Lihat itu beraksi] Cobalah Starlight di browser Anda: buka dengan StackBlitz. :::
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 run devpnpm devyarn devIni akan mencatat pesan ke terminal Anda dengan URL pratinjau lokal Anda. Buka URL tersebut untuk mulai menjelajahi situs Anda.
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”.
- 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.
:::tip 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 install @astrojs/starlight@latestpnpm upgrade @astrojs/starlight --latestyarn upgrade @astrojs/starlight --latestLihat changelog Starlight untuk daftar lengkap perubahan yang dibuat dalam setiap rilis.
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!