منصوبے کے بارے میں

یہ ریپوزٹری پوری پوسٹ ہاگ ویب سائٹ کو چلاتی ہے، جسے ایک پروڈکٹ کے طور پر دیکھا جاتا ہے۔ اس میں تمام تحریری مواد (پروڈکٹ کی خصوصیات، دستورالعمل، دستاویزات، بلاگز، کیس اسٹڈیز، ٹیوٹوریلز، اور کمپنی ہینڈ بک) کے ساتھ ساتھ انٹرایکٹو خصوصیات جیسے سوال و جواب کا نظام (Squeak!)، نوکریوں کی فہرست (Ashby کے ذریعے)، قیمتوں کا کیلکولیٹر، روڈ میپ، API دستاویزات، اور مزید شامل ہیں۔ کوڈ بیس میں تمام کمپونینٹس، ٹیمپلیٹس، منطق، اور اسٹائلنگ شامل ہیں۔ ## فوری آغاز 1. **پیشگی تنصیب**: Node (ورژن 22) اور pnpm (via `corepack use pnpm@latest-10`) انسٹال کریں۔ 2. **ترقی شروع کریں**: ریپو کلون کریں، `pnpm install` کے ساتھ ڈیپنڈنسیز انسٹال کریں، اور `pnpm start` چلائیں۔ سائٹ `http://localhost:8001` پر چلتی ہے۔ Apple Silicon Macs کے لیے، اضافی مراحل میں `node_modules` ہٹانا اور Homebrew کے ذریعے `vips` انسٹال کرنا شامل ہے۔ 3. **ترمیم اور پیش نظارہ**: ڈیٹا کوئریز کے لیے `http://localhost:8001/___graphql` پر Gatsby GraphQL ٹول استعمال کریں۔ ## جدید سیٹ اپ - **ڈیبگنگ کی غلطیاں**: تازہ ترین تبدیلیاں کھینچیں، کیشے صاف کریں، اور یقینی بنائیں کہ کوئی متصادم flox ماحول نہیں ہے۔ - **API دستاویزات**: مقامی پوسٹ ہاگ انسٹینس استعمال کرنے کے لیے API اسکیما URL کو `POSTHOG_OPEN_API_SPEC_URL` سے اوور رائیڈ کریں۔ - **Ashby نوکریوں کی فہرست اور GitHub شراکت دار**: نجی ماحول متغیرات کی ضرورت ہے۔ - **پوسٹس سیکشن**: مقامی ورژن دیکھنے کے لیے براہ راست `/posts` پر جائیں۔ - **Cloudflare PR پیش نظارے**: `GATSBY_MINIMAL=true` کے ساتھ بنائے گئے؛ فہرست سازی کے صفحات تیار نہ ہوں۔ - **مرچ اسٹور**: Shopify ماحول متغیرات (`SHOPIFY_APP_PASSWORD`، `GATSBY_MYSHOPIFY_URL`، `GATSBY_SHOPIFY_STOREFRONT_TOKEN`) کی ضرورت ہے۔ - **ڈائنامک اوپن گراف امیجز**: `ASHBY_API_KEY` اور `GITHUB_API_KEY` کے ساتھ بنائیں، اور مقامی طور پر امیجز بنانے کے لیے `gatsby/onPostBuild.ts` میں ایک لائن عارضی طور پر کامنٹ آؤٹ کریں۔ ## تعاون تعاون خوش آئند ہے۔ ترجیحی ترتیب: کمیونٹی میں سوالات پوچھیں، بگ رپورٹس/فیڈبیک جمع کریں، خصوصیات پر ووٹ دیں، PRs کھولیں، یا مسائل/مواد کے آئیڈیاز کھولیں۔ تفصیلی ہدایات ہینڈ بک اور `AGENTS.md` فائل میں دستیاب ہیں۔