From 20dcb74b50e75a62a8e739967baf536b6b59309a Mon Sep 17 00:00:00 2001 From: Erkan Altınörs Date: Wed, 1 May 2024 17:15:14 +0300 Subject: i18n(tr): update `getting-started.mdx` file (#1792) Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com> --- docs/src/content/docs/tr/getting-started.mdx | 85 ++++++++++++++++------------ 1 file 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 - +Aşağıdaki komutu terminalinde çalıştırarak yeni bir Astro + Starlight projesi oluştur: + + ```sh -# npm ile yeni bir proje oluştur npm create astro@latest -- --template starlight ``` @@ -23,7 +26,6 @@ npm create astro@latest -- --template starlight ```sh -# pnpm ile yeni bir proje oluştur pnpm create astro --template starlight ``` @@ -31,7 +33,6 @@ pnpm create astro --template starlight ```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.) + + -### 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: + + +```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 + + + + +```sh +yarn dev ``` -### Tip-korumalı Ön BÖlüm + + + +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: - + ```sh -# npm ile Starlight'ı güncelle -npm install @astrojs/starlight@latest +npx @astrojs/upgrade ``` ```sh -# pnpm ile Starlight'ı güncelle -pnpm upgrade @astrojs/starlight --latest +pnpm dlx @astrojs/upgrade ``` ```sh -# yarn ile Starlight'ı güncelle -yarn upgrade @astrojs/starlight --latest +yarn dlx @astrojs/upgrade ``` -- cgit