مقامی پیش نظارے سے Cloudflare Pages تک: AI Pose Gallery کے چینی ورژن کی تعیناتی

پروجیکٹ کا تعارف

AI Pose Gallery کا چینی ورژن AI ڈرائنگ، 3D تخلیق اور فوٹوگرافی کے حوالہ جات کے لیے جامد انسانی جسمانی پوزز کی ایک گیلری ہے۔ پروجیکٹ میں 288 گروپس اور 1439 تصاویر پر مشتمل کثیر زاویہ حوالہ جاتی تصاویر شامل ہیں، اور اصل سائٹ کے جاپانی میٹا ڈیٹا کا مکمل چینی ترجمہ کیا گیا ہے۔

ریپوزٹری میں 1439 JPG تھمب نیلز اور 1439 PNG اصل تصاویر، یعنی کل 2878 تصویری فائلیں محفوظ ہیں۔ فرنٹ اینڈ صفر انحصاری سنگل پیج ایپ ہے، جسے استعمال کرنے کے لیے کسی فریم ورک یا بلڈ ٹول کی تنصیب ضروری نہیں۔

آپ حقیقی نتیجہ دیکھنے کے لیے آن لائن ڈیمو ملاحظہ کر سکتے ہیں، یا مکمل پروجیکٹ حاصل کرنے کے لیے GitHub ریپوزٹری سے رجوع کر سکتے ہیں۔

گیلری میں بالغوں کے لیے پوز حوالہ جات شامل ہیں، اور بعض زمروں کے نام جنسی حرکات کی اصطلاحات پر مشتمل ہیں۔ مواد صرف فنکارانہ تخلیق، حرکات کے حوالہ اور فرنٹ اینڈ ٹیکنالوجی سیکھنے کے لیے ہے۔ نابالغ افراد اس تک رسائی حاصل نہ کریں۔

اہم خصوصیات

تلاش اور مشترکہ فلٹرز

گیلری کا مواد چار نظاموں کے تحت منظم ہے، اور صفحہ ہر نظام میں تصاویر کی تعداد اور پوز گروپس کی تعداد دکھاتا ہے۔ تلاش کا خانہ پوز کے نام، نمبر، ID اور زمرے کے کلیدی الفاظ کو سپورٹ کرتا ہے۔ / دبانے سے تلاش کے خانے پر فوری توجہ مرکوز کی جا سکتی ہے۔

• چار پوز نظام کے ٹیبز
• 26 حرکتی زمرے
• سامنے، ترچھے پہلو، پہلو، اوپر سے اور نیچے سے پانچ زاویے
• نظام، زمرے اور زاویے کے مشترکہ فلٹرز
• تمام فلٹرز کو ایک کلک سے دوبارہ ترتیب دینا

گروپ اور انفرادی براؤزنگ

صفحہ پوز کے لحاظ سے گروپ اور ایک ایک تصویر براؤز کرنے کے دو طریقے فراہم کرتا ہے۔ گروپ کارڈ ایک ہی پوز کے متعدد زاویوں کے تھمب نیلز دکھاتے ہیں۔ تھمب نیل پر کرسر لے جانے یا کلک کرنے سے کارڈ کی مرکزی تصویر تبدیل ہو جاتی ہے۔

لائٹ باکس کھولنے کے بعد صفحہ پہلے 300×400 تھمب نیل دکھاتا ہے، پھر 900×1200 PNG اصل تصویر لوڈ کرتا ہے۔ لائٹ باکس PNG ڈاؤن لوڈ کرنے، ریکارڈ ID نقل کرنے اور تصویر کو نئی ونڈو میں کھولنے کی سہولت فراہم کرتا ہے۔

• ← اور →: موجودہ پوز کا زاویہ تبدیل کریں
• ↑ اور ↓: پوز تبدیل کریں
• Esc: لائٹ باکس بند کریں
• موبائل پر دائیں یا بائیں سوائپ: تصویر تبدیل کریں

رسپانسیو لے آؤٹ

ڈیسک ٹاپ پر متعدد کالمز کا گرڈ استعمال ہوتا ہے، جبکہ موبائل پر دو کالمز کا گرڈ استعمال ہوتا ہے۔ چھوٹی اسکرین پر براؤزنگ کو آسان بنانے کے لیے موبائل آلات پر فلٹر پینل کو کھولا یا بند کیا جا سکتا ہے۔

ڈیٹا کا حجم اور ساخت

1439 ریکارڈز چار نظاموں میں تقسیم ہیں:

