Skip to content

Commit 3fa2363

Browse files
authored
Merge branch 'main' into hd-docs-ec-links
2 parents 947f28c + cb19d07 commit 3fa2363

File tree

3 files changed

+134
-1
lines changed

3 files changed

+134
-1
lines changed

.changeset/calm-bananas-nail.md

+5
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
"@astrojs/starlight": patch
3+
---
4+
5+
Fix minor punctuation typo in Hindi UI string
+128
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
---
2+
title: मैनुअल सेटअप
3+
description: मौजूदा Astro परियोजना में Starlight जोड़ने के लिए मैन्युअल रूप से कॉन्फ़िगर करने का तरीका जानें।
4+
---
5+
6+
import { Tabs, TabItem } from '@astrojs/starlight/components';
7+
8+
नई Starlight साइट बनाने का सबसे तेज़ तरीका `create astro` का उपयोग है जैसा कि [पहले कदम मार्गदर्शक](/hi/getting-started/#एक-नयी-परियोजना-बनाएं) में दिखाया गया है।
9+
यदि आप किसी मौजूदा Astro परियोजना में Starlight जोड़ना चाहते हैं, तो यह मार्गदर्शिका बताएगी कि कैसे किया जाता हैं ।
10+
11+
## Starlight स्थापित करें
12+
13+
इस मार्गदर्शिका का पालन करने के लिए, आपको एक मौजूदा Astro परियोजना की आवश्यकता होगी।
14+
15+
### Starlight एकीकरण जोड़ें
16+
17+
Starlight एक [Astro एकीकरण](https://docs.astro.build/hi/guides/integrations-guide/) है। अपने परियोजना की मूल निर्देशिका में `astro add` आदेश चलाकर इसे अपनी साइट में जोड़ें:
18+
19+
<Tabs>
20+
<TabItem label="npm">
21+
```sh
22+
npx astro add starlight
23+
```
24+
25+
</TabItem>
26+
<TabItem label="pnpm">
27+
```sh
28+
pnpm astro add starlight
29+
```
30+
</TabItem>
31+
<TabItem label="Yarn">
32+
```sh
33+
yarn astro add starlight
34+
```
35+
</TabItem>
36+
37+
</Tabs>
38+
39+
यह आवश्यक निर्भरताएँ इंस्टॉल करेगा और आपकी Astro कॉन्फ़िगरेशन फ़ाइल में `एकीकरण` सरणी में Starlight जोड़ देगा।
40+
41+
### एकीकरण कॉन्फ़िगर करें
42+
43+
Starlight एकीकरण आपकी `astro.config.mjs` फ़ाइल में कॉन्फ़िगर किया गया है।
44+
45+
आरंभ करने के लिए एक `title` जोड़ें:
46+
47+
```js {7-9}
48+
// astro.config.mjs
49+
import { defineConfig } from 'astro/config';
50+
import starlight from '@astrojs/starlight';
51+
52+
export default defineConfig({
53+
integrations: [
54+
starlight({
55+
title: 'मेरी आनंददायक दस्तावेज़ीकरण साइट',
56+
}),
57+
],
58+
});
59+
```
60+
61+
[Starlight कॉन्फ़िगरेशन संदर्भ](/hi/reference/configuration/) में सभी उपलब्ध विकल्प ढूंढें।
62+
63+
### सामग्री संग्रह कॉन्फ़िगर करें
64+
65+
Starlight Astro के [सामग्री संग्रह](https://docs.astro.build/hi/guides/content-collections/) के शीर्ष पर बनाया गया है, जो `src/content/config.ts` फ़ाइल में कॉन्फ़िगर किया गया है।
66+
67+
Starlight के `docsSchema` का उपयोग करने वाले `docs` संग्रह को जोड़कर सामग्री कॉन्फ़िगरेशन फ़ाइल बनाएं या उसका अद्यतन करें:
68+
69+
```js ins={3,6}
70+
// src/content/config.ts
71+
import { defineCollection } from 'astro:content';
72+
import { docsSchema } from '@astrojs/starlight/schema';
73+
74+
export const collections = {
75+
docs: defineCollection({ schema: docsSchema() }),
76+
};
77+
```
78+
79+
### कंटेंट जोड़ें
80+
81+
Starlight अब कॉन्फ़िगर हो गया है और अब कुछ सामग्री जोड़ने का समय आ गया है!
82+
83+
एक `src/content/docs/` निर्देशिका बनाएं और इसमें एक `index.md` फ़ाइल जोड़कर प्रारंभ करें।
84+
यह आपकी नई साइट का मुखपृष्ठ होगा:
85+
86+
```md
87+
---
88+
# src/content/docs/index.md
89+
title: मेरे दस्तावेज़
90+
description: Starlight के साथ निर्मित इस दस्तावेज़ साइट में मेरे परियोजना के बारे में और जानें।
91+
---
92+
93+
मेरे परियोजना में आपका स्वागत है!
94+
```
95+
96+
Starlight फ़ाइल-आधारित रूटिंग का उपयोग करता है, जिसका अर्थ है कि `src/content/docs/` में प्रत्येक Markdown, MDX, या Markdoc फ़ाइल आपकी साइट पर एक पेज में बदल जाएगी। फ्रंटमैटर मेटाडेटा (उपरोक्त उदाहरण में `title` और `description` फ़ील्ड) प्रत्येक पृष्ठ को प्रदर्शित करने के तरीके को बदल सकता है।
97+
[फ्रंटमैटर संदर्भ](/hi/reference/frontmatter/) में सभी उपलब्ध विकल्प देखें।
98+
99+
## मौजूदा साइटों के लिए युक्तियाँ
100+
101+
यदि आपके पास कोई मौजूदा Astro परियोजना है, तो आप अपनी साइट पर शीघ्रता से दस्तावेज़ीकरण अनुभाग जोड़ने के लिए Starlight का उपयोग कर सकते हैं।
102+
103+
### उपपथ पर Starlight
104+
105+
सभी Starlight पृष्ठों को एक उपपथ पर जोड़ने के लिए, अपने सभी दस्तावेज़ सामग्री को `src/content/docs/` की उपनिर्देशिका के अंदर रखें।
106+
107+
उदाहरण के लिए, यदि Starlight पेज सभी `/guides/` से शुरू होने चाहिए, तो अपनी सामग्री को `src/content/docs/guides/` निर्देशिका में जोड़ें:
108+
109+
import FileTree from '../../../components/file-tree.astro';
110+
111+
<FileTree>
112+
113+
- src/
114+
- content/
115+
- docs/
116+
- **guides/**
117+
- guide.md
118+
- index.md
119+
- pages/
120+
- astro.config.mjs
121+
122+
</FileTree>
123+
124+
भविष्य में, हम `src/content/docs/` में अतिरिक्त नेस्टेड निर्देशिका की आवश्यकता से बचने के लिए इस उपयोग के मामले का बेहतर समर्थन करने की योजना बना रहे हैं।
125+
126+
### SSR के साथ Starlight का प्रयोग करें
127+
128+
वर्तमान में, Starlight Astro के सर्वर एडेप्टर का उपयोग करके [SSR प्रविस्तारण](https://docs.astro.build/hi/guides/server-side-rendering/) का समर्थन नहीं करता है। हमें उम्मीद है कि हम जल्द ही इसका समर्थन करने में सक्षम होंगे।

packages/starlight/translations/hi.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
"sidebarNav.accessibleLabel": "मुख्य",
1414
"tableOfContents.onThisPage": "इस पृष्ठ पर",
1515
"tableOfContents.overview": "अवलोकन",
16-
"i18n.untranslatedContent": "यह कंटेंट अभी तक आपकी भाषा में उपलब्ध नहीं है.",
16+
"i18n.untranslatedContent": "यह कंटेंट अभी तक आपकी भाषा में उपलब्ध नहीं है",
1717
"page.editLink": "पृष्ठ संपादित करें",
1818
"page.lastUpdated": "आखिरी अद्यतन:",
1919
"page.previousLink": "पिछला",

0 commit comments

Comments
 (0)