|
| 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/) का समर्थन नहीं करता है। हमें उम्मीद है कि हम जल्द ही इसका समर्थन करने में सक्षम होंगे। |
0 commit comments