• پورا جسم، ایک فرد・معیاری نظام: 365 ریکارڈز
• پورا جسم، ایک فرد・حسی نظام: 399 ریکارڈز
• اوپری جسم، ایک فرد: 400 ریکارڈز
• دو افراد کا باہمی قربت والا نظام: 275 ریکارڈز

فرنٹ اینڈ اصل میں data/pose-zh.json پڑھتا ہے۔ ہر ریکارڈ میں منفرد ID، نظام، پوز نمبر، زمرہ، پوز کا نام، زاویہ، تھمب نیل کا راستہ، اصل تصویر کا راستہ اور تلاش کی تار شامل ہے۔

{
  "id": "full_sexy_P001_front",
  "体系": "全身单人・性感系",
  "姿势编号": "P001",
  "分类": "站姿",
  "姿势名称": "S形站姿・胯部侧顶",
  "角度": "正面",
  "缩略图": "thumbs/…jpg",
  "原图": "img/…png",
  "检索": "用于前端模糊搜索的拼接串"
}

data/pose.json اصل جاپانی فیلڈز اور ڈیٹا محفوظ رکھتا ہے، تاکہ ترجمے کی جانچ یا ڈیٹا دوبارہ شامل کیا جا سکے۔ data/translations.csv میں جاپانی اور چینی کے موازنے کے 323 ریکارڈز موجود ہیں۔

پروجیکٹ حاصل کرنا

Git اور Python 3 تیار رکھیں، پھر ریپوزٹری کلون کر کے پروجیکٹ ڈائریکٹری میں جائیں:

git clone https://github.com/anhao/ai-pose-gallery-zh.git
cd ai-pose-gallery-zh

پروجیکٹ میں npm یا Python انحصارات کی تنصیب کا کوئی مرحلہ نہیں۔ مرکزی صفحہ index.html میں موجود ہے، جبکہ ڈیٹا اور تصاویر ریپوزٹری کی متعلقہ ڈائریکٹریز میں پہلے سے محفوظ ہیں۔

اہم ڈائریکٹریز

• index.html: صفر انحصاری سنگل پیج گیلری
• data/: جاپانی ڈیٹا، چینی ڈیٹا، زمرے اور ترجمے کی موازنتی جدول
• thumbs/: 1439 عدد 300×400 JPG تھمب نیلز
• img/: 1439 عدد 900×1200 PNG اصل تصاویر
• scripts/: ڈاؤن لوڈ، ترجمہ شامل کرنے، جانچ اور اشاعت کے اسکرپٹس
• _headers: Cloudflare Pages کیش پالیسی
• robots.txt اور sitemap.xml: سرچ انجن کی ترتیب

گیلری کو مقامی طور پر چلانا

صفحہ JSON ڈیٹا لوڈ کرنے کے لیے fetch استعمال کرتا ہے، اس لیے index.html پر براہ راست ڈبل کلک نہیں کیا جا سکتا۔ مقامی فائل پروٹوکول کے ذریعے براہ راست استعمال کرنے پر براؤزر سیکیورٹی پالیسی کے باعث درخواست روک دے گا۔

ریپوزٹری کی جڑ میں Python HTTP سرور شروع کریں:

python3 -m http.server 8000

اس کے بعد یہ پتہ کھولیں:

http://127.0.0.1:8000

صفحہ لوڈ ہونے کے بعد بنیادی کارروائیوں سے واقف ہونے کے لیے درج ذیل ترتیب اختیار کی جا سکتی ہے:

1. اوپری ٹیبز سے ایک پوز نظام منتخب کریں۔
2. حرکتی زمرہ اور ایک یا زیادہ زاویے منتخب کریں۔
3. تلاش کے خانے میں پوز کا نام، نمبر، ID یا زمرے کا کلیدی لفظ درج کریں۔
4. گروپ موڈ اور انفرادی موڈ کے درمیان تبدیل کریں۔
5. کارڈ پر کلک کر کے لائٹ باکس کھولیں، پھر کی بورڈ یا ٹچ اشاروں سے نیویگیٹ کریں۔
6. لائٹ باکس میں PNG اصل تصویر ڈاؤن لوڈ کریں یا ریکارڈ ID نقل کریں۔

تصاویر اور ترجمے کے ڈیٹا کی دیکھ بھال

تصاویر دوبارہ ڈاؤن لوڈ کرنا

