Lewati ke konten
Starlight

Memulai

Membuat Proyek Baru

Starlight adalah tema website dokumentasi berfitur lengkap berbasis Astro.

Anda dapat membuat proyek Astro + Starlight baru menggunakan perintah berikut ini:

# membuat proyek baru dengan npm
npm create astro@latest -- --template starlight

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

Membuat konten dengan Starlight

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

Format file

Starlight mendukung pembuatan konten dalam bentuk Markdown and MDX. (Anda dapat menambahkan support untuk Markdoc dengan menginstall integrasi eksperimental Astro Markdoc.)

Tambah halaman baru

Tambah halaman baru secara otomatis dengan cara membuat file .md or .mdx di src/content/docs/. Tambahkan folder untuk mengatur konten Anda, dan membuat beberapa segmen path bertingkat:

src/content/docs/hello-world.md => your-site.com/hello-world
src/content/docs/guides/faq.md => your-site.com/guides/faq

Frontmatter yang type-safe

Semua halaman Starlight berbagi properti frontmatter umum yang dapat dikostumisasi untuk mengontrol tampilan setiap halaman:

---
title: Hello, World!
description: This is a page in my Starlight-powered site
---

Jika ada properti yang terlewat, Starlight akan memberitahu Anda.

Deploy website Starlight Anda

Setelah Anda selesai membuat dan mengkostumisasi website Starlight anda, anda dapat men-deploy website Anda ke web server atau platform hosting pilihan Anda, termasuk Netlify, Vercel, GitHub Pages, dan lain sebagainya.

Pelajari cara men-deploy website Astro di dokumentasi Astro.

Memperbaharui Starlight

Starlight adalah integrasi Astro, dan cara memperbaharuinya sama seperti integrasi @astrojs/* yang lain:

# memperbaharui Starlight dengan npm
npm install @astrojs/starlight@latest

Anda dapat melihat daftar lengkap perubahan-perubahan yang dilakukan dalam setiap rilis di changelog.

Troubleshooting Starlight

Konfigurasi proyek dan konfigurasi frontmatter tersedia di bagian Referensi pada website ini. Gunakan halaman-halaman tersebut untuk memastikan website Starlight Anda terkonfigurasi dengan benar dan berfungsi dengan baik.

Anda juga dapat merujuk kepada panduan di sidebar untuk membantu Anda dalam menambah konten dan mengkustomisasi website Starlight Anda.

Jika Anda tidak menemukan jawaban di dokumentasi ini, silahkan merujuk kepada dokumentasi lengkap Astro. Pertanyaan Anda biasanya akan terjawab dengan memahami bagaimana Astro bekerja secara umum, sebagai basis dari Starlight.

Anda juga dapat merujuk kepada isu-isu di GitHub, dan mendapatkan bantuan di Astro Discord dari komunitas kami yang ramah dan sangat aktif! Silahkan bertanya di forum #support menggunakan tag “starlight” tag, atau kunjungi channel #starlight untuk mendiskusikan pengembangan Starlight, dan lain-lain!