i18n(hi): update outdated pages (#1539)

Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>
withastro · Feb 22, 2024 · 7a3c5c1 · 7a3c5c1
1 parent f40be49
commit 7a3c5c1
Show file tree

Hide file tree

Showing 4 changed files with 107 additions and 40 deletions.
diff --git a/docs/src/content/docs/hi/getting-started.mdx b/docs/src/content/docs/hi/getting-started.mdx
@@ -83,43 +83,9 @@ yarn dev
 
 Starlight आपके लिए नई सामग्री जोड़ने, या अपनी मौजूदा फ़ाइलें लाने के लिए तैयार है!
 
-#### फ़ाइल स्वरूप
+`src/content/docs/` निर्देशिका में Markdown फ़ाइलें बनाकर अपनी साइट पर नए पेज जोड़ें।
 
-Starlight बिना किसी कॉन्फ़िगरेशन की आवश्यकता के Markdown और MDX में सामग्री लिखने का समर्थन करता है।
-आप प्रायोगिक [Astro Markdoc एकीकरण](https://docs.astro.build/hi/guides/integrations-guide/markdoc/) स्थापित करके Markdoc के लिए समर्थन जोड़ सकते हैं।
-
-#### पेज जोड़ें
-
-`src/content/docs/` में `.md` या `.mdx` फ़ाइलें बनाकर अपनी साइट पर नए पेज जोड़ें।
-अपनी फ़ाइलों को व्यवस्थित करने और एकाधिक पथ खंड बनाने के लिए उप-फ़ोल्डर्स का उपयोग करें।
-
-उदाहरण के लिए, निम्नलिखित फ़ाइल संरचना `example.com/hello-world` और `example.com/guides/faq` पर पेज बनाएगी:
-
-import FileTree from '~/components/file-tree.astro';
-
-<FileTree>
-
-- src/
-  - content/
-    - docs/
-      - guides/
-        - faq.md
-      - hello-world.md
-
-</FileTree>
-
-#### टाइप-सुरक्षित फ्रंटमैटर
-
-सभी Starlight पेज [फ्रंटमैटर गुणों का एक अनुकूलन योग्य सामान्य सेट](/hi/reference/frontmatter/) साझा करते हैं पेज के प्रकट होने के तरीके को नियंत्रित करने के लिए:
-
-```md
----
-title: नमस्ते, दुनिया !
-description: यह मेरी Starlight-संचालित साइट का एक पेज है
----
-```
-
-यदि आप कुछ भी महत्वपूर्ण भूल जाते हैं, तो Starlight आपको बता देगा।
+["पेज"](/hi/guides/pages/) गाइड में MDX और Markdoc फाइलों के लिए फ़ाइल-आधारित रूटिंग और समर्थन के बारे में और पढ़ें।
 
 ### अगले कदम
 

diff --git a/docs/src/content/docs/hi/guides/components.mdx b/docs/src/content/docs/hi/guides/components.mdx
@@ -169,6 +169,61 @@ import { LinkCard } from '@astrojs/starlight/components';
 	<LinkCard title="अवयवों" href="/hi/guides/components/" />
 </CardGrid>
 
+### असाइड्स
+
+असाइड्स (जिन्हें "चेतावनी" या "कॉलआउट" के रूप में भी जाना जाता है) किसी पेज की मुख्य सामग्री के साथ-साथ द्वितीयक जानकारी प्रदर्शित करने के लिए उपयोगी होते हैं।
+
+एक `<Aside>` में `note` (डिफ़ॉल्ट), `tip`, `caution` या `danger` का वैकल्पिक `type` हो सकता है। `title` विशेषता सेट करना डिफ़ॉल्ट असाइड् शीर्षक को ओवरराइड करता है।
+
+````mdx
+# src/content/docs/example.mdx
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>कस्टम शीर्षक के बिना एक डिफ़ॉल्ट असाइड्।</Aside>
+
+<Aside type="caution" title="ध्यान रहें!">
+	एक कस्टम शीर्षक के *साथ* एक चेतावनी वाला असाइड्।
+</Aside>
+
+<Aside type="tip">
+
+असाइड्स में अन्य कंटेंट भी अलग से समर्थित है।
+
+```js
+// उदाहरण के लिए, एक कोड स्निपेट।
+```
+
+</Aside>
+
+<Aside type="danger">आप अपना पासवर्ड किसी को न दें।</Aside>
+````
+
+उपरोक्त कोड पेज पर निम्नलिखित उत्पन्न करता है:
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside>कस्टम शीर्षक के बिना एक डिफ़ॉल्ट असाइड्।</Aside>
+
+<Aside type="caution" title="ध्यान रहें!">
+	एक कस्टम शीर्षक के *साथ* एक चेतावनी वाला असाइड्।
+</Aside>
+
+<Aside type="tip">
+
+असाइड्स में अन्य कंटेंट भी अलग से समर्थित है।
+
+```js
+// उदाहरण के लिए, एक कोड स्निपेट।
+```
+
+</Aside>
+
+<Aside type="danger">आप अपना पासवर्ड किसी को न दें।</Aside>
+
+Starlight `<Aside>` अवयव के विकल्प के रूप में Markdown” और MDX में असाइड् प्रस्तुत करने के लिए एक कस्टम सिंटैक्स भी प्रदान करता है।
+कस्टम सिंटैक्स के विवरण के लिए ["Markdown में कंटेंट संलेखन"](/hi/guides/authoring-content/#asides) मार्गदर्शिका देखें।
+
 ### आइकन
 
 import { Icon } from '@astrojs/starlight/components';
@@ -195,3 +250,49 @@ import { Icon } from '@astrojs/starlight/components';
 सभी उपलब्ध आइकनों की एक सूची उनके संबंधित नामों के साथ नीचे दिखाई गई है। इसके अवयव कोड की प्रतिलिपि बनाने के लिए किसी भी आइकन पर क्लिक करें।
 
 <IconsList />
+
+### कोड
+
+जब [Markdown कोड ब्लॉक](/hi/guides/authoring-content/#code-blocks) का उपयोग करना संभव नहीं हो, तब सिंटैक्स हाइलाइट किए गए कोड को रेंडर करने के लिए `<Code>` अवयव का उपयोग करें, उदाहरण के लिए, फ़ाइलों, डेटाबेस, या APIs जैसे बाहरी स्रोतों से आने वाले डेटा को रेंडर करना।
+
+`<Code>` द्वारा समर्थित प्रॉप्स की पूरी जानकारी के लिए [Expressive Code "Code अवयव" दस्तावेज़](https://expressive-code.com/key-features/code-component/) देखें।
+
+```mdx
+# src/content/docs/example.mdx
+
+import { Code } from '@astrojs/starlight/components';
+
+export const exampleCode = `console.log('यह किसी फ़ाइल या CMS से आ सकता है!');`;
+export const fileName = 'example.js';
+export const highlights = ['फ़ाइल', 'CMS'];
+
+<Code code={exampleCode} lang="js" title={fileName} mark={highlights} />
+```
+
+उपरोक्त कोड पेज पर निम्नलिखित उत्पन्न करता है:
+
+import { Code } from '@astrojs/starlight/components';
+
+export const exampleCode = `console.log('यह किसी फ़ाइल या CMS से आ सकता है!');`;
+export const fileName = 'example.js';
+export const highlights = ['फ़ाइल', 'CMS'];
+
+<Code code={exampleCode} lang="js" title={fileName} mark={highlights} />
+
+#### आयातित कोड
+
+किसी भी कोड फ़ाइल को स्ट्रिंग के रूप में आयात करने के लिए [Vite के `?raw` आयात प्रत्यय](https://vitejs.dev/guide/assets#importing-asset-as-string) का उपयोग करें।
+फिर आप इस आयातित स्ट्रिंग को अपने पृष्ठ पर शामिल करने के लिए `<Code>` अवयव में पास कर सकते हैं।
+
+```mdx title="src/content/docs/example.mdx" "?raw"
+import { Code } from '@astrojs/starlight/components';
+import importedCode from '/src/env.d.ts?raw';
+
+<Code code={importedCode} lang="ts" title="src/env.d.ts" />
+```
+
+उपरोक्त कोड पेज पर निम्नलिखित उत्पन्न करता है:
+
+import importedCode from '/src/env.d.ts?raw';
+
+<Code code={importedCode} lang="ts" title="src/env.d.ts" />
diff --git a/docs/src/content/docs/hi/guides/site-search.mdx b/docs/src/content/docs/hi/guides/site-search.mdx
@@ -1,8 +1,6 @@
 ---
 title: साइट खोज
 description: Starlight की अंतर्निहित साइट खोज सुविधाओं और उन्हें अनुकूलित करने के तरीके के बारे में जानें।
-sidebar:
-  badge: नया
 ---
 
 import { Tabs, TabItem } from '@astrojs/starlight/components';

diff --git a/docs/src/content/docs/hi/manual-setup.mdx b/docs/src/content/docs/hi/manual-setup.mdx
@@ -44,7 +44,7 @@ Starlight एकीकरण आपकी `astro.config.mjs` फ़ाइल म
 
 आरंभ करने के लिए एक `title` जोड़ें:
 
-```js {7-9}
+```js {8}
 // astro.config.mjs
 import { defineConfig } from 'astro/config';
 import starlight from '@astrojs/starlight';
@@ -125,4 +125,6 @@ import FileTree from '~/components/file-tree.astro';
 
 ### SSR के साथ Starlight का प्रयोग करें
 
-वर्तमान में, Starlight Astro के सर्वर एडेप्टर का उपयोग करके [SSR प्रविस्तारण](https://docs.astro.build/hi/guides/server-side-rendering/) का समर्थन नहीं करता है। हमें उम्मीद है कि हम जल्द ही इसका समर्थन करने में सक्षम होंगे।
+आप Astro दस्तावेज़ में [“ऑन-डिमांड रेंडरिंग एडेप्टर”](https://docs.astro.build/hi/guides/server-side-rendering/) मार्गदर्शिका का पालन करके अपने परियोजना में कस्टम ऑन-डिमांड रेंडर पेजों के साथ Starlight का उपयोग कर सकते हैं।
+
+वर्तमान में, आपके परियोजना के आउटपुट मोड की परवाह किए बिना, Starlight द्वारा उत्पन्न दस्तावेज़ीकरण पेज हमेशा पहले से प्रस्तुत किए जाते हैं। हमें उम्मीद है कि हम जल्द ही Starlight पेजों के लिए ऑन-डिमांड रेंडरिंग का समर्थन करने में सक्षम होंगे।