ریپوزٹری متوازی ڈاؤن لوڈ اسکرپٹ فراہم کرتی ہے۔ پہلے سے موجود فائلیں خودکار طور پر چھوڑ دی جاتی ہیں، اس لیے کمانڈ دوبارہ چلائی جا سکتی ہے اور یہ وقفہ وار ڈاؤن لوڈ اور خودکار دوبارہ کوشش کو سپورٹ کرتی ہے۔

python3 scripts/download.py

پہلے سے طے شدہ متوازی کاموں کی تعداد 48 ہے۔ اسے تبدیل کرنے کے لیے WORKERS سیٹ کریں:

WORKERS=64 python3 scripts/download.py

چینی ترجمہ اپ ڈیٹ کرنا

ترجمے کی لغت scripts/i18n.py میں موجود ہے۔ اس میں ترجمہ تبدیل کرنے کے بعد چینی ڈیٹا دوبارہ بنانے کے لیے فِل اِن اسکرپٹ چلائیں:

python3 scripts/apply_translation.py

تیار کردہ نتیجہ فرنٹ اینڈ کے ذریعے پڑھا جائے گا۔ اپ ڈیٹ کے بعد data/pose-zh.json میں نظام، زمرہ، پوز کا نام، زاویہ اور تلاش کے فیلڈز کی متوقع مطابقت جانچنے کی سفارش کی جاتی ہے۔

تصاویر کی سالمیت جانچنا

جانچ اسکرپٹ 2878 فائلوں کے وجود، فائل کے حجم اور تصویری ہیڈر کو چیک کرتا ہے:

python3 scripts/verify.py

مواد دوبارہ ڈاؤن لوڈ کرنے، ڈائریکٹری منتقل کرنے یا باضابطہ تعیناتی سے پہلے ایک بار جانچ چلانے سے آن لائن غائب یا خراب تصاویر کے خطرے کو کم کیا جا سکتا ہے۔

Cloudflare Pages پر تعیناتی

یہ پروجیکٹ خالصتاً جامد سائٹ ہے۔ GitHub سے منسلک کر کے Cloudflare Pages کو خودکار اشاعت کی ذمہ داری دینا تجویز کیا جاتا ہے۔

1. Cloudflare Dashboard میں لاگ اِن کریں۔
2. Workers & Pages میں جائیں، پھر بالترتیب Create، Pages اور Connect to Git منتخب کریں۔
3. پروجیکٹ ریپوزٹری منتخب کریں اور پروڈکشن برانچ کو main مقرر کریں۔
4. Framework preset کو None مقرر کریں۔
5. Build command کو bash scripts/build.sh مقرر کریں۔
6. Build output directory کو dist مقرر کریں۔
7. محفوظ کر کے تعینات کریں۔ عموماً 2 سے 5 منٹ بعد https://<project>.pages.dev پتہ حاصل ہو جاتا ہے۔

اس کے بعد پروڈکشن برانچ پر ہر git push کے نتیجے میں Cloudflare Pages خودکار طور پر دوبارہ بلڈ اور اشاعت کرے گا۔

Build output directory کو براہ راست ریپوزٹری کی جڑ پر مقرر نہ کریں۔ جڑ میں موجود .git میں سینکڑوں MB ڈیٹا ہو سکتا ہے، اور Cloudflare کے ذریعے اس کی pack فائلوں کی اسکیننگ 25 MiB فی فائل کی حد کو متحرک کر سکتی ہے۔ scripts/build.sh صرف سائٹ کے لیے درکار فائلیں dist میں نقل کرتا ہے۔

ریپوزٹری کی سب سے بڑی واحد فائل تقریباً 917 KB ہے، جبکہ اشاعتی ڈائریکٹری میں تقریباً 2883 فائلیں ہیں۔ یہ Cloudflare Pages کی فی فائل 25 MiB اور فی تعیناتی 20000 فائلوں سے کم کی حدود کے مطابق ہے۔

کمانڈ لائن سے تعیناتی

اگر GitHub سے منسلک نہ کرنا ہو تو پہلے اشاعتی ڈائریکٹری بنائیں، پھر Wrangler کے ذریعے اپ لوڈ کریں:

bash scripts/build.sh
npx wrangler pages deploy dist --project-name ai-pose-gallery-zh

_headers میں img/ اور thumbs/ کے لیے ایک سال کی مضبوط کیش ترتیب دی گئی ہے، جس سے براؤزر غیر تبدیل شدہ تصاویر کے لیے بار بار درخواستیں نہیں کرے گا۔

اعلیٰ درجے کی ترتیب کی تجاویز

