Merge branch 'main' into atv/i18n/hi/i18n

withastro · May 22, 2024 · d60e8e3 · d60e8e3
2 parents bb520a6 + 32becb3
commit d60e8e3
Show file tree

Hide file tree

Showing 10 changed files with 62 additions and 10 deletions.
diff --git a/docs/src/content/docs/hi/getting-started.mdx b/docs/src/content/docs/hi/getting-started.mdx
@@ -15,7 +15,7 @@ Starlight [Astro](https://astro.build) फ्रेमवर्क के शी
 
 अपने टर्मिनल में निम्नलिखित आदेश चलाकर एक नयी Astro + Starlight परियोजना बनाएं:
 
-<Tabs>
+<Tabs syncKey="pkg">
 <TabItem label="npm">
 
 ```sh
@@ -52,7 +52,7 @@ yarn create astro --template starlight
 
 अपनी परियोजना निर्देशिका के अंदर, विकास सर्वर शुरू करने के लिए निम्नलिखित आदेश चलाएँ:
 
-<Tabs>
+<Tabs syncKey="pkg">
 <TabItem label="npm">
 
 ```sh
@@ -102,7 +102,7 @@ Starlight आपके लिए नई सामग्री जोड़ने
 
 Starlight एक Astro एकीकरण है। आप अपने टर्मिनल में निम्नलिखित आदेश चलाकर इसे और अन्य Astro पैकेज का अद्यतन कर सकते हैं:
 
-<Tabs>
+<Tabs syncKey="pkg">
 <TabItem label="npm">
 
 ```sh

diff --git a/docs/src/content/docs/hi/guides/components.mdx b/docs/src/content/docs/hi/guides/components.mdx
@@ -374,19 +374,21 @@ import IconsList from '~/components/icons-list.astro';
 
 Starlight सामान्य आइकन का एक संग्रह प्रदान करता है जिसे आप `<Icon>` अवयव का उपयोग करके अपने कंटेंट में प्रदर्शित कर सकते हैं।
 
-प्रत्येक `<Icon>` को एक [`name`](#सभी-आइकन) की आवश्यकता होती है और इसमें वैकल्पिक रूप से एक `label`, `size`, और `color` विशेषता शामिल हो सकती है।
+प्रत्येक `<Icon>` को एक [`name`](#सभी-आइकन) की आवश्यकता होती है और स्क्रीन रीडर के लिए संदर्भ प्रदान करने के लिए वैकल्पिक रूप से एक `label` शामिल किया जा सकता है। CSS इकाइयों और रंग मूल्यों का उपयोग करके आइकन की उपस्थिति को अनुकूलित करने के लिए `size` और `color` विशेषताओं का उपयोग किया जा सकता है।
 
 ```mdx
 # src/content/docs/example.mdx
 
 import { Icon } from '@astrojs/starlight/components';
 
 <Icon name="star" color="goldenrod" size="2rem" />
+<Icon name="rocket" color="var(--sl-color-text-accent)" />
 ```
 
 उपरोक्त कोड पेज पर निम्नलिखित उत्पन्न करता है:
 
 <Icon name="star" color="goldenrod" size="2rem" />
+<Icon name="rocket" color="var(--sl-color-text-accent)" />
 
 #### सभी आइकन
 

diff --git a/docs/src/content/docs/hi/guides/css-and-tailwind.mdx b/docs/src/content/docs/hi/guides/css-and-tailwind.mdx
@@ -63,7 +63,7 @@ Starlight प्लगइन निम्नलिखित कॉन्फ़
 
 `create astro` का उपयोग करके पहले से कॉन्फ़िगर किए गए Tailwind CSS के साथ एक नयी Starlight परियोजना शुरू करें:
 
-<Tabs>
+<Tabs syncKey="pkg">
 <TabItem label="npm">
 
 ```sh
@@ -95,7 +95,7 @@ yarn create astro --template starlight/tailwind
 
 1.  Astro का Tailwind एकीकरण जोड़ें:
 
-    <Tabs>
+    <Tabs syncKey="pkg">
 
     <TabItem label="npm">
 
@@ -125,7 +125,7 @@ yarn create astro --template starlight/tailwind
 
 2.  Starlight Tailwind प्लगइन इंस्टॉल करें:
 
-    <Tabs>
+    <Tabs syncKey="pkg">
 
     <TabItem label="npm">
 

diff --git a/docs/src/content/docs/hi/guides/customization.mdx b/docs/src/content/docs/hi/guides/customization.mdx
@@ -130,7 +130,7 @@ Starlight प्रत्येक पेज पर एक विषय सू
 
 डिफ़ॉल्ट रूप से, `<h2>` और `<h3>` शीर्षक विषय सूची में शामिल होते हैं। अपने [वैश्विक `tableOfContents`](/hi/reference/configuration/#tableofcontents) में `minHeadingLevel` और `maxHeadingLevel` विकल्पों का उपयोग करके साइट-व्यापी शामिल करने के लिए कौन से शीर्षक स्तर बदलें। संबंधित [frontmatter `tableOfContents`](/hi/reference/frontmatter/#tableofcontents) गुणों को जोड़कर एक व्यक्तिगत पेज पर इन डिफ़ॉल्ट को ओवरराइड करें:
 
-<Tabs>
+<Tabs syncKey="config-type">
   <TabItem label="Frontmatter">
 
 ```md {4-6}
@@ -164,7 +164,7 @@ defineConfig({
 
 `tableOfContents` विकल्प को `false` पर सेट करके विषय सूची को पूरी तरह से अक्षम करें:
 
-<Tabs>
+<Tabs syncKey="config-type">
   <TabItem label="Frontmatter">
 
 ```md {4}

diff --git a/docs/src/content/docs/ko/resources/community-content.mdx b/docs/src/content/docs/ko/resources/community-content.mdx
@@ -79,6 +79,11 @@ Starlight 사용자들이 관리하는 커뮤니티 제작 콘텐츠를 살펴
 		title="View Transitions 활성화"
 		description="Bag of Tricks의 view transitions 지원으로 SPA와 같은 모양과 느낌을 얻으세요"
 	/>
+	<LinkCard
+		href="https://jamcomments.com/posts/structured-data-with-starlight"
+		title="Starlight 페이지에 구조화된 데이터 추가"
+		description="문서 페이지에 대한 동적 JSON-LD 구조화된 데이터를 구축하는 방법을 알아보세요."
+	/>
 </CardGrid>
 
 ## 영상 콘텐츠

diff --git a/docs/src/content/docs/ru/guides/authoring-content.md b/docs/src/content/docs/ru/guides/authoring-content.md
@@ -361,6 +361,31 @@ Expressive Code предоставляет несколько вариантов
   ```
   ````
 
+## Спойлеры
+
+Спойлеры (также известные как «раскрытия» или «аккордеоны») полезны для того, чтобы скрыть содержимое, которое не имеет непосредственного отношения к делу.
+Пользователи могут нажать на краткое содержание, чтобы развернуть его и просмотреть полный текст.
+
+Используйте стандартные элементы HTML [`<details>`](https://developer.mozilla.org/ru/docs/Web/HTML/Element/details) и [`<summary>`](https://developer.mozilla.org/ru/docs/Web/HTML/Element/summary) в вашем Markdown-контенте, чтобы создать виджет раскрытия информации.
+
+Внутри элемента `<details>` можно использовать любой другой синтаксис Markdown.
+
+<details>
+<summary>Где и когда созвездие Андромеды видно лучше всего?</summary>
+
+[Созвездие Андромеды](<https://ru.wikipedia.org/wiki/%D0%90%D0%BD%D0%B4%D1%80%D0%BE%D0%BC%D0%B5%D0%B4%D0%B0_(%D1%81%D0%BE%D0%B7%D0%B2%D0%B5%D0%B7%D0%B4%D0%B8%D0%B5)>) наиболее заметно на ночном небе в ноябре на широтах от `+90°` до `-40°`.
+
+</details>
+
+```md
+<details>
+<summary>Где и когда созвездие Андромеды видно лучше всего?</summary>
+
+[Созвездие Андромеды](<https://ru.wikipedia.org/wiki/%D0%90%D0%BD%D0%B4%D1%80%D0%BE%D0%BC%D0%B5%D0%B4%D0%B0_(%D1%81%D0%BE%D0%B7%D0%B2%D0%B5%D0%B7%D0%B4%D0%B8%D0%B5)>) наиболее заметно на ночном небе в ноябре на широтах от `+90°` до `-40°`.
+
+</details>
+```
+
 ## Другие возможности Markdown
 
 Starlight поддерживает все синтаксические возможности Markdown, такие как списки и таблицы. Посмотрите [шпаргалку по Markdown от The Markdown Guide](https://www.markdownguide.org/cheat-sheet/) для изучения всех возможностей синтаксиса Markdown.

diff --git a/docs/src/content/docs/ru/guides/components.mdx b/docs/src/content/docs/ru/guides/components.mdx
@@ -425,19 +425,22 @@ import IconsList from '~/components/icons-list.astro';
 
 Starlight предоставляет набор общих иконок, которые вы можете отображать в своем контенте, используя компонент `<Icon>`.
 
-Каждый `<Icon>` требует атрибут [`name`](#все-иконки) и по желанию может включать атрибуты `label`, `size` и `color`.
+Каждый `<Icon>` требует атрибут [`name`](#все-иконки) и по желанию может включать атрибут `label`, для предоставления контекста программам чтения с экрана.
+Атрибуты `size` и `color` могут быть использованы для оформления иконки с помощью CSS.
 
 ```mdx
 # src/content/docs/example.mdx
 
 import { Icon } from '@astrojs/starlight/components';
 
 <Icon name="star" color="goldenrod" size="2rem" />
+<Icon name="rocket" color="var(--sl-color-text-accent)" />
 ```
 
 Вышеуказанный код сформирует следующий HTML:
 
 <Icon name="star" color="goldenrod" size="2rem" />
+<Icon name="rocket" color="var(--sl-color-text-accent)" />
 
 #### Все иконки
 

diff --git a/docs/src/content/docs/ru/reference/overrides.md b/docs/src/content/docs/ru/reference/overrides.md
@@ -56,6 +56,13 @@ Starlight будет передавать следующие параметры
 
 Название сайта для локали этой страницы.
 
+#### `siteTitleHref`
+
+**тип:** `string`
+
+Значение для атрибута `href` заголовка сайта, ссылающегося на главную страницу — например, `/`.
+Для многоязычных сайтов это будет включать текущую локаль — например, `/ru/` или `/zh-cn/`.
+
 #### `slug`
 
 **тип:** `string`

diff --git a/docs/src/content/docs/ru/resources/community-content.mdx b/docs/src/content/docs/ru/resources/community-content.mdx
@@ -79,6 +79,11 @@ import { CardGrid, LinkCard } from '@astrojs/starlight/components';
 		title="Включение View Transitions"
 		description="Добейтесь SPA-подобного вида и ощущения с помощью поддержки переходов представлений"
 	/>
+	<LinkCard
+		href="https://jamcomments.com/posts/structured-data-with-starlight"
+		title="Добавление структурированных данных на страницы Starlight"
+		description="Узнайте, как создавать динамические структурированные данные JSON-LD для страниц документации"
+	/>
 </CardGrid>
 
 ## Видеоконтент

diff --git a/docs/src/content/docs/ru/resources/plugins.mdx b/docs/src/content/docs/ru/resources/plugins.mdx
@@ -63,6 +63,11 @@ sidebar:
 		title="starlight-image-zoom"
 		description="Добавление возможности масштабирования к изображениям вашей документации."
 	/>
+	<LinkCard
+		href="https://github.com/lorenzolewis/starlight-multi-sidebar"
+		title="starlight-multi-sidebar"
+		description="Добавление нескольких боковых панелей на вашем сайте Starlight."
+	/>
 </CardGrid>
 
 ## Инструменты и интеграции от сообщества