diff options
author | Erkan Altınörs | 2024-05-01 17:15:14 +0300 |
---|---|---|
committer | GitHub | 2024-05-01 16:15:14 +0200 |
commit | 20dcb74b50e75a62a8e739967baf536b6b59309a (patch) | |
tree | 106908c1006aec9ea4cfb67ba9ffc4570fe87a61 | |
parent | 59746b0c7304733b91bf6af8232421e0b97e6dac (diff) | |
download | IT.starlight-20dcb74b50e75a62a8e739967baf536b6b59309a.tar.gz IT.starlight-20dcb74b50e75a62a8e739967baf536b6b59309a.tar.bz2 IT.starlight-20dcb74b50e75a62a8e739967baf536b6b59309a.zip |
i18n(tr): update `getting-started.mdx` file (#1792)
Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com>
-rw-r--r-- | docs/src/content/docs/tr/getting-started.mdx | 85 |
1 files changed, 48 insertions, 37 deletions
diff --git a/docs/src/content/docs/tr/getting-started.mdx b/docs/src/content/docs/tr/getting-started.mdx index f456c431..30bc8920 100644 --- a/docs/src/content/docs/tr/getting-started.mdx +++ b/docs/src/content/docs/tr/getting-started.mdx @@ -1,21 +1,24 @@ --- title: Başlarken -description: Sıradaki dokümantasyon site Astro'nun Starlight'ı ile nasıl oluşturacağını öğren. +description: Sıradaki dokümantasyon siteni Astro'nun Starlight'ı ile nasıl oluşturacağını öğren. --- import { Tabs, TabItem } from '@astrojs/starlight/components'; -## Yeni Proje Oluşturma +Starlight, [Astro](https://astro.build) çerçevesi üstüne kurulmuş çok özellikli bir dokümantasyon temasıdır. +Bu rehber, yeni projeye başlamanda yardımcı olacak. +Mevcut Astro projesine Starlight eklemek için [elle kurulum talimatlarını](/tr/manual-setup/) incele. -Starlight, Astro çerçevesi üstüne kurulmuş çok özellikli bir dokümantasyon temasıdır. +## Hızlı Başlangıç -Aşağıdaki komutları kullanarak yeni bir Astro + Starlight projesi oluşturabilirsin: +### Yeni Proje Oluşturma -<Tabs> +Aşağıdaki komutu terminalinde çalıştırarak yeni bir Astro + Starlight projesi oluştur: + +<Tabs syncKey="pkg"> <TabItem label="npm"> ```sh -# npm ile yeni bir proje oluştur npm create astro@latest -- --template starlight ``` @@ -23,7 +26,6 @@ npm create astro@latest -- --template starlight <TabItem label="pnpm"> ```sh -# pnpm ile yeni bir proje oluştur pnpm create astro --template starlight ``` @@ -31,7 +33,6 @@ pnpm create astro --template starlight <TabItem label="Yarn"> ```sh -# yarn ile yeni bir proje oluştur yarn create astro --template starlight ``` @@ -45,72 +46,82 @@ Starlight'ı tarayıcında dene: [StackBlitz'deki taslağı aç](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics). ::: -## Starlight ile İçerik Oluşturmak +### Geliştirme sunucusunu başlat -Starlight, yeni bir içerik eklemen ya da var olan dosyalarını getirmen için hazır! +[Astro’nun geliştirme sunucusu](https://docs.astro.build/en/reference/cli-reference/#astro-dev) lokalinizde çalışırken, çalışmanızı önizlemeye ve otomatik olarak tarayıcınızın değişiklik yaptığınızda yenilenmesine olanak tanır. -### Dosya Formatları +Geliştirme sunucusunu başlatmak için aşağıdaki komutu proje dizininizde çalıştırın: -Starlight, içerik yazmada Markdown ve MDX formatlarını destekler. (Deneysel [Astro Markdoc entegrasyonu](https://docs.astro.build/en/guides/integrations-guide/markdoc/)'nu yükleyerek Markdoc formatı için destek ekleyebilirsin.) +<Tabs syncKey="pkg"> +<TabItem label="npm"> -### Sayfa Ekle +```sh +npm run dev +``` -`src/content/docs/` dizini altında `.md` or `.mdx` uzantılı dosya ekleyerek otomatik olarak sitene yeni sayfalar ekle. Dosyalarını organize etmek ve çoklu dizim bölümleri oluşturmak için yeni alt klasörler ekle: +</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 ``` -### Tip-korumalı Ön BÖlüm +</TabItem> +</Tabs> + +Bu, terminalinizde lokal önizleme bağlantılı bir mesaj gösterecektir. +Sitenizi tarayıcıda görüntülemek için bu bağlantıyı açın. -Tüm Starlight sayfaları özelleştirilebilir [ortak ön-bölüm mülkleri seti](/tr/reference/frontmatter/)'ni, sayfaların nasıl görüntüleneceğini kontrol etmek için paylaşır: +### İçerik Ekle -```md ---- -title: Merhaba, Dünya! -description: Bu, Starlight'la hazırlanmış sitemdeki bir sayfadır. ---- -``` +Starlight, yeni bir içerik eklemen ya da var olan dosyalarını getirmen için hazır! -Herhangi önemli bir şeyi unutursan, Starlight sana hatırlatacaktır. +`src/content/docs/` dizini içerisinde yeni Markdown dosyaları oluşturarak yeni sayfalar ekleyin. -## Starlight Web Siteni Yayına Al +Dosya bazlı gezinim ve MDX ile Markdoc dosya desteği hakkında daha fazlası için [“Sayfalar”](/tr/guides/pages/) rehberini okuyun. -Starlight websiteni oluşturduktan ve özelleştirdikten sonra; bir web sunucusunda ya da Netlify, Vercel, GitHub Pages ve daha fazla barındırma platformundan herhangi birinde yayına alabilirsin. +### Sonraki Adımlar -[Astro dokümantasyonunda, bir Astro sitenin nasıl yayına alındığını öğren.](https://docs.astro.build/en/guides/deploy/) +- **Yapılandır:** [“Starlight'ı özelleştirmek”](/tr/guides/customization/) rehberinde ortak ayarlar hakkında öğren. +- **Gezinme:** [“Kenar Çubuğu Gezinimi”](/tr/guides/sidebar/) rehberi ile kenar çubuğunu ayarla. +- **Bileşenler:** [“Bileşenler”](/tr/guides/components/) rehberinde hazır yapılmış kartlar, tablar ve daha fazlasını keşfet. +- **Yayına al:** Astro dokümantayonu içerisindeki [“Siteni yayına al”](https://docs.astro.build/en/guides/deploy/) rehberi ile çalışmanı yayınla. ## Starlight'ı Güncelleme :::tip -Starlight, beta sürümünde olduğundan dolayı sıklıkla güncelleme ve geliştirmeler yapılacak. Starlight'ı güncel tuttuğuna emin ol! +Starlight, beta sürümünde olduğundan dolayı sıklıkla güncelleme ve geliştirmeler yapılacak. +Starlight'ı güncel tuttuğuna emin ol! ::: -Starlight bir Astro entegrasyonudur ve herhangi bir `@astrojs/*` entegrasyonu gibi güncellenir: +Starlight bir Astro entegrasyonudur. Bunu ve diğer Astro paketlerini, terminalinde aşağıdaki komutu çalıştırarak güncelleyebilirsin: -<Tabs> +<Tabs syncKey="pkg"> <TabItem label="npm"> ```sh -# npm ile Starlight'ı güncelle -npm install @astrojs/starlight@latest +npx @astrojs/upgrade ``` </TabItem> <TabItem label="pnpm"> ```sh -# pnpm ile Starlight'ı güncelle -pnpm upgrade @astrojs/starlight --latest +pnpm dlx @astrojs/upgrade ``` </TabItem> <TabItem label="Yarn"> ```sh -# yarn ile Starlight'ı güncelle -yarn upgrade @astrojs/starlight --latest +yarn dlx @astrojs/upgrade ``` </TabItem> |