باضابطہ ڈومین تبدیل کرنا

ریپوزٹری میں موجود مطلق پتے پہلے سے https://ai-pose-gallery.anhao.app/ کی طرف اشارہ کرتے ہیں۔ اگر Fork کر کے اپنی ڈومین پر تعینات کریں تو درج ذیل مقامات بھی تبدیل کریں:

• index.html میں canonical پتہ
• Open Graph کے og:* پتے
• Twitter Card کی twitter:* ترتیب
• JSON-LD ساختی ڈیٹا میں سائٹ کا پتہ
• robots.txt میں sitemap کا پتہ
• sitemap.xml میں ہوم پیج کا پتہ

ان پتوں کو یکساں طور پر اپ ڈیٹ کرنے سے سرچ انجن کسٹم ڈومین اور pages.dev ڈومین کو نقل شدہ صفحات سمجھنے سے بچ سکتے ہیں۔

SEO معنوی ساخت برقرار رکھنا

صفحے میں الگ description، keywords، author، Open Graph، Twitter Card، نیز WebSite اور ImageGallery JSON-LD ڈیٹا پہلے سے ترتیب دیا گیا ہے۔ فرنٹ اینڈ میں ترمیم کرتے وقت ایک ہی مرکزی عنوان، واضح حصوں کے عنوانات، اور پوز کے نام اور زاویے پر مشتمل تصاویر کے متبادل متن کو برقرار رکھنا چاہیے۔

تھمب نیلز lazy loading استعمال کرتے ہیں، اور لائٹ باکس پہلے چھوٹی تصویر دکھا کر پھر اصل تصویر کی درخواست کرتا ہے۔ صفحے کی خصوصیات بڑھاتے وقت اس لوڈنگ ترتیب کو برقرار رکھنے کی سفارش کی جاتی ہے، تاکہ 900×1200 PNG تصاویر بیک وقت لوڈ ہو کر پہلے اسکرین کی رفتار متاثر نہ کریں۔

ڈیٹا میں ترمیم کرتے وقت فیلڈز کی مطابقت برقرار رکھنا

تلاش، فلٹر، گروپ اور زاویہ تبدیل کرنے کی تمام خصوصیات pose-zh.json کے فیلڈز پر منحصر ہیں۔ ریکارڈز میں دستی ترمیم کرتے وقت id کی انفرادیت، تصاویر کے نسبتی راستے، نظام کا نام، زمرہ، پوز نمبر اور زاویے کے نام پر خصوصی توجہ دیں، اور ترمیم کے بعد جانچ اسکرپٹ چلائیں۔

حقوقِ اشاعت اور استعمال کی حدود

تصاویر اور اصل ڈیٹا کے حقوقِ اشاعت اصل مصنف ギア کے پاس ہیں۔ ریپوزٹری کے نگہداشت کنندگان ان مواد پر کوئی حق نہیں جتاتے، اور یہ پروجیکٹ اصل کام کے تجارتی استعمال کی اجازت نہیں دیتا۔

scripts/ اور index.html کا کوڈ MIT لائسنس کے تحت ہے، لیکن یہ لائسنس img/، thumbs/ اور data/ میں موجود تصاویر اور اصل ڈیٹا پر لاگو نہیں ہوتا۔ مواد کو دوبارہ شائع یا استعمال کرنے سے پہلے تصدیق کریں کہ استعمال متعلقہ حقوقِ اشاعت کے تقاضوں کے مطابق ہے۔

خلاصہ

AI Pose Gallery کا چینی ورژن مکمل چینی ترجمہ شدہ ڈیٹا، مقامی تصویری وسائل اور ریسپانسیو فرنٹ اینڈ کو ایک ہی زیرو ڈیپینڈنسی جامد پروجیکٹ میں یکجا کرتا ہے۔ Python HTTP سرور کے ذریعے مقامی طور پر پیش نظارہ کیا جا سکتا ہے، جبکہ بلٹ اِن اسکرپٹس سے وسائل دوبارہ ڈاؤن لوڈ، ترجمہ اپ ڈیٹ اور مواد کی جانچ کی جا سکتی ہے، پھر Cloudflare Pages کے ذریعے تیزی سے شائع کیا جا سکتا ہے۔ اپنا ورژن تعینات کرتے وقت ڈومین سے متعلق SEO کنفیگریشن کو ایڈجسٹ کرنا یاد رکھیں، اور پروجیکٹ کی مواد سے متعلق ہدایات اور کاپی رائٹ کی حدود کی پابندی کریں۔