Skip to content

Commit

Permalink
i18n(id): Update some translations in Indonesian (#1064)
Browse files Browse the repository at this point in the history 
Co-authored-by: Chris Swithinbank <[email protected]>
  • Loading branch information
@nazhard @delucis
nazhard and delucis authored Nov 17, 2023
1 parent 01c9d4e commit c318376
Show file tree
Hide file tree
Showing 7 changed files with 140 additions and 68 deletions.
119 changes: 82 additions & 37 deletions docs/src/content/docs/id/getting-started.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,125 +5,170 @@ description: Pelajari cara membuat website dokumentasi baru Anda dengan Starligh

import { Tabs, TabItem } from '@astrojs/starlight/components';

## Membuat Proyek Baru
Starlight adalah tema dokumentasi berfitur lengkap yang dibangun di atas _framework_ [Astro](https://astro.build).
Panduan ini akan membantu Anda memulai proyek baru.
Lihat [petunjuk penyiapan manual](/id/manual-setup/) untuk menambahkan Starlight ke proyek Astro yang sudah ada.

Starlight adalah tema website dokumentasi berfitur lengkap berbasis [Astro](https://astro.build).
## Mulai Cepat

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

Buat proyek Astro + Starlight baru dengan menjalankan perintah berikut di terminal Anda:

<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](/id/guides/project-structure/) baru berisikan seluruh file dan konfigurasi untuk website Anda.
Perintah tersebut akan membuat [direktori proyek](/id/guides/project-structure/) baru berisikan seluruh file dan konfigurasi yang diperlukan untuk website Anda.

:::tip[Lihat contohnya]
Cobalah Starlight di browser:
:::tip[Lihat itu beraksi]
Cobalah Starlight di browser Anda:
[buka dengan StackBlitz](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics).
:::

## Membuat konten dengan Starlight
### Mulai server pengembangan

Starlight sudah siap untuk ditambahkan konten baru, atau pindahkan konten lama Anda!
Ketika bekerja secara lokal, [server pengembangan Astro](https://docs.astro.build/en/reference/cli-reference/#astro-dev) memungkinkan Anda melihat pratinjau pekerjaan Anda dan secara otomatis me-_refresh_ peramban ketika Anda membuat perubahan.

### Format file
Di dalam direktori proyek Anda, jalankan perintah berikut untuk memulai server pengembangan:

Starlight mendukung pembuatan konten dalam bentuk Markdown and MDX. (Anda dapat menambahkan support untuk Markdoc dengan menginstall integrasi eksperimental [Astro Markdoc](https://docs.astro.build/en/guides/integrations-guide/markdoc/).)
<Tabs>
<TabItem label="npm">

### Tambah halaman baru
```sh
npm run dev
```

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:
</TabItem>
<TabItem label="pnpm">

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

</TabItem>
<TabItem label="Yarn">

```sh
yarn dev
```

### Frontmatter yang type-safe
</TabItem>
</Tabs>

Ini akan mencatat pesan ke terminal Anda dengan URL pratinjau lokal Anda.
Buka URL tersebut untuk mulai menjelajahi situs Anda.

### Tambahkan konten

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

#### Format file

Starlight mendukung penulisan konten dalam bentuk Markdown dan MDX tanpa memerlukan konfigurasi.
Anda dapat menambahkan dukungan untuk Markdoc dengan memasang [integrasi Astro Markdoc](https://docs.astro.build/en/guides/integrations-guide/markdoc/) eksperimental.

#### Tambahkan halaman

Tambahkan halaman baru ke situs Anda dengan cara membuat file `.md` atau `.mdx` di `src/content/docs/`.
Gunakan sub-folder untuk mengatur konten Anda dan untuk membuat beberapa segmen _path_.

Sebagai contoh, struktur file berikut ini akan menghasilkan halaman di `example.com/hello-world` dan `example.com/guides/faq`:

import FileTree from '../../../components/file-tree.astro';

<FileTree>

- src/
- content/
- docs/
- guides/
- faq.md
- hello-world.md

</FileTree>

#### Frontmatter yang type-safe

Semua halaman Starlight berbagi [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
title: Halo, Dunia!
description: Ini adalah halaman di situs saya yang didukung Starlight
---
```

Jika ada properti yang terlewat, Starlight akan memberitahu Anda.

## Deploy website Starlight Anda
Jika Anda lupa sesuatu yang penting, Starlight akan memberi tahu 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.
### Langkah selanjutnya

[Pelajari cara men-_deploy_ website Astro di dokumentasi Astro.](https://docs.astro.build/en/guides/deploy/)
- **Mengkonfigurasi:** Pelajari tentang opsi umum dalam ["Menyesuaikan Starlight”](/id/guides/customization/).
- **Navigasi:** Siapkan sidebar Anda dengan panduan ["Navigasi Sidebar”](/id/guides/sidebar/).
- **Komponen:** Temukan kartu, tab dan bawaan lainnya di dalam panduan ["Komponen”](/id/guides/components/).
- **Sebarkan:** Publikasikan karya Anda dengan panduan [“_Deploy_ situs Anda”](https://docs.astro.build/en/guides/deploy/) di dokumentasi Astro.

## Memperbaharui Starlight
## Memperbarui Starlight

:::tip
Karena Starlight masih berstatus beta, akan ada pembaruan dan peningkatan yang cukup sering. Pastikan Anda selalu memperbaharui Starlight secara rutin!
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 cara memperbaharuinya sama seperti integrasi `@astrojs/*` yang lain:
Starlight adalah integrasi Astro, dan diperbarui seperti integrasi `@astrojs/*` lainnya:

<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 melihat daftar lengkap perubahan-perubahan yang dilakukan dalam setiap rilis di [_changelog_](https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md).
Lihat [_changelog_ Starlight](https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md) untuk daftar lengkap perubahan yang dibuat dalam setiap rilis.

## Troubleshooting Starlight

[Konfigurasi proyek](/id/reference/configuration/) dan [konfigurasi _frontmatter_](/id/reference/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.
Gunakan [konfigurasi proyek](/id/reference/configuration/) dan halaman referensi [konfigurasi _frontmatter_ halaman individual](/id/reference/frontmatter/) 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 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 Astro bekerja secara umum, sebagai basis dari Starlight.
Jika jawaban Anda tidak dapat ditemukan dalam dokumentasi ini, silakan kunjungi [Dokumentasi Astro](https://docs.astro.build) untuk dokumentasi lengkap Astro.
Pertanyaan Anda mungkin terjawab dengan memahami cara kerja Astro secara umum, di bawah tema Starlight ini.

Anda juga dapat merujuk kepada [isu-isu di GitHub](https://github.com/withastro/starlight/issues), dan mendapatkan bantuan di [Astro Discord](https://astro.build/chat/) 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!
Anda juga dapat memeriksa masalah Starlight yang diketahui di [GitHub](https://github.com/withastro/starlight/issues), dan dapatkan bantuan di [Astro Discord](https://astro.build/chat/) 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!
26 changes: 15 additions & 11 deletions docs/src/content/docs/id/guides/authoring-content.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,10 @@ Pastikan untuk mengecek [dokumentasi MDX](https://mdxjs.com/docs/what-is-mdx/#ma

## Inline styles

Text bisa **bold**, _italic_, atau ~~strikethrough~~.
Teks bisa **bold**, _italic_, atau ~~strikethrough~~.

```md
Text bisa **bold**, _italic_, atau ~~strikethrough~~.
Teks bisa **bold**, _italic_, atau ~~strikethrough~~.
```

Anda dapat [menautkan ke halaman lain](/id/getting-started/).
Expand Down Expand Up @@ -84,20 +84,20 @@ Saya dapat menautkan ke [kesimpulan saya](#kesimpulan) di bagian bawah halaman y

## Kesimpulan

`https://my-site.com/halaman1/#pengantar` langsung menuju ke Pengantar saya.
`https://situs-saya.com/halaman1/#pengantar` langsung menuju ke Pengantar saya.
```

Judul Level 2 (`<h2>`) dan Level 3 (`<h3>`) akan secara otomatis muncul di daftar isi halaman.

## Asides

_Asides_ (juga sering disebut sebagai _“admonitions”_ atau “_callouts”_) berguna untuk menampilkan informasi sekunder bersama konten utama halaman.
_Asides_ (juga sering disebut sebagai _“admonitions”_ atau “_callouts”_) berguna untuk menampilkan informasi sekunder di samping konten utama halaman.

Starlight menyediakan sintaks Markdown kustom untuk merender _asides_. Blok _asides_ ditandai dengan sepasang tiga titik dua `:::` untuk melingkupi konten Anda, dan dapat berjenis `note`, `tip`, `caution`, atau `danger`.

Anda dapat menyusun berbagai jenis konten Markdown lainnya di dalam sebuah _asides_, tetapi _asides_ lebih cocok untuk potongan konten yang pendek dan padat.

### Catatan Sampingan
### Catatan Asides

:::note
Starlight adalah toolkit website dokumentasi yang dibangun dengan [Astro](https://astro.build/). Anda dapat memulai dengan perintah ini:
Expand All @@ -124,12 +124,12 @@ npm create astro@latest -- --template starlight
Anda dapat menentukan judul kustom untuk _asides_ dengan menambahkan tanda kurung siku setelah jenis _asides-nya_, misalnya `:::tip[Apakah Anda tahu?]`.

:::tip[Apakah Anda tahu?]
Astro membantu Anda membangun website lebih cepat dengan “Arsitektur Pulau”.
Astro membantu Anda membangun website lebih cepat dengan [“Islands Architecture”](https://docs.astro.build/en/concepts/islands/).
:::

```md
:::tip[Apakah Anda tahu?]
Astro membantu Anda membangun website lebih cepat dengan “Arsitektur Pulau”.
Astro membantu Anda membangun website lebih cepat dengan [“Islands Architecture”](https://docs.astro.build/en/concepts/islands/).
:::
```

Expand All @@ -139,15 +139,15 @@ _Asides_ berjenis _caution_ dan _danger_ berguna untuk menarik perhatian penggun
Jika Anda sering menggunakan ini, mungkin juga pertanda bahwa hal yang Anda dokumentasikan sepertinya bisa di-desain ulang.

:::caution
Jika Anda tidak yakin ingin membuat situs dokumen yang menakjubkan, pikirkan dua kali sebelum menggunakan [Starlight](../../).
Jika Anda tidak yakin ingin membuat situs dokumentasi yang menakjubkan, pikirkan dua kali sebelum menggunakan [Starlight](../../).
:::

:::danger
Pengguna Anda mungkin lebih produktif dan menemukan produk Anda lebih mudah digunakan berkat fitur-fitur Starlight yang membantu.

- Navigasi yang jelas
- Tema warna yang dapat dikonfigurasi oleh pengguna
- [i18n support](/id/guides/i18n)
- [Dukungan i18n](/id/guides/i18n)

:::

Expand All @@ -161,7 +161,7 @@ Pengguna Anda mungkin lebih produktif dan menemukan produk Anda lebih mudah digu

- Navigasi yang jelas
- Tema warna yang dapat dikonfigurasi oleh pengguna
- [i18n support](/id/guides/i18n)
- [Dukungan i18n](/id/guides/i18n)

:::
```
Expand Down Expand Up @@ -206,4 +206,8 @@ Kode satu baris tunggal yang panjang sebaiknya tidak di-wrap. Kode tersebut haru

## Fitur Umum Markdown Lainnya

Starlight mendukung penulisan semua sintaks Markdown lainnya, seperti daftar dan tabel. Lihat [Markdown Cheat Sheet from The Markdown Guide](https://www.markdownguide.org/cheat-sheet/) untuk penjelasan singkat tentang semua sintaks elemen Markdown.
Starlight mendukung penulisan semua sintaks Markdown lainnya, seperti daftar dan tabel. Lihat [Markdown Cheat Sheet dari The Markdown Guide](https://www.markdownguide.org/cheat-sheet/) untuk penjelasan singkat tentang semua sintaks elemen Markdown.

## Konfigurasi Markdown dan MDX Lanjutan

Starlight menggunakan Markdown dan renderer MDX Astro yang dibangun berdasarkan remark dan rehype. Anda dapat menambahkan dukungan untuk sintaks dan perilaku khusus dengan menambahkan `remarkPlugins` atau `rehypePlugins` di file konfigurasi Astro Anda. Lihat [“Configuring Markdown and MDX”](https://docs.astro.build/en/guides/markdown-content/#configuring-markdown-and-mdx) dalam dokumentasi Astro untuk mempelajari lebih lanjut.
23 changes: 11 additions & 12 deletions docs/src/content/docs/id/guides/css-and-tailwind.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Anda dapat menggunakan custom CSS atau menggunakan plugin Tailwind Starlight unt

Sesuaikan style yang diterapkan pada website Starlight Anda dengan memberikan file CSS tambahan untuk memodifikasi atau menambahkan style ke style default dari Starlight.

1. Tambakan file CSS ke direktori `src/` Anda.
1. Tambakan sebuah file CSS ke direktori `src/` Anda.
Sebagai contoh, Anda dapat mengatur lebar kolom default yang lebih lebar dan ukuran teks yang lebih besar untuk judul halaman:

```css
Expand Down Expand Up @@ -147,7 +147,7 @@ Jika Anda sudah memiliki website Starlight dan ingin menambahkan Tailwind CSS, i

</Tabs>

3. Buat file CSS untuk base styles Tailwind, misalnya di `src/tailwind.css`:
3. Buat file CSS untuk _base styles_ Tailwind, misalnya di `src/tailwind.css`:

```css
/* src/tailwind.css */
Expand Down Expand Up @@ -181,14 +181,14 @@ Jika Anda sudah memiliki website Starlight dan ingin menambahkan Tailwind CSS, i
});
```

5. Tambahkan plugin Tailwind Starlight ke `tailwind.config.cjs`:
5. Tambahkan plugin Tailwind Starlight ke `tailwind.config.mjs`:

```js ins={2,7}
// tailwind.config.cjs
const starlightPlugin = require('@astrojs/starlight-tailwind');
// tailwind.config.mjs
import starlightPlugin from '@astrojs/starlight-tailwind';

/** @type {import('tailwindcss').Config} */
module.exports = {
export default {
content: ['./src/**/*.{astro,html,js,jsx,md,mdx,svelte,ts,tsx,vue}'],
plugins: [starlightPlugin()],
};
Expand All @@ -206,12 +206,12 @@ Jika diatur, opsi berikut akan menggantikan style bawaan Starlight:
- `fontFamily.mono` — digunakan untuk contoh kode

```js {12,14,18,20}
// tailwind.config.cjs
const starlightPlugin = require('@astrojs/starlight-tailwind');
const colors = require('tailwindcss/colors');
// tailwind.config.mjs
import starlightPlugin from '@astrojs/starlight-tailwind';
import colors from 'tailwindcss/colors';

/** @type {import('tailwindcss').Config} */
module.exports = {
export default {
content: ['./src/**/*.{astro,html,js,jsx,md,mdx,svelte,ts,tsx,vue}'],
theme: {
extend: {
Expand Down Expand Up @@ -278,8 +278,7 @@ import ThemeDesigner from '../../../../components/theme-designer.astro';
}}
>
<Fragment slot="css-docs">
Tambahkan CSS berikut ke proyek Anda dalam [file CSS
custom](#custom-css-styles) untuk menerapkan tema ini ke website Anda.
Tambahkan CSS berikut ke proyek Anda dalam [file CSS custom](#custom-css-styles) untuk menerapkan tema ini ke website Anda.
</Fragment>
<Fragment slot="tailwind-docs">
Contoh [file konfigurasi Tailwind ](#styling-starlight-dengan-tailwind) di
Expand Down
6 changes: 3 additions & 3 deletions docs/src/content/docs/id/guides/i18n.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@ Ketika menggunakan locale `root`, simpan halaman untuk bahasa tersebut langsung

#### Website monolingual

Secara default, Starlight adalah website monolingual (Inggris). Untuk membuat website monolingual dalam bahasa lain, tetapkan bahasa tersebut sebagai `root` dalam konfigurasi `locales` Anda:
Secara default, Starlight adalah website monolingual (Inggris). Untuk membuat situs bahasa tunggal dalam bahasa lain, tetapkan bahasa tersebut sebagai `root` dalam konfigurasi `locales` Anda:

```js
// astro.config.mjs
Expand Down Expand Up @@ -143,7 +143,7 @@ Jika terjemahan belum tersedia untuk suatu bahasa, Starlight akan menampilkan ko

Selain menyimpan file konten yang diterjemahkan, Starlight memungkinkan Anda menerjemahkan string UI default (misalnya, judul "Di halaman ini" dalam daftar isi) sehingga pembaca Anda dapat mengakses website Anda sepenuhnya dalam bahasa yang dipilih.

String UI yang diterjemahkan dalam bahasa Inggris, Ceko, Prancis, Jerman, Italia, Jepang, Portugis, Belanda, Denmark, Spanyol, Turki, Arab, Norwegia, Farsi, Ibrani, Cina (yang disederhanakan), Korea, Indonesia, Rusia, Swedia, Ukraina, dan Vietnam sudah disediakan secara bawaan, dan kami menyambut [kontribusi untuk menambahkan lebih banyak bahasa default](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
String UI yang diterjemahkan dalam bahasa Inggris, Ceko, Prancis, Jerman, Italia, Jepang, Portugis, Belanda, Denmark, Spanyol, Turki, Arab, Norwegia, Farsi, Ibrani, Cina (yang disederhanakan), Korea, Indonesia, Rusia, Swedia, Ukraina, Vietnam, dan Galisia sudah disediakan secara bawaan, dan kami menyambut [kontribusi untuk menambahkan lebih banyak bahasa default](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).

Anda dapat memberikan terjemahan untuk bahasa tambahan yang Anda dukung — atau mengganti label default kami — melalui koleksi data `i18n`.

Expand Down Expand Up @@ -202,7 +202,7 @@ Anda dapat memberikan terjemahan untuk bahasa tambahan yang Anda dukung — atau
}
```

Modal pencarian Starlight didukung oleh library [Pagefind](https://pagefind.app/).
Modal pencarian Starlight didukung oleh pustaka [Pagefind](https://pagefind.app/).
Anda dapat mengatur terjemahan untuk UI Pagefind di file JSON yang sama menggunakan properti-properti `pagefind`:

```json
Expand Down
Loading

0 comments on commit c318376

Please sign in to comment.