From 496e6ea2bb1968a78eea969dd7f3fd33d7905dd5 Mon Sep 17 00:00:00 2001 From: oggnimodd Date: Wed, 11 Oct 2023 12:26:05 +0700 Subject: [PATCH 1/9] improve translation in docs/id/index.mdx --- docs/src/content/docs/id/index.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/src/content/docs/id/index.mdx b/docs/src/content/docs/id/index.mdx index c75ef9d0dd1..a89723ff66f 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: 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'; - 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. - + Manfaatkan kekuatan penuh dan performa Astro. Kembangkan Starlight dengan - pustaka dan integrasi Astro favorit Anda. + _library_ dan integrasi Astro favorit Anda. Gunakan bahasa markup favorit Anda. Starlight menyediakan validasi From 35a4719d2ca66b2a9e4e62b48bd0e94b860bc790 Mon Sep 17 00:00:00 2001 From: oggnimodd Date: Wed, 11 Oct 2023 12:45:23 +0700 Subject: [PATCH 2/9] improve indonesian translation of 'tableOfContents.overview' --- packages/starlight/translations/id.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/starlight/translations/id.json b/packages/starlight/translations/id.json index efc7cd0d034..ebd0cf36363 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:", From 3bd4b0b5c4bdc478575c9d640b7a16e2ef315266 Mon Sep 17 00:00:00 2001 From: oggnimodd Date: Wed, 11 Oct 2023 13:15:20 +0700 Subject: [PATCH 3/9] improve translation in docs/id/getting-started.mdx --- docs/src/content/docs/id/getting-started.mdx | 34 ++++++++++---------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/src/content/docs/id/getting-started.mdx b/docs/src/content/docs/id/getting-started.mdx index 45b53ce181b..d9f70795fba 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 -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 -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! From 1be138e6c7bbd3dc49ccc8fc98add684c1f1cf77 Mon Sep 17 00:00:00 2001 From: oggnimodd Date: Wed, 11 Oct 2023 13:36:35 +0700 Subject: [PATCH 4/9] improve translation in docs/id/manual-setup.mdx --- docs/src/content/docs/id/manual-setup.mdx | 38 +++++++++++------------ 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/src/content/docs/id/manual-setup.mdx b/docs/src/content/docs/id/manual-setup.mdx index e3be119c99a..561f8222492 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: @@ -36,7 +36,7 @@ Starlight adalah sebuah [integrasi Astro](https://docs.astro.build/en/guides/int -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'; -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. From 67dbffae4cd36d5f96f230163dd6c2a21ef76d66 Mon Sep 17 00:00:00 2001 From: oggnimodd Date: Wed, 11 Oct 2023 15:46:38 +0700 Subject: [PATCH 5/9] add Indonesian translation for docs/environmental-impact.mdx --- .../content/docs/id/environmental-impact.md | 135 ++++++++++++++++++ 1 file changed, 135 insertions(+) create mode 100644 docs/src/content/docs/id/environmental-impact.md 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 00000000000..19d621a5567 --- /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 | + +Data dikumpulkan pada 14 Mei 2023. Klik link untuk melihat angka terkini. + +[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/ From 3b3bbf362594c5372a5a8f6f4d1e4e20455d8292 Mon Sep 17 00:00:00 2001 From: oggnimodd Date: Wed, 11 Oct 2023 16:15:37 +0700 Subject: [PATCH 6/9] add Indonesian translation for docs/showcase.mdx --- docs/src/content/docs/id/showcase.mdx | 53 +++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 docs/src/content/docs/id/showcase.mdx diff --git a/docs/src/content/docs/id/showcase.mdx b/docs/src/content/docs/id/showcase.mdx new file mode 100644 index 00000000000..e6e40cc39fd --- /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: + + + +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. + + + + + + + + From 84bc014255f952ab7b347f17aa0271131a517a18 Mon Sep 17 00:00:00 2001 From: oggnimodd Date: Wed, 11 Oct 2023 16:18:48 +0700 Subject: [PATCH 7/9] remove italic styling from headings to improve consistency --- docs/src/content/docs/id/environmental-impact.md | 2 +- docs/src/content/docs/id/getting-started.mdx | 6 +++--- docs/src/content/docs/id/manual-setup.mdx | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/src/content/docs/id/environmental-impact.md b/docs/src/content/docs/id/environmental-impact.md index 19d621a5567..d904e228dde 100644 --- a/docs/src/content/docs/id/environmental-impact.md +++ b/docs/src/content/docs/id/environmental-impact.md @@ -112,7 +112,7 @@ Tertarik bagaimana perbandingannya dengan _framework_ dokumentasi lainnya? Tes i ## Sumber Tambahan -### _Tools_ +### Tools - [Website Carbon Calculator][wcc] - [GreenFrame](https://greenframe.io/) diff --git a/docs/src/content/docs/id/getting-started.mdx b/docs/src/content/docs/id/getting-started.mdx index d9f70795fba..7ab432d7e3d 100644 --- a/docs/src/content/docs/id/getting-started.mdx +++ b/docs/src/content/docs/id/getting-started.mdx @@ -62,7 +62,7 @@ src/content/docs/hello-world.md => your-site.com/hello-world src/content/docs/guides/faq.md => your-site.com/guides/faq ``` -### _Frontmatter_ yang _type-safe_ +### Frontmatter yang type-safe Semua halaman Starlight berbagi [properti _frontmatter_ umum](/id/reference/frontmatter/) yang dapat dikostumisasi untuk mengontrol tampilan setiap halaman: @@ -75,7 +75,7 @@ description: This is a page in my Starlight-powered site Jika ada properti yang terlewat, Starlight akan memberitahu Anda. -## _Deploy_ website Starlight Anda +## Deploy website Starlight 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. @@ -118,7 +118,7 @@ yarn upgrade @astrojs/starlight --latest 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). -## _Troubleshooting_ Starlight +## 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. diff --git a/docs/src/content/docs/id/manual-setup.mdx b/docs/src/content/docs/id/manual-setup.mdx index 561f8222492..5168ba3426f 100644 --- a/docs/src/content/docs/id/manual-setup.mdx +++ b/docs/src/content/docs/id/manual-setup.mdx @@ -12,7 +12,7 @@ Jika Anda ingin menambahkan Starlight ke proyek Astro yang sudah ada, berikut in Untuk mengikuti panduan ini, Anda membutuhkan proyek Astro yang sudah berjalan. -### Menambahkan _Starlight integration_ +### Menambahkan Starlight integration 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: From d3680134c1f28b035d5bbcfcce04b071e54b04b1 Mon Sep 17 00:00:00 2001 From: oggnimodd Date: Wed, 11 Oct 2023 16:52:04 +0700 Subject: [PATCH 8/9] improve translation for Brought to you by Astro section in index.mdx --- docs/src/content/docs/id/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/src/content/docs/id/index.mdx b/docs/src/content/docs/id/index.mdx index a89723ff66f..1c2443f6d7f 100644 --- a/docs/src/content/docs/id/index.mdx +++ b/docs/src/content/docs/id/index.mdx @@ -49,9 +49,9 @@ import AboutAstro from '../../../components/about-astro.astro'; -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/) From ca0f64ea34f6d5ddbae817b0d6df0b4d91abe5ab Mon Sep 17 00:00:00 2001 From: Chris Swithinbank Date: Fri, 13 Oct 2023 16:06:06 +0200 Subject: [PATCH 9/9] Add changeset --- .changeset/quick-chefs-sin.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 .changeset/quick-chefs-sin.md diff --git a/.changeset/quick-chefs-sin.md b/.changeset/quick-chefs-sin.md new file mode 100644 index 00000000000..7c79acab2f6 --- /dev/null +++ b/.changeset/quick-chefs-sin.md @@ -0,0 +1,5 @@ +--- +"@astrojs/starlight": patch +--- + +Improve Indonesian language support