Skip to content

Commit f2b23f7

Browse files
authored
Merge branch 'main' into authoring-content-tr
2 parents 35969e8 + 01de9be commit f2b23f7

17 files changed

Lines changed: 1929 additions & 541 deletions

File tree

.changeset/silly-tools-drop.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
'@astrojs/starlight': patch
3+
---
4+
5+
Internal refactor: simplify some CSS for the `<details>` element

docs/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@
1818
"@astrojs/starlight": "workspace:*",
1919
"@lunariajs/core": "^0.0.32",
2020
"@types/culori": "^2.0.0",
21-
"astro": "^4.3.5",
21+
"astro": "^4.8.6",
2222
"culori": "^3.2.0",
2323
"sharp": "^0.32.5"
2424
},

docs/src/content/docs/guides/authoring-content.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -361,6 +361,31 @@ A code block’s optional title can be set either with a `title="..."` attribute
361361
```
362362
````
363363

364+
## Details
365+
366+
Details (also known as “disclosures” or “accordions”) are useful to hide content that is not immediately relevant.
367+
Users can click a short summary to expand and view the full content.
368+
369+
Use the standard HTML [`<details>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details) and [`<summary>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/summary) elements in your Markdown content to create a disclosure widget.
370+
371+
You can nest any other Markdown syntax inside a `<details>` element.
372+
373+
<details>
374+
<summary>Where and when is the Andromeda constellation most visible?</summary>
375+
376+
The [Andromeda constellation](<https://en.wikipedia.org/wiki/Andromeda_(constellation)>) is most visible in the night sky during the month of November at latitudes between `+90°` and `−40°`.
377+
378+
</details>
379+
380+
```md
381+
<details>
382+
<summary>Where and when is the Andromeda constellation most visible?</summary>
383+
384+
The [Andromeda constellation](<https://en.wikipedia.org/wiki/Andromeda_(constellation)>) is most visible in the night sky during the month of November at latitudes between `+90°` and `−40°`.
385+
386+
</details>
387+
```
388+
364389
## Other common Markdown features
365390

366391
Starlight supports all other Markdown authoring syntax, such as lists and tables. See the [Markdown Cheat Sheet from The Markdown Guide](https://www.markdownguide.org/cheat-sheet/) for a quick overview of all the Markdown syntax elements.

docs/src/content/docs/tr/environmental-impact.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Doğa Dostu Dokümanlar
33
description: Starlight'ın daha çevreci dokümantasyon sitesi oluşturmanda nasıl yardımcı olacağını ve karbon ayakizini nasıl düşüreceğini öğren.
44
---
55

6-
Web endüstrisinin iklime etkisinin [%2][sf] ila [4% arasında küresel karbon emisyonu][bbc]'na sahip olduğu tahmin ediliyor; kabaca havayolları endüstrisindeki emisyon oranında.
6+
Web endüstrisinin iklime etkisinin [%2][sf] ila [%4 arasında küresel karbon emisyonu][bbc]'na sahip olduğu tahmin ediliyor; kabaca havayolları endüstrisindeki emisyon oranında.
77
Bir websitesinin ekolojik etkisini hesaplamada çok fazla karmaşık etken var, ancak bu rehber dokümantasyon sitenizin çevresel ayakizini düşürmek için birkaç ipucu içerir.
88

99
İyi haber şu ki, Starlight'ı seçmek mükemmel bir başlangıç.

docs/src/content/docs/tr/guides/components.mdx

Lines changed: 255 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ import AnotherComponent from '../../components/AnotherComponent.astro';
3030
</AnotherComponent>
3131
```
3232

33-
Starlight'ın Astro'dan aldığı güç sayesinde, MDX dosyalarınız içerisinde [desteklenen herhangi bir arayüz çerçevesi ile (React, Preact, Svelte, Vue, Solid, Lit, ve Alpine)](https://docs.astro.build/en/core-concepts/framework-components/) oluşturulmış bileşenlerinizi destekleyebilirsiniz.
33+
Starlight'ın Astro'dan aldığı güç sayesinde, MDX dosyalarınız içerisinde [desteklenen herhangi bir arayüz çerçevesi ile (React, Preact, Svelte, Vue, Solid, Lit, ve Alpine)](https://docs.astro.build/en/core-concepts/framework-components/) oluşturulmuş bileşenlerinizi destekleyebilirsiniz.
3434
Astro dokümantasyonunda [MDX içerisinde bileşen kullanmak](https://docs.astro.build/en/guides/markdown-content/#using-components-in-mdx) hakkında daha fazlasını öğrenin.
3535

3636
### Starlight stilleri ile uyumluluk
@@ -58,23 +58,75 @@ Bu bileşenler `@astrojs/starlight/components` paketinde mevcuttur.
5858
import { Tabs, TabItem } from '@astrojs/starlight/components';
5959

6060
`<Tabs>` ve `<TabItem>` bileşenlerini kullanarak sekmeli arayüz gösterebilirsiniz.
61-
You can display a tabbed interface using the `<Tabs>` and `<TabItem>` components.
6261
Her `<TabItem>` bileşenini kullanıcılara göstermek için `label` sahibi olması zorunludur.
62+
[Starlight’ın yerleşik ikonlarından](#tüm-i̇konlar) birini, etiketin yanında kalması için zorunlu olmayan `icon` niteliğini kullanın.
6363

6464
```mdx
6565
import { Tabs, TabItem } from '@astrojs/starlight/components';
6666

6767
<Tabs>
68-
<TabItem label="Yıldızlar">Sirius, Vega, Betelgeuse</TabItem>
69-
<TabItem label="Uydular">Io, Europa, Ganymede</TabItem>
68+
<TabItem label="Yıldızlar" icon="star">
69+
Sirius, Vega, Betelgeuse
70+
</TabItem>
71+
<TabItem label="Uydular" icon="moon">
72+
Io, Europa, Ganymede
73+
</TabItem>
7074
</Tabs>
7175
```
7276

7377
Yukarıdaki kod, sayfa üzerinde aşağıdaki gibi sekmeler oluşturur:
7478

7579
<Tabs>
76-
<TabItem label="Yıldızlar">Sirius, Vega, Betelgeuse</TabItem>
77-
<TabItem label="Uydular">Io, Europa, Ganymede</TabItem>
80+
<TabItem label="Yıldızlar" icon="star">
81+
Sirius, Vega, Betelgeuse
82+
</TabItem>
83+
<TabItem label="Uydular" icon="moon">
84+
Io, Europa, Ganymede
85+
</TabItem>
86+
</Tabs>
87+
88+
#### Senkronize Sekmeler
89+
90+
`syncKey` niteliği ekleyerek çoklu sekme gruplarınızı senkronize edin.
91+
92+
Sayfadaki aynı `syncKey` değerine sahip tüm `<Tabs>` bileşenleri aynı etkin etiketi görüntüler. Bu, okuyucunuza bir kez seçme (örneğin okuyucunuzun işletim sistemi ya da paket yöneticisi) ve sayfa boyunca yansıyan seçimi görmesine olanak tanır.
93+
94+
İlişkili sekmeleri senkronize etmek için, her `<Tabs>` bileşenine özdeş `syncKey` niteliği ekleyin ve hepsinin aynı `<TabItems>` etiketi kullandığına emin olun:
95+
96+
```mdx 'syncKey="constellations"'
97+
# src/content/docs/example.mdx
98+
99+
import { Tabs, TabItem } from '@astrojs/starlight/components';
100+
101+
_Bazı yıldızlar:_
102+
103+
<Tabs syncKey="constellations">
104+
<TabItem label="Orion">Bellatrix, Rigel, Betelgeuse</TabItem>
105+
<TabItem label="Gemini">Pollux, Castor A, Castor B</TabItem>
106+
</Tabs>
107+
108+
_Bazı ötegezegenler:_
109+
110+
<Tabs syncKey="constellations">
111+
<TabItem label="Orion">HD 34445 b, Gliese 179 b, Wasp-82 b</TabItem>
112+
<TabItem label="Gemini">Pollux b, HAT-P-24b, HD 50554 b</TabItem>
113+
</Tabs>
114+
```
115+
116+
Yukarıdaki kod, sayfa üzerinde aşağıdaki gibi çıktı oluşturur:
117+
118+
_Bazı yıldızlar:_
119+
120+
<Tabs syncKey="constellations">
121+
<TabItem label="Orion">Bellatrix, Rigel, Betelgeuse</TabItem>
122+
<TabItem label="Gemini">Pollux, Castor A, Castor B</TabItem>
123+
</Tabs>
124+
125+
_Bazı ötegezegenler:_
126+
127+
<Tabs syncKey="constellations">
128+
<TabItem label="Orion">HD 34445 b, Gliese 179 b, Wasp-82 b</TabItem>
129+
<TabItem label="Gemini">Pollux b, HAT-P-24b, HD 50554 b</TabItem>
78130
</Tabs>
79131

80132
### Kartlar
@@ -164,23 +216,219 @@ import { LinkCard } from '@astrojs/starlight/components';
164216
<LinkCard title="Bileşenler" href="/tr/guides/components/" />
165217
</CardGrid>
166218

219+
### Ara bölümler
220+
221+
Ara bölümler (ayrıca "uyarı" ve "açıklama balonu" olarak da bilinir), sayfanın ana içeriği ile birlikte ikincil bilgi göstermek için kullanışlıdır.
222+
223+
`<Aside>` bileşeni zorunlu olmayan `note` (varsayılan), `tip`, `caution` ya da `danger` değerini alan `type` niteliğine sahiptir. `title` niteliği eklemek varsayılan ara bölüm başlığını değiştirir.
224+
225+
````mdx
226+
# src/content/docs/example.mdx
227+
228+
import { Aside } from '@astrojs/starlight/components';
229+
230+
<Aside>Özel başlığı olmayan bir varsayılan ara bölüm</Aside>
231+
232+
<Aside type="caution" title="Dikkat Et!">
233+
Özel bir başlık *ile* uyarı ara bölümü.
234+
</Aside>
235+
236+
<Aside type="tip">
237+
238+
Diğer içerikler de ara bölümde desteklenir.
239+
240+
```js
241+
// Örneğin bir kod parçacığı.
242+
```
243+
244+
</Aside>
245+
246+
<Aside type="danger">Şifreni kimseye verme.</Aside>
247+
````
248+
249+
Yukarıdaki kod, sayfa üzerinde aşağıdaki gibi çıktı oluşturur:
250+
251+
import { Aside } from '@astrojs/starlight/components';
252+
253+
<Aside>Özel başlığı olmayan bir varsayılan ara bölüm</Aside>
254+
255+
<Aside type="caution" title="Dikkat Et!">
256+
Özel bir başlık *ile* uyarı ara bölümü.
257+
</Aside>
258+
259+
<Aside type="tip">
260+
261+
Diğer içerikler de ara bölümde desteklenir.
262+
263+
```js
264+
// Örneğin bir kod parçacığı.
265+
```
266+
267+
</Aside>
268+
269+
<Aside type="danger">Şifreni kimseye verme.</Aside>
270+
271+
Starlight, ayrıca `<Aside>` bileşenine alternatif olarak Markdown ve MDX içerisinde ara bölüm oluşturmak için özel bir sözdizimi sağlar.
272+
[“Markdown'da İçerik Yazmak”](/tr/guides/authoring-content/#ara-bölümler) rehberine özel sözdizimi detayları için bakın.
273+
274+
### Kod
275+
276+
`<Code>` bileşenini [Markdown kod bloğu](/tr/guides/authoring-content/#kod-blokları) kullanmanın mümkün olmadığı zaman sözdizim vurgulu kod oluşturmak için kullanın - örneğin dosyalar, veritabanları ve API'ler gibi harici kaynaklardan gelen verileri oluşturmak için.
277+
278+
`<Code>` bileşeninin destekleği niteliklerin tüm detaylarını [Expressive Code “Code Component” dokümanında](https://expressive-code.com/key-features/code-component/) inceleyin.
279+
280+
```mdx
281+
# src/content/docs/example.mdx
282+
283+
import { Code } from '@astrojs/starlight/components';
284+
285+
export const exampleCode = `console.log('Bu bir dosya ya da İçerik Yönetim Sisteminden gelebilir!');`;
286+
export const fileName = 'example.js';
287+
export const highlights = ['file', 'CMS'];
288+
289+
<Code code={exampleCode} lang="js" title={fileName} mark={highlights} />
290+
```
291+
292+
Yukarıdaki kod, sayfa üzerinde aşağıdaki gibi çıktı oluşturur:
293+
294+
import { Code } from '@astrojs/starlight/components';
295+
296+
export const exampleCode = `console.log('Bu bir dosya ya da İçerik Yönetim Sisteminden gelebilir!');`;
297+
export const fileName = 'example.js';
298+
export const highlights = ['file', 'CMS'];
299+
300+
<Code code={exampleCode} lang="js" title={fileName} mark={highlights} />
301+
302+
#### Alınan kod
303+
304+
[Vite’nin `?raw` son ekini](https://vitejs.dev/guide/assets#importing-asset-as-string) herhangi kod dosyasını string olarak almak için kullanın.
305+
`<Code>` bileşenine alınan bu string'i sayfanıza dahil etmek için ekleyin.
306+
307+
```mdx title="src/content/docs/example.mdx" "?raw"
308+
import { Code } from '@astrojs/starlight/components';
309+
import importedCode from '/src/env.d.ts?raw';
310+
311+
<Code code={importedCode} lang="ts" title="src/env.d.ts" />
312+
```
313+
314+
Yukarıdaki kod, sayfa üzerinde aşağıdaki gibi çıktı oluşturur:
315+
316+
import importedCode from '/src/env.d.ts?raw';
317+
318+
<Code code={importedCode} lang="ts" title="src/env.d.ts" />
319+
320+
### Dosya Ağacı
321+
322+
`<FileTree>` bileşenini dizin yapısını dosya ikonları ve toplanabilir alt dizinleri göstermek için kullanın.
323+
324+
Dosyalarınızın yapısını ve dizinleri `<FileTree>` içerisinde [numaralandırılmamış Markdown listesi](https://www.markdownguide.org/basic-syntax/#unordered-lists) ile açıkça belirtin.
325+
İç içe yerleşmiş liste kullanarak ya da belirli bir içeriksiz dizin oluşturmak için liste elemanının sonuna `/` ekleyerek alt dizin oluşturun.
326+
327+
Aşağıdaki sözdizimi dosya ağacınının görünümünü özelleştirmek için kullanılabilir:
328+
329+
- Dosya ya da dizinin ismini kalın yaparak vurgulayın. Örneğin `**README.md**`.
330+
- Dosya ya da dizine isimden sonra metin ekleyerek yorum ekleyin.
331+
- Dosyalara ya da dizinlere isim olarak `...` ya da `` yazımını kullanarak ayrılmış bilgi alanı ekleyin.
332+
333+
```mdx
334+
# src/content/docs/example.mdx
335+
336+
import { FileTree } from '@astrojs/starlight/components';
337+
338+
<FileTree>
339+
340+
- astro.config.mjs **önemli** bir dosya
341+
- package.json
342+
- README.md
343+
- src
344+
- components
345+
- **Header.astro**
346+
-
347+
- pages/
348+
349+
</FileTree>
350+
```
351+
352+
Yukarıdaki kod, sayfa üzerinde aşağıdaki gibi çıktı oluşturur:
353+
354+
import { FileTree } from '@astrojs/starlight/components';
355+
356+
<FileTree>
357+
358+
- astro.config.mjs **önemli** bir dosya
359+
- package.json
360+
- README.md
361+
- src
362+
- components
363+
- **Header.astro**
364+
-
365+
- pages/
366+
367+
</FileTree>
368+
369+
### Adımlar
370+
371+
`<Steps>` bileşenini numaralanmış görevler listesini biçimlendirmek için kullanın.
372+
Her aşamasının açıkça belirtilmeye ihtiyaç duyan çok karmaşık adım adım rehberleri oluşturmak için kullanışlıdır.
373+
374+
Standart Markdown sıralanmış listesini `<Steps>` bileşeni ile sarmalayın.
375+
`<Steps>` bileşeni içerisinde tüm olağan Markdown sözdizimi uygulanabilir.
376+
377+
````mdx title="src/content/docs/example.mdx"
378+
import { Steps } from '@astrojs/starlight/components';
379+
380+
<Steps>
381+
382+
1. Bileşeni MDX dosyasına dahil edin:
383+
384+
```js
385+
import { Steps } from '@astrojs/starlight/components';
386+
```
387+
388+
2. Sıralanmış liste elemanlarını `<Steps>` ile sarmalayın.
389+
390+
</Steps>
391+
````
392+
393+
Yukarıdaki kod, sayfa üzerinde aşağıdaki gibi çıktı oluşturur:
394+
395+
import { Steps } from '@astrojs/starlight/components';
396+
397+
<Steps>
398+
399+
1. Bileşeni MDX dosyasına dahil edin:
400+
401+
```js
402+
import { Steps } from '@astrojs/starlight/components';
403+
```
404+
405+
2. Sıralanmış liste elemanlarını `<Steps>` ile sarmalayın.
406+
407+
</Steps>
408+
167409
### İkon
168410

169411
import { Icon } from '@astrojs/starlight/components';
170412
import IconsList from '~/components/icons-list.astro';
171413

172414
Starlight, içeriğinizde görünmesi için `<Icon>` bileşenini kullanarak bir grup ortak ikonları kullanımınıza sunar.
173-
Her `<Icon>` [`name`](#tüm-i̇konlar) değerine ihtiyaç duyar ve isteğe bağlı olarak `label`, `size`, ve `color` özellikleri eklenebilir.
415+
416+
Her `<Icon>` [`name`](#tüm-i̇konlar) değerine ihtiyaç duyar ve isteğe bağlı olarak `label` eklenebilir.
417+
`size` ve `color` nitelikleri ikonun görünümünü CSS birimleri ve renk değerleri ile ayarlamak için kullanılabilir.
174418

175419
```mdx
420+
# src/content/docs/example.mdx
421+
176422
import { Icon } from '@astrojs/starlight/components';
177423

178424
<Icon name="star" color="goldenrod" size="2rem" />
425+
<Icon name="rocket" color="var(--sl-color-text-accent)" />
179426
```
180427

181428
Yukarıdaki kod, aşağıdaki gibi çıktı oluşturur:
182429

183430
<Icon name="star" color="goldenrod" size="2rem" />
431+
<Icon name="rocket" color="var(--sl-color-text-accent)" />
184432

185433
#### Tüm İkonlar
186434

0 commit comments

Comments
 (0)