---
title: "बेहतर सुरक्षा के साथ Look Scanned How-To दस्तावेज़ीकरण को VitePress में माइग्रेट करना"
description: "जानें कि Look Scanned ने Vue + Vite से VitePress में माइग्रेट करके अपने दस्तावेज़ीकरण इन्फ्रास्ट्रक्चर को कैसे अपग्रेड किया, जबकि सुरक्षित, टोकन-मुक्त पैकेज रिलीज़ के लिए OIDC के साथ npm Trusted Publishers को लागू किया।"
date: 2025-12-19T07:55:33.000Z
lang: hi
source: https://lookscanned.io/hi/blog/migrating-look-scanned-how-to-to-vitepress
tags: ["vitepress", "दस्तावेज़ीकरण", "सुरक्षा", "cicd", "npm"]
---

# बेहतर सुरक्षा के साथ Look Scanned How-To दस्तावेज़ीकरण को VitePress में माइग्रेट करना

[Look Scanned](https://lookscanned.io) में, हम बेहतर दस्तावेज़ीकरण और अधिक सुरक्षित विकास प्रथाओं को प्रदान करने के लिए अपने इन्फ्रास्ट्रक्चर को लगातार सुधार रहे हैं। आज, हम अपनी How-To दस्तावेज़ीकरण साइट के एक महत्वपूर्ण अपग्रेड के बारे में विवरण साझा करने के लिए उत्साहित हैं: कस्टम Vue + Vite एप्लिकेशन से VitePress में माइग्रेट करना, जबकि साथ ही npm Trusted Publishers के साथ हमारी CI/CD सुरक्षा को बढ़ाना।

## 📚 हमने VitePress में क्यों माइग्रेट किया

हमारी How-To दस्तावेज़ीकरण साइट ([github.com/lookscanned/how-to](https://github.com/lookscanned/how-to)) Look Scanned के लिए व्यापक उपयोग गाइड के रूप में कार्य करती है। जबकि हमारा पिछला Vue + Vite सेटअप अच्छी तरह से काम करता था, हमने पहचाना कि VitePress सामग्री-संचालित दस्तावेज़ीकरण साइट के लिए एक बेहतर विकल्प होगा।

### VitePress क्या है?

VitePress एक स्थिर साइट जनरेटर है जो विशेष रूप से दस्तावेज़ीकरण के लिए डिज़ाइन किया गया है। Vite और Vue 3 के ऊपर निर्मित, यह दोनों दुनियाओं के सर्वश्रेष्ठ को जोड़ता है: बॉक्स से बाहर शक्तिशाली दस्तावेज़ीकरण सुविधाओं के साथ बिजली-तेज़ विकास अनुभव।

### माइग्रेशन के प्रमुख लाभ

**🎯 दस्तावेज़ीकरण के लिए बेहतर आर्किटेक्चर**
- **फ़ाइल-आधारित राउटिंग**: प्रत्येक markdown फ़ाइल स्वचालित रूप से एक पेज बन जाती है, सामग्री संगठन को सहज बनाती है
- **बिल्ट-इन दस्तावेज़ीकरण सुविधाएं**: विषय-सूची, खोज, अंतर्राष्ट्रीयकरण, और अधिक पूर्व-कॉन्फ़िगर किए गए हैं
- **स्थिर साइट जनरेशन**: पूर्व-रेंडर किया गया HTML उत्कृष्ट SEO और त्वरित पेज लोड प्रदान करता है

**⚡ बेहतर डेवलपर अनुभव**
- **तत्काल हॉट रीलोड**: विकास के दौरान परिवर्तन तुरंत दिखाई देते हैं
- **Markdown-प्रथम**: सामग्री पर ध्यान केंद्रित करें, घटक स्कैफोल्डिंग पर नहीं
- **Vue घटक समर्थन**: जब आवश्यक हो, हम अभी भी markdown के भीतर कस्टम Vue घटकों का उपयोग कर सकते हैं

**🔧 आसान रखरखाव**
- **स्पष्ट संरचना**: दस्तावेज़ीकरण सम्मेलनों का पालन करता है, योगदानकर्ताओं के लिए संज्ञानात्मक भार को कम करता है
- **अधिक स्थिर बिल्ड**: VitePress की राय वाली संरचना अधिक पुनरुत्पादक बिल्ड की ओर ले जाती है
- **बेहतर सहयोग**: टीम के सदस्य गहरे Vue ज्ञान के बिना दस्तावेज़ीकरण में योगदान कर सकते हैं

## 🔒 npm Trusted Publishers के साथ बढ़ी हुई सुरक्षा

VitePress माइग्रेशन के साथ, हमने एक महत्वपूर्ण सुरक्षा सुधार लागू किया: **OIDC प्रमाणीकरण का उपयोग करते हुए npm Trusted Publishers**।

### पारंपरिक npm टोकन के साथ समस्या

पहले, npm पर पैकेज प्रकाशित करने के लिए रिपॉजिटरी सीक्रेट्स में लंबे समय तक चलने वाले `NPM_TOKEN` को संग्रहीत करने की आवश्यकता होती थी। इस दृष्टिकोण में कई कमियां हैं:

- **सुरक्षा जोखिम**: टोकन गलती से उजागर या समझौता किए जा सकते हैं
- **प्रबंधन ओवरहेड**: टोकन को मैन्युअल रोटेशन और अपडेट की आवश्यकता होती है
- **ऑडिट चुनौतियां**: यह ट्रैक करना मुश्किल है कि किसने क्या और कब प्रकाशित किया

### समाधान: OIDC-आधारित विश्वसनीय प्रकाशन

[npm Trusted Publishers](https://docs.npmjs.com/trusted-publishers/) GitHub Actions से सीधे सुरक्षित, टोकन-मुक्त प्रकाशन को सक्षम करने के लिए OpenID Connect (OIDC) का लाभ उठाता है। यह कैसे काम करता है:

1. **कोई संग्रहीत सीक्रेट नहीं**: टोकन सहेजने के बजाय, GitHub Actions npm से अल्पकालिक क्रेडेंशियल का अनुरोध करता है
2. **पहचान सत्यापन**: npm सत्यापित करता है कि प्रकाशन अनुरोध अधिकृत GitHub रिपॉजिटरी से आया
3. **स्वचालित क्रेडेंशियल प्रबंधन**: क्रेडेंशियल स्वचालित रूप से जारी किए जाते हैं और जल्दी समाप्त हो जाते हैं

### वास्तविक दुनिया के लाभ

यह परिवर्तन हमारे विकास वर्कफ़्लो में तत्काल सुधार लाता है:

- ✅ **अब टोकन प्रबंधन नहीं**: npm टोकन बनाने, संग्रहीत करने या घुमाने की कोई आवश्यकता नहीं
- ✅ **कम हमला सतह**: अल्पकालिक क्रेडेंशियल एक्सपोजर जोखिम को कम करते हैं
- ✅ **बेहतर ऑडिट क्षमता**: प्रत्येक प्रकाशन क्रिया एक विशिष्ट GitHub Actions रन से जुड़ी होती है
- ✅ **आधुनिक सर्वोत्तम प्रथाएं**: शून्य-विश्वास सुरक्षा सिद्धांतों के साथ संरेखित

**तकनीकी नोट**: npm Trusted Publishers का समर्थन करने के लिए, हमने अपनी CI कॉन्फ़िगरेशन को Node.js `lts/*` का उपयोग करने के लिए अपडेट किया, यह सुनिश्चित करते हुए कि हमारे पास OIDC प्रमाणीकरण के लिए आवश्यक नवीनतम npm संस्करण है।

## 📦 रिलीज़ टाइमलाइन

19 दिसंबर 2025 को तीन रिलीज़ के माध्यम से माइग्रेशन पूरा हुआ:

- **v2.0.0**: Vue + Vite से VitePress में कोर माइग्रेशन (ब्रेकिंग चेंज)
- **v2.0.1**: उचित Node.js संस्करण के साथ npm Trusted Publishers का समर्थन करने के लिए CI फिक्स
- **v2.0.2**: `@fontsource/noto-mono` को devDependencies में ले जाकर प्रदर्शन सुधार

## 🌍 निरंतर बहुभाषी समर्थन

एक महत्वपूर्ण नोट: हमारा How-To दस्तावेज़ीकरण बहुभाषी PDF उत्पन्न करता है जो हमेशा मुख्य Look Scanned एप्लिकेशन में उदाहरण फ़ाइलों के रूप में उपयोग किए गए हैं ([lookscanned.io/en/scan](https://lookscanned.io/en/scan) पर उपलब्ध)। यह VitePress माइग्रेशन उस कार्यक्षमता को नहीं बदलता है—यह केवल हमारे दस्तावेज़ीकरण इन्फ्रास्ट्रक्चर को बनाए रखने और सुधारने के लिए एक बेहतर नींव प्रदान करता है।

## 💡 उपयोगकर्ताओं के लिए इसका क्या अर्थ है

यदि आप Look Scanned के दस्तावेज़ीकरण का उपयोग करते हैं:

- **समान पहुंच, बेहतर अनुभव**: दस्तावेज़ीकरण बेहतर लोडिंग और नेविगेशन के साथ समान URL पर बना रहता है
- **अधिक विश्वसनीय**: स्थिर साइट जनरेशन का अर्थ है तेज़ लोड और बेहतर स्थिरता
- **बेहतर खोज और खोज**: VitePress की बिल्ट-इन खोज आपको तेज़ी से उत्तर खोजने में मदद करती है
- **निरंतर PDF समर्थन**: बहुभाषी PDF जनरेशन पहले की तरह जारी रहता है

## 🚀 आगे क्या है

इन्फ्रास्ट्रक्चर अपग्रेड पूर्ण होने के साथ, हम सामग्री सुधारों पर ध्यान केंद्रित कर रहे हैं:

- **विस्तारित उपयोग मामले**: अधिक व्यावहारिक उदाहरण और चरण-दर-चरण गाइड
- **निरंतरता सुधार**: स्पष्टता के लिए बहुभाषी शब्दावली को परिष्कृत करना
- **बेहतर PDF निर्यात**: क्रॉस-ब्राउज़र PDF जनरेशन अनुभव में सुधार

## आज ही Look Scanned आज़माएं

Look Scanned ब्राउज़र-आधारित, गोपनीयता-प्रथम PDF स्कैनिंग प्रभाव प्रदान करता है बिना आपकी फ़ाइलों को कहीं भी अपलोड किए। बेहतर दस्तावेज़ीकरण शुरू करना पहले से कहीं अधिक आसान बनाता है।

👉 **अपने ब्राउज़र में तेज़, सुरक्षित दस्तावेज़ स्कैनिंग का अनुभव करने के लिए [lookscanned.io](https://lookscanned.io) पर जाएं।**