Look Scanned میں، ہم بہتر دستاویزات اور زیادہ محفوظ ترقیاتی طریقوں کو فراہم کرنے کے لیے اپنی بنیادی ڈھانچے کو مسلسل بہتر بنا رہے ہیں۔ آج، ہم اپنی How-To دستاویزات کی سائٹ کے ایک اہم اپ گریڈ کے بارے میں تفصیلات شیئر کرتے ہوئے خوش ہیں: ایک حسب ضرورت Vue + Vite ایپلیکیشن سے VitePress میں منتقلی، جبکہ بیک وقت npm Trusted Publishers کے ساتھ اپنی CI/CD سیکیورٹی کو بڑھانا۔

📚 ہم نے VitePress میں کیوں منتقل کیا

ہماری How-To دستاویزات کی سائٹ (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 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 دستاویزات کثیر لسانی PDFs پیدا کرتی ہیں جو ہمیشہ مرکزی Look Scanned ایپلیکیشن میں نمونہ فائلوں کے طور پر استعمال ہوتی رہی ہیں (lookscanned.io/en/scan پر دستیاب)۔ یہ VitePress منتقلی اس فعالیت کو تبدیل نہیں کرتی—یہ صرف ہماری دستاویزات کی بنیادی ڈھانچے کو برقرار رکھنے اور بہتر بنانے کے لیے ایک بہتر بنیاد فراہم کرتی ہے۔

💡 صارفین کے لیے اس کا کیا مطلب ہے

اگر آپ Look Scanned کی دستاویزات استعمال کرتے ہیں:

  • وہی رسائی، بہتر تجربہ: دستاویزات بہتر لوڈنگ اور نیویگیشن کے ساتھ ایک ہی URL پر رہتی ہیں
  • زیادہ قابل اعتماد: جامد سائٹ کی تخلیق کا مطلب تیز لوڈ اور بہتر استحکام ہے
  • بہتر تلاش اور دریافت: VitePress کی تعمیر شدہ تلاش آپ کو تیزی سے جوابات تلاش کرنے میں مدد کرتی ہے
  • جاری PDF معاونت: کثیر لسانی PDF تخلیق پہلے کی طرح جاری ہے

🚀 آگے کیا ہے

بنیادی ڈھانچے کی تکمیل مکمل ہونے کے ساتھ، ہم مواد کی بہتری پر توجہ مرکوز کر رہے ہیں:

  • وسیع استعمال کے معاملات: مزید عملی مثالیں اور قدم بہ قدم رہنما
  • مستقل مزاجی کی بہتری: وضاحت کے لیے کثیر لسانی اصطلاحات کو بہتر بنانا
  • بہتر PDF ایکسپورٹ: کراس براؤزر PDF تخلیق کے تجربے کو بہتر بنانا

آج ہی Look Scanned آزمائیں

Look Scanned براؤزر پر مبنی، رازداری کو ترجیح دینے والے PDF سکیننگ اثرات فراہم کرتا ہے بغیر آپ کی فائلوں کو کہیں بھی اپ لوڈ کیے۔ بہتر دستاویزات شروع کرنا پہلے سے کہیں زیادہ آسان بناتی ہیں۔

👉 اپنے براؤزر میں تیز، محفوظ دستاویز سکیننگ کا تجربہ کرنے کے لیے lookscanned.io ملاحظہ کریں۔