diff options
author | x0r | 2023-10-13 21:19:29 +0700 |
---|---|---|
committer | GitHub | 2023-10-13 16:19:29 +0200 |
commit | eaa7a902c7b7638b326709fd5203d932b20ed3fa (patch) | |
tree | 8741ceabdb9d11c7fc0092c528906107245f96dc | |
parent | a137a6f67fbe62b9dab9d994b0a24ec2faf6feb0 (diff) | |
download | IT.starlight-eaa7a902c7b7638b326709fd5203d932b20ed3fa.tar.gz IT.starlight-eaa7a902c7b7638b326709fd5203d932b20ed3fa.tar.bz2 IT.starlight-eaa7a902c7b7638b326709fd5203d932b20ed3fa.zip |
i18n(id): Translate more pages and improve existing translations (#859)
Co-authored-by: oggnimodd <arnolddominggo19@gmail.com>
Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
-rw-r--r-- | .changeset/quick-chefs-sin.md | 5 | ||||
-rw-r--r-- | docs/src/content/docs/id/environmental-impact.md | 135 | ||||
-rw-r--r-- | docs/src/content/docs/id/getting-started.mdx | 34 | ||||
-rw-r--r-- | docs/src/content/docs/id/index.mdx | 16 | ||||
-rw-r--r-- | docs/src/content/docs/id/manual-setup.mdx | 38 | ||||
-rw-r--r-- | docs/src/content/docs/id/showcase.mdx | 53 | ||||
-rw-r--r-- | packages/starlight/translations/id.json | 2 |
7 files changed, 238 insertions, 45 deletions
diff --git a/.changeset/quick-chefs-sin.md b/.changeset/quick-chefs-sin.md new file mode 100644 index 00000000..7c79acab --- /dev/null +++ b/.changeset/quick-chefs-sin.md @@ -0,0 +1,5 @@ +--- +"@astrojs/starlight": patch +--- + +Improve Indonesian language support diff --git a/docs/src/content/docs/id/environmental-impact.md b/docs/src/content/docs/id/environmental-impact.md new file mode 100644 index 00000000..d904e228 --- /dev/null +++ b/docs/src/content/docs/id/environmental-impact.md @@ -0,0 +1,135 @@ +--- +title: Dokumentasi yang ramah lingkungan +description: Pelajari bagaimana Starlight bisa membantu Anda membangun website dokumentasi yang lebih ramah lingkungan dan mengurangi jejak karbon Anda. +--- + +Estimasi dampak dari industri web terhadap iklim berkisar antara [2%][sf] hingga [4% dari emisi karbon global ][bbc], kira-kira setara dengan emisi industri penerbangan. Ada banyak faktor kompleks dalam menghitung dampak ekologis sebuah website, namun panduan ini mencakup beberapa tips untuk mengurangi jejak lingkungan dari website dokumentasi Anda. + +Berita baiknya adalah, memilih Starlight adalah awal yang baik. Menurut Website Carbon Calculator, website ini [lebih bersih daripada 99% website-website yang telah diuji][sl-carbon], menghasilkan 0,01g CO₂ per kunjungan halaman. + +## Berat halaman + +Semakin banyak data yang ditransfer oleh sebuah halaman web, semakin banyak sumber daya energi yang diperlukan. +Pada bulan April 2023, nilai median dari banyaknya data yang harus di-_download_ user ketika mengakses sebuah halaman website adalah lebih dari 2.000 KB berdasarkan [data dari HTTP Archive][http]. + +Starlight membangun halaman-halaman yang seringan mungkin. Sebagai contoh, pada kunjungan pertama, pengguna hanya perlu mengunduh kurang dari 50 KB data yang telah dikompresi — hanya 2,5% dari nilai median HTTP Archive. Dengan strategi caching yang baik, kunjungan selanjutnya dapat mengunduh hanya sekitar 10 KB. + +### Gambar + +Meskipun Starlight memberikan basis yang baik, gambar yang Anda tambahkan ke halaman dokumentasi Anda dapat dengan cepat meningkatkan berat halaman Anda. +Starlight menggunakan [dukungan aset yang dioptimalkan][assets] dari Astro untuk mengoptimalkan gambar lokal dalam file Markdown dan MDX Anda. + +### Komponen UI + +Komponen yang dibangun dengan _UI frameworks_ seperti React atau Vue dapat dengan mudah menambahkan banyak JavaScript ke halaman. +Karena Starlight dibangun di atas Astro, komponen seperti ini secara default tidak memuat JavaScript di sisi klien berkat [Astro Islands][islands]. + +### Caching + +_Caching_ digunakan untuk mengontrol berapa lama browser menyimpan dan menggunakan kembali data yang telah diunduh sebelumnya. +Strategi caching yang baik memastikan bahwa pengguna mendapatkan konten baru sesegera mungkin ketika ada perubahan, tetapi juga menghindari pengunduhan yang tidak perlu dari konten yang sama berulang kali ketika konten tersebut tidak mengalami perubahan. + +Cara paling umum untuk mengonfigurasi caching adalah dengan menggunakan [`Cache-Control` HTTP header][cache]. +Ketika menggunakan Starlight, Anda dapat mengatur waktu _cache_ yang lama untuk semua yang ada di direktori /\_astro/. +Direktori ini berisi CSS, JavaScript, dan aset lainnya yang dapat di-cache secara permanen, mengurangi pengunduhan yang tidak perlu: + +``` +Cache-Control: public, max-age=604800, immutable +``` + +Cara mengkonfigurasi caching tergantung pada penyedia hosting website Anda. Misalnya, Vercel menerapkan strategi caching ini untuk Anda tanpa ada konfigurasi yang diperlukan, sementara Anda dapat mengatur [header kustom untuk Netlify][ntl-headers] dengan menambahkan file `public/_headers` ke proyek Anda: + +``` +/_astro/* + Cache-Control: public + Cache-Control: max-age=604800 + Cache-Control: immutable +``` + +[cache]: https://csswizardry.com/2019/03/cache-control-for-civilians/ +[ntl-headers]: https://docs.netlify.com/routing/headers/ + +## Konsumsi daya + +Cara sebuah halaman web dibangun dapat mempengaruhi besarnya daya yang dibutuhkan untuk menjalankannya di perangkat pengguna. +Dengan menggunakan JavaScript yang minimal, Starlight mengurangi jumlah daya pemrosesan yang dibutuhkan oleh telepon, tablet, atau komputer pengguna untuk memuat dan merender halaman. + +Perhatikan saat menambahkan fitur seperti skrip pelacakan analitik atau konten yang kaya akan JavaScript seperti video yang disematkan, karena hal ini dapat meningkatkan penggunaan daya halaman. +Jika Anda memerlukan analitik, pertimbangkan untuk memilih opsi yang lebih ringan seperti [Cabin][cabin], [Fathom][fathom], atau [Plausible][plausible]. +Penyisipan video seperti YouTube dan Vimeo dapat ditingkatkan dengan menunggu [pemuatan video saat ada interaksi pengguna][lazy-video]. +_Package_ seperti [astro-embed][embed] dapat membantu untuk layanan umum. + +:::tip[Tahukah Anda?] +_Parsing_ dan kompilasi JavaScript adalah salah satu tugas yang paling mahal bagi browser. +Dibandingkan dengan merender gambar JPEG dengan ukuran yang sama, [pemrosesan JavaScript dapat memakan waktu lebih dari 30 kali lebih lama][cost-of-js]. +::: + +[cabin]: https://withcabin.com/ +[fathom]: https://usefathom.com/ +[plausible]: https://plausible.io/ +[lazy-video]: https://web.dev/iframe-lazy-loading/ +[embed]: https://www.npmjs.com/package/astro-embed +[cost-of-js]: https://medium.com/dev-channel/the-cost-of-javascript-84009f51e99e + +## Hosting + +Dimana website di-_hosting_ dapat memiliki dampak besar terhadap seberapa ramah lingkungan website dokumentasi Anda. +Pusat data dan rumah server dapat memiliki dampak ekologis yang besar, termasuk konsumsi listrik yang tinggi dan penggunaan air yang intensif. + +Memilih penyedia hosting yang menggunakan energi terbarukan berarti emisi karbon yang lebih rendah untuk website Anda. [Green Web Directory][gwb] adalah salah satu alat yang dapat membantu Anda menemukan perusahaan hosting yang ramah lingkungan. + +[gwb]: https://www.thegreenwebfoundation.org/directory/ + +## Perbandingan + +Tertarik bagaimana perbandingannya dengan _framework_ dokumentasi lainnya? Tes ini dengan [Website Carbon Calculator][wcc] membandingkan halaman-halaman serupa yang dibangun dengan _tool_ yang berbeda. + +| Framework | CO₂ per page visit | +| --------------------------- | ------------------ | +| [Starlight][sl-carbon] | 0.01g | +| [VitePress][vp-carbon] | 0.05g | +| [Docus][dc-carbon] | 0.05g | +| [Sphinx][sx-carbon] | 0.07g | +| [MkDocs][mk-carbon] | 0.10g | +| [Nextra][nx-carbon] | 0.11g | +| [docsify][dy-carbon] | 0.11g | +| [Docusaurus][ds-carbon] | 0.24g | +| [Read the Docs][rtd-carbon] | 0.24g | +| [GitBook][gb-carbon] | 0.71g | + +<small>Data dikumpulkan pada 14 Mei 2023. Klik link untuk melihat angka terkini.</small> + +[sl-carbon]: https://www.websitecarbon.com/website/starlight-astro-build-getting-started/ +[vp-carbon]: https://www.websitecarbon.com/website/vitepress-dev-guide-what-is-vitepress/ +[dc-carbon]: https://www.websitecarbon.com/website/docus-dev-introduction-getting-started/ +[sx-carbon]: https://www.websitecarbon.com/website/sphinx-doc-org-en-master-usage-quickstart-html/ +[mk-carbon]: https://www.websitecarbon.com/website/mkdocs-org-getting-started/ +[nx-carbon]: https://www.websitecarbon.com/website/nextra-site-docs-docs-theme-start/ +[dy-carbon]: https://www.websitecarbon.com/website/docsify-js-org/ +[ds-carbon]: https://www.websitecarbon.com/website/docusaurus-io-docs/ +[rtd-carbon]: https://www.websitecarbon.com/website/docs-readthedocs-io-en-stable-index-html/ +[gb-carbon]: https://www.websitecarbon.com/website/docs-gitbook-com/ + +## Sumber Tambahan + +### Tools + +- [Website Carbon Calculator][wcc] +- [GreenFrame](https://greenframe.io/) +- [Ecograder](https://ecograder.com/) +- [WebPageTest Carbon Control](https://www.webpagetest.org/carbon-control/) +- [Ecoping](https://ecoping.earth/) + +### Articles and presentasi + +- [“Building a greener web”](https://youtu.be/EfPoOt7T5lg), talk by Michelle Barker +- [“Sustainable Web Development Strategies Within An Organization”](https://www.smashingmagazine.com/2022/10/sustainable-web-development-strategies-organization/), article by Michelle Barker +- [“A sustainable web for everyone”](https://2021.stateofthebrowser.com/speakers/tom-greenwood/), talk by Tom Greenwood +- [“How Web Content Can Affect Power Usage”](https://webkit.org/blog/8970/how-web-content-can-affect-power-usage/), article by Benjamin Poulain and Simon Fraser + +[sf]: https://www.sciencefocus.com/science/what-is-the-carbon-footprint-of-the-internet/ +[bbc]: https://www.bbc.com/future/article/20200305-why-your-internet-habits-are-not-as-clean-as-you-think +[http]: https://httparchive.org/reports/state-of-the-web +[assets]: https://docs.astro.build/en/guides/assets/ +[islands]: https://docs.astro.build/en/concepts/islands/ +[wcc]: https://www.websitecarbon.com/ diff --git a/docs/src/content/docs/id/getting-started.mdx b/docs/src/content/docs/id/getting-started.mdx index 45b53ce1..7ab432d7 100644 --- a/docs/src/content/docs/id/getting-started.mdx +++ b/docs/src/content/docs/id/getting-started.mdx @@ -1,13 +1,13 @@ --- title: Memulai -description: Pelajari cara membuat situs dokumentasi baru Anda dengan Starlight oleh Astro. +description: Pelajari cara membuat website 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). +Starlight adalah tema website dokumentasi berfitur lengkap berbasis [Astro](https://astro.build). Anda dapat membuat proyek Astro + Starlight baru menggunakan perintah berikut ini: @@ -38,9 +38,9 @@ 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. +Perintah tersebut akan membuat [direktori proyek](/guides/project-structure/) baru berisikan seluruh file dan konfigurasi untuk website Anda. -:::tip[Coba dulu] +:::tip[Lihat contohnya] Cobalah Starlight di browser: [buka dengan StackBlitz](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics). ::: @@ -51,20 +51,20 @@ Starlight sudah siap untuk ditambahkan konten baru, atau pindahkan konten lama A ### 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/).) +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/).) ### 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: +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_ dengan _type-safety_ yang aman +### Frontmatter yang type-safe -Semua halaman Starlight terdiri dari [properti _frontmatter_ umum](/id/reference/frontmatter/) yang dapat dikostumisasi untuk mengontrol tampilan setiap halaman: +Semua halaman Starlight berbagi [properti _frontmatter_ umum](/id/reference/frontmatter/) yang dapat dikostumisasi untuk mengontrol tampilan setiap halaman: ```md --- @@ -75,11 +75,11 @@ description: This is a page in my Starlight-powered site Jika ada properti yang terlewat, Starlight akan memberitahu Anda. -## _Deploy_ situs Starlight Anda +## Deploy website 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. +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_ situs Astro di dokumentasi Astro.](https://docs.astro.build/en/guides/deploy/) +[Pelajari cara men-_deploy_ website Astro di dokumentasi Astro.](https://docs.astro.build/en/guides/deploy/) ## Memperbaharui Starlight @@ -116,14 +116,14 @@ 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). +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). -## Menyelesaikan masalah pada Starlight +## Troubleshooting 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. +[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 situs Starlight anda. +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](https://docs.astro.build). Pertanyaan Anda biasanya akan terjawab dengan memahami bagaimana umumnya Astro bekerja, sebagai basis dari Starlight. +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. -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! +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! diff --git a/docs/src/content/docs/id/index.mdx b/docs/src/content/docs/id/index.mdx index c75ef9d0..1c2443f6 100644 --- a/docs/src/content/docs/id/index.mdx +++ b/docs/src/content/docs/id/index.mdx @@ -1,6 +1,6 @@ --- -title: Starlight 🌟 Wujudkan situs dokumentasi dengan Astro -description: Starlight membantu mewujudkan situs web dokumentasi yang menawan dan berperforma tinggi dengan Astro. +title: Starlight 🌟 Membangun website dokumentasi dengan Astro +description: Starlight membantu membangun website dokumentasi yang menawan dan berperforma tinggi dengan Astro. template: splash banner: content: | @@ -13,7 +13,7 @@ banner: </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. + tagline: Semua yang Anda butuhkan untuk membangun website dokumentasi yang luar biasa. Cepat, ramah pengguna, dan sangat mudah digunakan. image: file: ../../../assets/hero-star.webp actions: @@ -31,12 +31,12 @@ 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 + Sudah termasuk: Navigasi website, pencarian, terjemahan, SEO, tipografi yang mudah dibaca, _code highlighting_, mode gelap, dan masih banyak lagi. </Card> - <Card title="Ditenagai oleh Astro" icon="rocket"> + <Card title="Berbasis Astro" icon="rocket"> Manfaatkan kekuatan penuh dan performa Astro. Kembangkan Starlight dengan - pustaka dan integrasi Astro favorit Anda. + _library_ dan integrasi Astro favorit Anda. </Card> <Card title="Markdown, Markdoc, and MDX" icon="document"> Gunakan bahasa markup favorit Anda. Starlight menyediakan validasi @@ -49,9 +49,9 @@ import AboutAstro from '../../../components/about-astro.astro'; </CardGrid> <AboutAstro title="Dipersembahkan oleh"> -Astro adalah _framework_ web serbaguna didesain untuk web yang cepat. +Astro adalah _web framework_ serbaguna yang didesain untuk kecepatan. Gunakan konten Anda dari sumber mana saja dan _deploy_ di mana saja, -semua ditenagai dengan pustaka dan komponen UI favorit Anda. +semuanya didukung oleh _library_ dan komponen UI favorit Anda. [Pelajari tentang Astro](https://astro.build/) diff --git a/docs/src/content/docs/id/manual-setup.mdx b/docs/src/content/docs/id/manual-setup.mdx index e3be119c..5168ba34 100644 --- a/docs/src/content/docs/id/manual-setup.mdx +++ b/docs/src/content/docs/id/manual-setup.mdx @@ -5,16 +5,16 @@ description: Pelajari cara mengkonfigurasi Starlight secara manual untuk menamba import { Tabs, TabItem } from '@astrojs/starlight/components'; -Cara tercepat untuk membuat situs Starlight adalah dengan menjalankan perintah `create astro` sebagaimana tercantum di [panduan memulai](/id/getting-started/#creating-a-new-project). +Cara tercepat untuk membuat website Starlight adalah dengan menjalankan perintah `create astro` sebagaimana dijelaskan di [panduan memulai](/id/getting-started/#creating-a-new-project). Jika Anda ingin menambahkan Starlight ke proyek Astro yang sudah ada, berikut ini adalah cara melakukannya. ## Memasang Starlight Untuk mengikuti panduan ini, Anda membutuhkan proyek Astro yang sudah berjalan. -### Add the Starlight integration +### Menambahkan Starlight integration -Starlight adalah sebuah [integrasi Astro](https://docs.astro.build/en/guides/integrations-guide/). Tambahkan ke situs Anda dengan cara menjalankan perintah `astro add` di direktori _root_ proyek: +Starlight adalah sebuah [integrasi Astro](https://docs.astro.build/en/guides/integrations-guide/). Tambahkan ke website Anda dengan cara menjalankan perintah `astro add` di _root directory_ proyek Anda: <Tabs> <TabItem label="npm"> @@ -36,7 +36,7 @@ Starlight adalah sebuah [integrasi Astro](https://docs.astro.build/en/guides/int </Tabs> -Perintah tersebut akan menginstal semua dependensi yang dibutuhkan dan menambahkan Starlight ke dalam _array_ `integrations` di dalam file konfigurasi Astro. +Perintah tersebut akan menginstal semua dependensi yang dibutuhkan dan menambahkan Starlight ke dalam _array_ `integrations` di dalam file konfigurasi Astro Anda. ### Mengkonfigurasi integrasi @@ -60,11 +60,11 @@ export default defineConfig({ Untuk opsi lengkapnya tersedia di [referensi pengaturan Starlight](/id/reference/configuration/). -### Mengatur kumpulan konten +### Mengatur koleksi konten -Starlight dibangun berdasarkan fitur [kumpulan konten](https://docs.astro.build/en/guides/content-collections/) oleh Astro, yang dapat dikonfigurasi di file `src/content/config.ts`. +Starlight dibangun berdasarkan fitur [koleksi konten](https://docs.astro.build/en/guides/content-collections/) oleh Astro, yang dapat dikonfigurasi di file `src/content/config.ts`. -Buat baru atau _update_ file konfigurasi kumpulan konten Anda, dengan menambahkan koleksi bernama `docs` yang menggunakan skema kumpulan `docsSchema` oleh Starlight: +Buat baru atau _update_ file konfigurasi koleksi konten Anda, menambahkan koleksi bernama `docs` yang menggunakan skema `docsSchema` dari Starlight: ```js ins={3,6} // src/content/config.ts @@ -76,29 +76,29 @@ export const collections = { }; ``` -### Menambah konten +### Menambahkan konten Starlight sekarang sudah terkonfigurasi. Sekarang adalah waktunya menambahkan konten Anda! Buatlah folder `src/content/docs/` dan tambahkan file `index.md`. -Halaman ini adalah beranda situs Anda: +Halaman ini adalah beranda dari website baru Anda: ```md --- # src/content/docs/index.md -title: Proyek tugas kuliah -description: Pelajari tentang proyek tugas kuliah saya di situs dokumentasi ini yang dibuat dengan Starlight! +title: Dokumentasi proyek saya +description: Pelajari tentang proyek saya di website dokumentasi ini yang dibuat dengan Starlight! --- -Selamat datang di proyek tugas kuliah saya! +Selamat datang di proyek saya! ``` -Starlight menggunakan _file-based routing_, yang artinya setiap file Markdown, MDX, atau Markdoc dalam folder `src/content/docs/` akan dirubah menjadi sebuah halaman di situs Anda. _Metadata frontmatter_ (kolom `title` dan `description` pada contoh di atas) dapat juga mempengaruhi tampilan halaman tersebut. -Untuk melihat semua opsi yang tersedia, rujuklah halaman [referensi _frontmatter_](/id/reference/frontmatter/). +Starlight menggunakan _file-based routing_, yang artinya setiap file Markdown, MDX, atau Markdoc dalam folder `src/content/docs/` akan dirubah menjadi sebuah halaman di website Anda. _Metadata frontmatter_ (kolom `title` dan `description` pada contoh di atas) dapat mempengaruhi tampilan halaman tersebut. +Untuk melihat semua opsi yang tersedia bisa dilihat di [referensi _frontmatter_](/id/reference/frontmatter/). -## Tips untuk situs yang sudah ada +## Tips untuk website yang sudah ada -Jika anda memiliki sebuah proyek Astro yang sudah berjalan, Anda dapat menggunakan Starlight untuk menambahkan bagian dokumentasi secara cepat. +Jika Anda memiliki sebuah proyek Astro yang sudah berjalan, Anda dapat menggunakan Starlight untuk menambahkan bagian dokumentasi secara cepat. ### Menggunakan Starlight di dalam _subpath_ @@ -121,8 +121,8 @@ import FileTree from '../../../components/file-tree.astro'; </FileTree> -Di masa depan, kami berencana mendukung skenario penggunaan semacam ini dengan lebih baik, sehingga Anda tidak perlu lagi menambahkan folder berjenjang di `src/content/docs/`. +Di masa yang akan datang, kami berencana mendukung skenario penggunaan semacam ini dengan lebih baik, sehingga Anda tidak perlu lagi menambahkan folder bertingkat di `src/content/docs/`. -### Dukungan Starlight untuk SSR +### Menggunakan Starlight dengan SSR -Saat ini, Starlight tidak mendukung _deployment_ [SSR](https://docs.astro.build/en/guides/server-side-rendering/) menggunakan adapter server Astro. Semoga kami dapat mendukung skenario ini di masa depan. +Saat ini, Starlight tidak mendukung _deployment_ [SSR](https://docs.astro.build/en/guides/server-side-rendering/) menggunakan adapter server Astro. Kami berharap untuk dapat men-_support_ fitur ini segera. diff --git a/docs/src/content/docs/id/showcase.mdx b/docs/src/content/docs/id/showcase.mdx new file mode 100644 index 00000000..e6e40cc3 --- /dev/null +++ b/docs/src/content/docs/id/showcase.mdx @@ -0,0 +1,53 @@ +--- +title: Starlight Showcase +description: Temukan website yang dibangun dengan Starlight dan community tools yang memperluas fungsionalitas Starlight! +--- + +:::tip[Tambahkan milikmu!] +Apakah kamu membuat website dengan Starlight atau _tools_ untuk Starlight? +Buka PR dan tambahkan link-nya ke halaman ini! +::: + +## Website + +import ShowcaseSites from '../../../components/showcase-sites.astro'; + +Starlight sudah digunakan dalam produksi. Berikut beberapa diantaranya: + +<ShowcaseSites /> + +Lihat semua [proyek repositori publik yang menggunakan Starlight di GitHub](https://github.com/withastro/starlight/network/dependents). + +## Community plugins + +import { CardGrid, LinkCard } from '@astrojs/starlight/components'; + +_Tools_, _plugins_, dan integrasi dari komunitas ini bekerja bersama Starlight untuk memperluas fungsionalitasnya. + +<CardGrid> + <LinkCard + href="https://www.feelback.dev/blog/new-astro-starlight-integration/" + title="FeelBack" + description="Tambahkan sistem user feedback ke halaman dokumentasi Anda." + /> + <LinkCard + href="https://github.com/HiDeoo/starlight-blog" + title="starlight-blog" + description="Tambahkan blog ke halaman dokumentasi Anda." + /> + <LinkCard + href="https://github.com/HiDeoo/starlight-links-validator" + title="starlight-links-validator" + description="Cek link yang rusak di website Starlight Anda." + /> + <LinkCard + href="https://github.com/HiDeoo/starlight-typedoc" + title="starlight-typedoc" + description="Buat halaman Starlight dari TypeScript menggunakan TypeDoc." + /> + <LinkCard + href="https://github.com/HiDeoo/starlight-openapi" + title="starlight-openapi" + description="Buat halaman dokumentasi dari spesifikasi OpenAPI/Swagger." + /> +</CardGrid> diff --git a/packages/starlight/translations/id.json b/packages/starlight/translations/id.json index efc7cd0d..ebd0cf36 100644 --- a/packages/starlight/translations/id.json +++ b/packages/starlight/translations/id.json @@ -12,7 +12,7 @@ "menuButton.accessibleLabel": "Menu", "sidebarNav.accessibleLabel": "Utama", "tableOfContents.onThisPage": "Di halaman ini", - "tableOfContents.overview": "Selayang Pandang", + "tableOfContents.overview": "Ringkasan", "i18n.untranslatedContent": "Konten ini belum tersedia dalam bahasa Anda.", "page.editLink": "Edit halaman", "page.lastUpdated": "Terakhir diperbaharui:", |