Skip to content

Commit

Permalink
Merge branch 'main' into hd-sidebar-link-attributes
Browse files Browse the repository at this point in the history
* 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
HiDeoo committed Sep 27, 2023
2 parents 501b9de + 423d575 commit 2f2936c
Show file tree
Hide file tree
Showing 9 changed files with 684 additions and 6 deletions.
5 changes: 5 additions & 0 deletions .changeset/cool-moons-thank.md
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
5 changes: 5 additions & 0 deletions .changeset/few-roses-explain.md
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
8 changes: 8 additions & 0 deletions docs/astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ export const locales = {
ja: { label: '日本語', lang: 'ja' },
fr: { label: 'Français', lang: 'fr' },
it: { label: 'Italiano', lang: 'it' },
id: { label: 'Bahasa Indonesia', lang: 'id' },
zh: { label: '简体中文', lang: 'zh' },
'pt-br': { label: 'Português do Brasil', lang: 'pt-BR' },
ko: { label: '한국어', lang: 'ko' },
Expand Down Expand Up @@ -61,6 +62,7 @@ export default defineConfig({
ja: 'ここからはじめる',
fr: 'Commencez ici',
it: 'Inizia qui',
id: 'Mulai dari sini',
zh: '从这里开始',
'pt-BR': 'Comece Aqui',
ko: '여기서부터',
Expand All @@ -75,6 +77,7 @@ export default defineConfig({
ja: '入門',
fr: 'Mise en route',
it: 'Iniziamo',
id: 'Memulai',
zh: '开始使用',
'pt-BR': 'Introdução',
ko: '시작하기',
Expand All @@ -89,6 +92,7 @@ export default defineConfig({
ja: '手動セットアップ',
fr: 'Installation manuelle',
// it: 'Manual Setup',
id: 'Instalasi Manual',
zh: '手动配置',
'pt-BR': 'Instalação Manual',
ko: '수동으로 설정하기',
Expand All @@ -103,6 +107,7 @@ export default defineConfig({
ja: '環境への負荷',
fr: 'Impact environnemental',
it: 'Impatto ambientale',
id: 'Dampak terhadap lingkungan',
zh: '环境影响',
'pt-BR': 'Impacto Ambiental',
ko: '환경적 영향',
Expand All @@ -117,6 +122,7 @@ export default defineConfig({
ja: 'ショーケース',
fr: 'Vitrine',
// it: '',
id: 'Galeri',
ko: '쇼케이스',
},
},
Expand All @@ -130,6 +136,7 @@ export default defineConfig({
ja: 'ガイド',
fr: 'Guides',
it: 'Guide',
id: 'Petunjuk Penggunaan',
zh: '指南',
'pt-BR': 'Guias',
ko: '가이드',
Expand All @@ -144,6 +151,7 @@ export default defineConfig({
ja: 'リファレンス',
fr: 'Référence',
it: 'Riferimenti',
id: 'Referensi',
zh: '参考',
'pt-BR': 'Referência',
ko: '참조',
Expand Down
129 changes: 129 additions & 0 deletions docs/src/content/docs/id/getting-started.mdx
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!
58 changes: 58 additions & 0 deletions docs/src/content/docs/id/index.mdx
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&nbsp;👋</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>
2 changes: 1 addition & 1 deletion docs/src/content/docs/zh/guides/i18n.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -142,7 +142,7 @@ Starlight 期望你在所有语言中创建等效的页面。例如,如果你

除了托管翻译的内容文件之外,Starlight 还允许你翻译默认的 UI 字符串(例如,目录中的“本页”标题),以便你的读者可以完全使用所选的语言体验你的网站。

默认提供了英语、捷克语、法语、德语、意大利语、日语、葡萄牙语、荷兰语、丹麦语、西班牙语、土耳其语、阿拉伯语、挪威语、波斯语、简体中文、韩语、俄罗斯语和瑞典语的翻译 UI 字符串,我们欢迎[贡献添加更多默认语言](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md)
默认提供了英语、捷克语、法语、德语、意大利语、日语、葡萄牙语、荷兰语、丹麦语、西班牙语、土耳其语、阿拉伯语、挪威语、波斯语、希伯来语、简体中文、韩语、印度尼西亚语、俄罗斯语和瑞典语的翻译 UI 字符串,我们欢迎[贡献添加更多默认语言](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md)

你可以通过 `i18n` 数据集合提供你支持的其他语言的翻译 - 或覆盖我们的默认标签。

Expand Down
Loading

0 comments on commit 2f2936c

Please sign in to comment.