Skip to content

Commit

Permalink
i18n(id): Update reference/frontmatter.md translation (#2468)
Browse files Browse the repository at this point in the history 
Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com>
  • Loading branch information
@iyyafi @HiDeoo
iyyafi and HiDeoo authored Oct 16, 2024
1 parent 5e37616 commit 46d53aa
Showing 1 changed file with 118 additions and 7 deletions.
125 changes: 118 additions & 7 deletions docs/src/content/docs/id/reference/frontmatter.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,9 @@ description: Ikhtisar bidang frontmatter bawaan yang didukung Starlight.

Anda dapat menyesuaikan masing-masing halaman Markdown dan MDX di Starlight dengan menetapkan nilai di frontmatter. Sebagai contoh, halaman biasa dapat mengatur bidang `title` dan `description`:

```md
```md {3-4}
---
# src/content/docs/example.md
title: Tentang proyek ini
description: Pelajari lebih lanjut tentang proyek yang sedang Saya kerjakan.
---
Expand All @@ -28,6 +29,12 @@ Anda harus memberikan judul untuk setiap halaman. Ini akan ditampilkan di bagian

Deskripsi halaman digunakan untuk metadata halaman dan akan diambil oleh mesin pencari dan dalam pratinjau media sosial.

### `slug`

**tipe**: `string`

Ganti slug halaman. Lihat [“Mendefinisikan slug khusus”](https://docs.astro.build/en/guides/content-collections/#defining-custom-slugs) di dokumentasi Astro untuk detail lebih lanjut.

### `editUrl`

**tipe:** `string | boolean`
Expand All @@ -42,6 +49,7 @@ Anda dapat menambahkan tag tambahan ke `<head>` halaman Anda menggunakan bidang

```md
---
# src/content/docs/example.md
title: Tentang kami
head:
# Gunakan tag <title> khusus
Expand All @@ -59,6 +67,7 @@ Sesuaikan tingkat judul yang akan disertakan atau atur ke `false` untuk menyembu

```md
---
# src/content/docs/example.md
title: Halaman dengan hanya H2 dalam daftar isi
tableOfContents:
minHeadingLevel: 2
Expand All @@ -68,6 +77,7 @@ tableOfContents:

```md
---
# src/content/docs/example.md
title: Halaman tanpa daftar isi
tableOfContents: false
---
Expand All @@ -92,6 +102,7 @@ Sebagai contoh, konfigurasi ini menampilkan beberapa opsi umum, termasuk memuat

```md
---
# src/content/docs/example.md
title: Halaman Beranda Saya
template: splash
hero:
Expand All @@ -104,22 +115,25 @@ hero:
- text: Ceritakan lebih banyak
link: /getting-started/
icon: right-arrow
variant: primary
- text: Lihat di GitHub
link: https://github.com/astronaut/my-project
icon: external
variant: minimal
attrs:
rel: me
---
```

Anda dapat menampilkan versi gambar _hero_ yang berbeda dalam mode terang dan gelap.

```md
---
# src/content/docs/example.md
hero:
image:
alt: Logo yang berkilauan dan berwarna cerah
dark: ../../assets/logo-dark.png
light: ../../assets/logo-light.png
dark: ~/assets/logo-dark.png
light: ~/assets/logo-light.png
---
```

Expand Down Expand Up @@ -152,8 +166,9 @@ interface HeroConfig {
actions?: Array<{
text: string;
link: string;
variant: 'primary' | 'secondary' | 'minimal';
icon: string;
variant?: 'primary' | 'secondary' | 'minimal';
icon?: string;
attrs?: Record<string, string | number | boolean>;
}>;
}
```
Expand All @@ -169,6 +184,7 @@ Sebagai contoh, halaman ini menampilkan spanduk yang menyertakan tautan ke `exam

```md
---
# src/content/docs/example.md
title: Halaman dengan banner
banner:
content: |
Expand All @@ -185,6 +201,7 @@ Mengesampingkan [opsi `lastUpdated` global](/id/reference/configuration/#lastupd

```md
---
# src/content/docs/example.md
title: Halaman dengan tanggal pembaruan terakhir khusus
lastUpdated: 2022-08-09
---
Expand All @@ -198,20 +215,23 @@ Mengesampingkan [opsi `pagination` global](/id/reference/configuration/#paginati

```md
---
# src/content/docs/example.md
# Menyembunyikan tautan halaman sebelumnya
prev: false
---
```

```md
---
# src/content/docs/example.md
# Mengganti teks tautan halaman sebelumnya
prev: lanjutkan tutorial
---
```

```md
---
# src/content/docs/example.md
# Mengabaikan tautan dan teks halaman sebelumnya
prev:
link: /halaman-yang-tidak-berkaitkan/
Expand All @@ -227,6 +247,7 @@ Sama seperti [`prev`](#prev) tetapi untuk tautan halaman berikutnya.

```md
---
# src/content/docs/example.md
# Menyembunyikan tautan halaman berikutnya
next: false
---
Expand All @@ -241,11 +262,27 @@ Mengatur apakah halaman ini harus disertakan dalam indeks pencarian [Pagefind](h

```md
---
# src/content/docs/example.md
# Sembunyikan halaman ini dari indeks pencarian
pagefind: false
---
```

### `draft`

**tipe:** `boolean`
**bawaan:** `false`

Tetapkan apakah halaman ini harus dianggap sebagai draf dan tidak disertakan dalam [versi produksi](https://docs.astro.build/en/reference/cli-reference/#astro-build) dan [grup tautan yang dibuat secara otomatis](/id/guides/sidebar/#grup-grup-yang-dihasilkan-secara-otomatis). Ubah ke `true` untuk menandai halaman sebagai draf dan membuatnya hanya terlihat selama masa pengembangan.

```md
---
# src/content/docs/example.md
# Kecualikan halaman ini dari versi produksi
draft: true
---
```

### `sidebar`

**tipe:** [`SidebarConfig`](#sidebarconfig)
Expand Down Expand Up @@ -273,6 +310,7 @@ Atur label untuk halaman ini di _sidebar_ saat ditampilkan dalam grup tautan yan

```md
---
# src/content/docs/example.md
title: Tentang proyek ini
sidebar:
label: Tentang
Expand All @@ -288,6 +326,7 @@ Nomor yang lebih rendah ditampilkan lebih tinggi dalam grup tautan.

```md
---
# src/content/docs/example.md
title: Halaman yang akan ditampilkan pertama kali
sidebar:
order: 1
Expand All @@ -303,6 +342,7 @@ Mencegah halaman ini disertakan dalam grup _sidebar_ yang dibuat secara otomatis

```md
---
# src/content/docs/example.md
title: Halaman yang disembunyikan dari sidebar yang dibuat secara otomatis
sidebar:
hidden: true
Expand All @@ -315,10 +355,11 @@ sidebar:

Menambahkan _badge_ ke halaman di _sidebar_ saat ditampilkan dalam grup tautan yang dibuat secara otomatis.
Saat menggunakan string, _badge_ akan ditampilkan dengan warna aksen bawaan.
Secara opsional, berikan [objek `BadgeConfig`](/id/reference/configuration/#badgeconfig) dengan bidang `text` dan `variant` untuk menyesuaikan _badge_.
Secara opsional, berikan [objek `BadgeConfig`](/id/reference/configuration/#badgeconfig) dengan bidang `text`, `variant`, dan `class` untuk menyesuaikan _badge_.

```md
---
# src/content/docs/example.md
title: Halaman dengan badge
sidebar:
# Menggunakan varian bawaan yang sesuai dengan warna aksen situs Anda
Expand All @@ -328,6 +369,7 @@ sidebar:

```md
---
# src/content/docs/example.md
title: Halaman badge
sidebar:
badge:
Expand All @@ -344,10 +386,79 @@ Atribut HTML untuk ditambahkan ke tautan halaman di _sidebar_ saat ditampilkan d

```md
---
# src/content/docs/example.md
title: Membuka halaman di tab baru
sidebar:
# Membuka halaman di tab baru
attrs:
target: _blank
---
```

## Sesuaikan skema frontmatter

Skema frontmatter untuk koleksi konten `docs` Starlight dikonfigurasikan dalam `src/content/config.ts` menggunakan helper `docsSchema()`:

```ts {3,6}
// src/content/config.ts
import { defineCollection } from 'astro:content';
import { docsSchema } from '@astrojs/starlight/schema';

export const collections = {
docs: defineCollection({ schema: docsSchema() }),
};
```

Pelajari selengkapnya tentang koleksi skema konten di [“Mendefinisikan koleksi skema”](https://docs.astro.build/en/guides/content-collections/#defining-a-collection-schema) di dokumentasi Astro.

`docsSchema()` memiliki opsi berikut:

### `extend`

**tipe:** Skema Zod atau fungsi yang mengembalikan skema Zod
**bawaan:** `z.object({})`

Pengembangan skema Starlight dengan kolom tambahan dengan menyetel `extend` dalam opsi `docsSchema()`.
Nilainya harus berupa [skema Zod](https://docs.astro.build/en/guides/content-collections/#defining-datatypes-with-zod).

Dalam contoh berikut, kami menyediakan tipe yang lebih ketat untuk `description` agar menjadi wajib dan menambahkan kolom `category` opsional baru:

```ts {8-13}
// src/content/config.ts
import { defineCollection, z } from 'astro:content';
import { docsSchema } from '@astrojs/starlight/schema';

export const collections = {
docs: defineCollection({
schema: docsSchema({
extend: z.object({
// Jadikan kolom bawaan sebagai wajib, bukan opsional.
description: z.string(),
// Tambahkan kolom baru ke skema.
category: z.enum(['tutorial', 'guide', 'reference']).optional(),
}),
}),
}),
};
```

Untuk memanfaatkan [_Astro `image()` helper_](https://docs.astro.build/en/guides/images/#images-in-content-collections), gunakan fungsi yang mengembalikan ekstensi skema Anda:

```ts {8-13}
// src/content/config.ts
import { defineCollection, z } from 'astro:content';
import { docsSchema } from '@astrojs/starlight/schema';

export const collections = {
docs: defineCollection({
schema: docsSchema({
extend: ({ image }) => {
return z.object({
// Tambahkan kolom yang harus dilengkapi ke gambar lokal.
cover: image(),
});
},
}),
}),
};
```

0 comments on commit 46d53aa

Please sign in to comment.