forked from withastro/starlight
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'main' into hd-sidebar-link-attributes
* main: Updated Dutch translation (withastro#773) [ci] format Prevent crashing with no content folder (withastro#745) [ci] format i18n(id): Translate `index.mdx` & `getting-started.mdx` (withastro#765) i18n(zh-cn): Translate sidebar.mdx (withastro#681) i18n(zh-cn): Update i18n.mdx (withastro#769)
- Loading branch information
Showing
9 changed files
with
684 additions
and
6 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
--- | ||
'@astrojs/starlight': patch | ||
--- | ||
|
||
Prevent Starlight crashing when the content folder doesn't exist, or is empty |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
--- | ||
"@astrojs/starlight": patch | ||
--- | ||
|
||
Fix Dutch UI translation for “Previous page” links |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,129 @@ | ||
--- | ||
title: Memulai | ||
description: Pelajari cara membuat situs dokumentasi baru Anda dengan Starlight oleh Astro. | ||
--- | ||
|
||
import { Tabs, TabItem } from '@astrojs/starlight/components'; | ||
|
||
## Membuat Proyek Baru | ||
|
||
Starlight adalah tema dokumentasi berfitur lengkap berbasis [Astro](https://astro.build). | ||
|
||
Anda dapat membuat proyek Astro + Starlight baru menggunakan perintah berikut ini: | ||
|
||
<Tabs> | ||
<TabItem label="npm"> | ||
|
||
```sh | ||
# membuat proyek baru dengan npm | ||
npm create astro@latest -- --template starlight | ||
``` | ||
|
||
</TabItem> | ||
<TabItem label="pnpm"> | ||
|
||
```sh | ||
# membuat proyek baru dengan pnpm | ||
pnpm create astro --template starlight | ||
``` | ||
|
||
</TabItem> | ||
<TabItem label="Yarn"> | ||
|
||
```sh | ||
# membuat proyek baru dengan yarn | ||
yarn create astro --template starlight | ||
``` | ||
|
||
</TabItem> | ||
</Tabs> | ||
|
||
Perintah tersebut akan membuat [direktori proyek](/guides/project-structure/) baru beserta seluruh file dan konfigurasi untuk situs Anda. | ||
|
||
:::tip[Coba dulu] | ||
Cobalah Starlight di browser: | ||
[buka dengan StackBlitz](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics). | ||
::: | ||
|
||
## Membuat konten dengan Starlight | ||
|
||
Starlight sudah siap untuk ditambahkan konten baru, atau pindahkan konten lama Anda! | ||
|
||
### Format file | ||
|
||
Starlight mendukung pembuatan konten dalam Markdown and MDX. (Tambahkan dukungan Markdoc dengan menginstall integrasi eksperimental [Astro Markdoc](https://docs.astro.build/en/guides/integrations-guide/markdoc/).) | ||
|
||
### Tambah halaman baru | ||
|
||
Tambah halaman baru dengan cara membuat file `.md` or `.mdx` di `src/content/docs/`. Tambahkan folder untuk mengorganisasikan konten Anda, dan membuat 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_ dengan _type-safety_ yang aman | ||
|
||
Semua halaman Starlight terdiri dari [properti _frontmatter_ umum](/id/reference/frontmatter/) yang dapat dikostumisasi untuk mengontrol tampilan setiap halaman: | ||
|
||
```md | ||
--- | ||
title: Hello, World! | ||
description: This is a page in my Starlight-powered site | ||
--- | ||
``` | ||
|
||
Jika ada properti yang terlewat, Starlight akan memberitahu Anda. | ||
|
||
## _Deploy_ situs Starlight Anda | ||
|
||
Setelah Anda membuat dan mengkostumisasi situs Starlight anda, anda dapat men-_deploy_ situs anda ke web server atau platform hosting pilihan Anda, termasuk Netlify, Vercel, GitHub Pages dan lain sebagainya. | ||
|
||
[Pelajari cara men-_deploy_ situs Astro di dokumentasi Astro.](https://docs.astro.build/en/guides/deploy/) | ||
|
||
## Memperbaharui Starlight | ||
|
||
:::tip | ||
Karena Starlight masih berstatus beta, akan ada pembaruan dan peningkatan yang cukup sering. Pastikan Anda selalu memperbaharui Starlight secara rutin! | ||
::: | ||
|
||
Starlight adalah integrasi Astro, dan cara memperbaharuinya sama seperti integrasi `@astrojs/*` yang lain: | ||
|
||
<Tabs> | ||
<TabItem label="npm"> | ||
|
||
```sh | ||
# memperbaharui Starlight dengan npm | ||
npm install @astrojs/starlight@latest | ||
``` | ||
|
||
</TabItem> | ||
<TabItem label="pnpm"> | ||
|
||
```sh | ||
# memperbaharui Starlight dengan pnpm | ||
pnpm upgrade @astrojs/starlight --latest | ||
``` | ||
|
||
</TabItem> | ||
<TabItem label="Yarn"> | ||
|
||
```sh | ||
# memperbaharui Starlight dengan yarn | ||
yarn upgrade @astrojs/starlight --latest | ||
``` | ||
|
||
</TabItem> | ||
</Tabs> | ||
|
||
Anda dapat membaca semua histori pembaruan Starlight dalam setiap rilis di [_changelog_](https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md). | ||
|
||
## Menyelesaikan masalah pada Starlight | ||
|
||
[Konfigurasi proyek](/id/reference/configuration/) dan [konfigurasi _frontmatter_](/id/reference/frontmatter/) tersedia di bagian Referensi pada situs ini. Rujuklah halaman tersebut untuk memastikan situs 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 situs Starlight anda. | ||
|
||
Jika Anda tidak menemukan jawaban di dokumentasi ini, silahkan merujuk kepada [dokumentasi lengkap Astro](https://docs.astro.build). Pertanyaan Anda biasanya akan terjawab dengan memahami bagaimana umumnya Astro bekerja, sebagai basis dari Starlight. | ||
|
||
Anda juga dapat merujuk kepada [isu-isu yang diketahui di GitHub](https://github.com/withastro/starlight/issues), dan mendapatka bantuan melalui [Astro Discord](https://astro.build/chat/) oleh 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! |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,58 @@ | ||
--- | ||
title: Starlight 🌟 Wujudkan situs dokumentasi dengan Astro | ||
description: Starlight membantu mewujudkan situs web dokumentasi yang menawan dan berperforma tinggi dengan Astro. | ||
template: splash | ||
banner: | ||
content: | | ||
<span class="ph-banner"> | ||
<span class="ph-houston"><img src="/ph-houston.svg" alt="" width="72" height="72"/></span> | ||
<span class="ph-text"> | ||
<strong>Halo Product Hunters 👋</strong> | ||
<a href="https://www.producthunt.com/posts/starlight-by-astro">Kami sedang live sekarang!</a> | ||
</span> | ||
</span> | ||
hero: | ||
title: Buat dokumentasi yang bersinar dengan Starlight | ||
tagline: Semua yang Anda butuhkan untuk mewujudkan situs dokumentasi yang luar biasa. Cepat, ramah pengguna, dan sangat mudah digunakan. | ||
image: | ||
file: ../../../assets/hero-star.webp | ||
actions: | ||
- text: Memulai | ||
icon: right-arrow | ||
variant: primary | ||
link: /id/getting-started/ | ||
- text: Lihat di GitHub | ||
icon: external | ||
link: https://github.com/withastro/starlight | ||
--- | ||
|
||
import { CardGrid, Card } from '@astrojs/starlight/components'; | ||
import AboutAstro from '../../../components/about-astro.astro'; | ||
|
||
<CardGrid stagger> | ||
<Card title="Dokumentasi yang menawan" icon="open-book"> | ||
Sudah termasuk: Navigasi situs, pencarian, terjemahan, SEO, tipografi yang | ||
mudah dibaca, _code highlighting_, mode gelap, dan masih banyak lagi. | ||
</Card> | ||
<Card title="Ditenagai oleh Astro" icon="rocket"> | ||
Manfaatkan kekuatan penuh dan performa Astro. Kembangkan Starlight dengan | ||
pustaka dan integrasi Astro favorit Anda. | ||
</Card> | ||
<Card title="Markdown, Markdoc, and MDX" icon="document"> | ||
Gunakan bahasa markup favorit Anda. Starlight menyediakan validasi | ||
_frontmatter_ bawaan dengan TypeScript _type-safety_. | ||
</Card> | ||
<Card title="Gunakan komponen UI pilihan Anda" icon="puzzle"> | ||
Starlight adalah solusi dokumentasi yang lengkap dan _framework-agnostic_. | ||
Kembangkan lebih jauh dengan React, Vue, Svelte, Solid, dan lain-lain. | ||
</Card> | ||
</CardGrid> | ||
|
||
<AboutAstro title="Dipersembahkan oleh"> | ||
Astro adalah _framework_ web serbaguna didesain untuk web yang cepat. | ||
Gunakan konten Anda dari sumber mana saja dan _deploy_ di mana saja, | ||
semua ditenagai dengan pustaka dan komponen UI favorit Anda. | ||
|
||
[Pelajari tentang Astro](https://astro.build/) | ||
|
||
</AboutAstro> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.