WordPressEscape

خانه / راهنما

کارگاه

انتقال ۵۲۸٬۸۵۴ صفحه WordPress به Hugo: یادداشت‌های مهندسی

این‌ها یادداشت‌های اجرایی ما از انتقال Unlimited Charters، سایت خواهر داخلی‌مان، از WordPress به Hugo در ماه مه ۲۰۲۶ هستند. خلاصه کسب‌وکار در مطالعه موردی آمده است؛ این بخش برای کسی است که باید کار را انجام دهد: چه چیزهایی در نیم‌میلیون صفحه از کار افتاد، کدام دستورها برایمان دردسرساز شدند و اکنون چه بررسی‌هایی را روی همه سایت‌ها، کوچک یا بزرگ، اجرا می‌کنیم.

مطالعهٔ 15 دقیقه‌ای 9 بخش طراحی‌شده برای رتبه‌گیری
در این صفحه
  1. زمینه
  2. بررسی قالب‌ها پیش از محتوا
  3. ساخت‌های بخش‌بندی‌شده و تله‌های سیستم فایل
  4. اصلاحات عملکردی؛ اعمال تغییر در قالب به‌علاوه پردازش کل مجموعه
  5. تنظیمات مؤثر Cloudflare
  6. جزئیات اسکیما و سئو
  7. ثبت سرنخ فروش بخشی است که نمی‌توانید از دست بدهید
  8. کارهایی که دفعه بعد متفاوت انجام می‌دهیم
  9. منابع و مطالعه بیشتر
  10. سؤالات متداول
پاسخ سریع

در این مقیاس، مشکلات بیشتر مربوط به سیستم فایل و فرایند هستند تا خود Hugo: بخش‌بندی ساخت، نگه‌داشتن محتوای کنارگذاشته‌شده خارج از محل اتصال محتوای Hugo، هرگز اجرا نکردن هم‌زمان دو فرایند جابه‌جایی روی یک پوشه و تبدیل هر اصلاح به تغییر قالب به‌علاوه اجرای یک اسکریپت روی کل مجموعه. بزرگ‌ترین دستاوردهای عملکردی شامل تعیین ابعاد تصاویر، CSS حیاتی همگام، غیرفعال کردن بارگذاری تنبل تصویر LCP، بارگذاری تأخیری ابزار نقل‌قول با فضای رزروشده و خاموش کردن Cloudflare Email Obfuscation بودند.

01

زمینه

Unlimited Charters تحت مالکیت همان مجموعه‌ای است که WordPressEscape را اداره می‌کند؛ این انتقال آزمایشی داخلی خودمان بود و با دسترسی کامل به سرور انجام شد. سایت کمی بیش از نیم‌میلیون URL داشت؛ بیشتر آن‌ها صفحات مکان مبتنی بر قالب بودند، به‌علاوه هاب‌ها، صفحات ناوگان و وبلاگ. هدف، ساختی از Hugo بود که به‌صورت فایل‌های استاتیک پشت Cloudflare ارائه شود و تمام مسیرهای موجود حفظ شوند.

02

بررسی قالب‌ها پیش از محتوا

کار را با گروه‌بندی URLها بر اساس قالب WordPress که آن‌ها را تولید می‌کرد آغاز کردیم، نه بر اساس الگوی URL. برای هر خانواده یک تصمیم گرفتیم: آن را به‌صورت یک چیدمان Hugo بازسازی کنیم یا فعلاً یک نسخه استاتیک از خروجی WordPress ارائه دهیم. بازسازی خانواده‌های پرترافیک در اولویت و تهیه نسخه استاتیک برای موارد نامتعارف، پروژه را بدون معطل شدن به‌خاطر دنباله طولانی صفحات سفارشی پیش برد.

یک نکته مهم: در WordPress، مسیر URL همیشه همان اسلاگ post_name نیست. صفحات والد، قوانین سفارشی بازنویسی و درون‌ریزی‌های قدیمی مسیرهایی ایجاد کرده بودند که با اسلاگ مطابقت نداشتند؛ بنابراین مسیر باید از خزیدن سایت به دست می‌آمد، نه از پایگاه داده.

03

ساخت‌های بخش‌بندی‌شده و تله‌های سیستم فایل

رندر کردن همه صفحات در یک اجرا کند بود و هر تغییر کوچک را پرهزینه می‌کرد. کار را بخش‌بندی کردیم: فایل‌های منبعی را که قرار نبود بسازیم به یک پوشه موقت منتقل می‌کردیم، زیرمجموعه‌ای را می‌ساختیم، مستقر می‌کردیم و سپس فایل‌ها را برمی‌گرداندیم. چهار تله زمان ما را گرفت:

  1. پوشه موقت باید خارج از محل اتصال محتوای Hugo باشد. اگر این پوشه جایی زیر شاخه محتوای متصل‌شده قرار بگیرد، Hugo همچنان همه فایل‌ها را پیمایش می‌کند و بخش‌بندی دیگر فایده‌ای ندارد.
  2. rsync --exclude=index.html همه index.htmlها را در تمام عمق‌ها مستثنا می‌کند، نه فقط فایل سطح اول را. الگو را محدود کنید (--exclude=/index.html).
  3. دو فرایند جابه‌جایی هم‌زمان روی یک پوشه، آن را تو‌در‌تو می‌کنند. دو فرایند بازگردانی که با هم رقابت می‌کردند، حدود ۳۶۷٬۰۰۰ پوشه را یک سطح بیش از حد عمیق ایجاد کردند. محیط تولید مشکلی نداشت چون خروجی ساخته‌شده را ارائه می‌کرد؛ یک جابه‌جایی اسکریپتی همه آن‌ها را در یک مرحله مسطح کرد. مالکیت پوشه فقط به یک فرایند سپرده شد و این موضوع با قفل enforce می‌شود.
  4. mv dir/* target/ در این مقیاس شکست می‌خورد (فهرست آرگومان‌ها بیش از حد طولانی است). از find ... -exec mv -t target {} + استفاده کنید.
# رندر کردن چند صفحه بدون بازسازی همه‌چیز
flock /tmp/uc-content.lock bash -c '
  mv content/migrated/* ../stash/            # پوشه موقت خارج از محل اتصال محتوا
  for s in $(cat targets.txt); do mv ../stash/$s content/migrated/; done
  hugo --minify -d ../staged
  find ../stash -mindepth 1 -maxdepth 1 -exec mv -t content/migrated/ {} +
'
04

اصلاحات عملکردی؛ اعمال تغییر در قالب به‌علاوه پردازش کل مجموعه

هر اصلاح دو بخش داشت: قالب Hugo را درست می‌کردیم تا ساخت‌های بعدی صحیح باشند و HTML از قبل ساخته‌شده را نیز اصلاح می‌کردیم تا برای انتشار آن نیازی به بازسازی کامل نباشد. مهم‌ترین موارد این‌ها بودند:

  • ابعاد تصاویر. در یک قالب، width="1600" height="700" به‌صورت ثابت تعریف شده بود، در حالی که CSS از نسبت تصویر متفاوتی استفاده می‌کرد. این مورد در ۵۲۷٬۸۱۵ صفحه اصلاح شد. عرض و ارتفاع باید با نسبت تصویر رندرشده مطابقت داشته باشند؛ در غیر این صورت مرورگر فضای نادرستی رزرو می‌کند (بهینه‌سازی CLS).
  • قواعد متناقض aspect-ratio برای یک انتخابگر در دو شیوه‌نامه وجود داشت؛ آن‌ها را به یک قاعده تبدیل کردیم.
  • CSS حیاتی در فایل ناهمگام. قواعد موبایل موردنیاز برای اولین نمایش در یک شیوه‌نامه تأخیری قرار داشتند و باعث چیدمان مجدد دیرهنگام می‌شدند. آن‌ها را به شیوه‌نامه همگام منتقل کردیم.
  • بارگذاری تنبل تصویر اصلی. ویژگی loading="lazy" روی تصویر بالای صفحه، LCP را به تأخیر می‌انداخت؛ آن را با fetchpriority="high" جایگزین کردیم (بهینه‌سازی LCP).
  • تصاویر بیش‌ازحد بزرگ LCP با نسخه‌های کوچک‌تر جایگزین شدند و در هر صفحه بین ۵۰ تا ۴۴۰ کیلوبایت صرفه‌جویی شد.
  • ابزار نقل‌قول هنگام اولین تعامل بارگذاری می‌شود (با یک مسیر جایگزین مبتنی بر timeout) و کانتینر آن ۴۸۰ پیکسل فضا رزرو می‌کند (در موبایل ۵۶۰ پیکسل). پیش از این، قرارگیری آن صفحه را با CLS حدود ۰٫۵۴ جابه‌جا می‌کرد.
05

تنظیمات مؤثر Cloudflare

  • Email Obfuscation خاموش. رمزگشای آن پس از بارگذاری، DOM را پیمایش و پیوندهای ایمیل را بازنویسی می‌کند؛ این فرایند به‌صورت جابه‌جایی چیدمان ظاهر می‌شد. این قابلیت مداوم‌ترین منبع CLS بود که پیدا کردیم.
  • Rocket Loader خاموش. این قابلیت ترتیب اسکریپت‌ها را تغییر می‌داد و با بارگذاری تأخیری تداخل داشت.
  • پاک‌سازی پس از استقرار. کش‌های لبه HTML قدیمی را نگه می‌داشتند؛ پاک‌سازی بر اساس مسیر پس از هر استقرار، از ارائه صفحات قدیمی جلوگیری کرد (مستندات پاک‌سازی Cloudflare).
  • اندازه‌گیری در محیط تولید، نه محیط آزمایشی. محیط آزمایشی که تنظیمات یکسان Cloudflare را نداشت، امتیازهای آزمایشگاهی‌ای تولید می‌کرد که با محیط تولید مطابقت نداشتند.
06

جزئیات اسکیما و سئو

  • Search Console به‌دلیل وجود aggregateRating و review در یک موجودیت Service، خطاهای داده‌های ساختاریافته گزارش کرد. به‌جای تلاش برای معتبرسازی آن‌ها، حذفشان کردیم؛ نشانه‌گذاری باید بازتاب‌دهنده محتوایی باشد که کاربران می‌توانند ببینند (راهنمای داده‌های ساختاریافته).
  • پست‌های وبلاگ در ابتدا با قالب مکان رندر می‌شدند و نوع اسکیما‌ی نادرستی را به ارث می‌بردند. اکنون هر قالب موجودیت مخصوص خود را تعریف می‌کند.
  • برای ۳۵ مسیر ناسازگار ناوگان و خدمات، به صفحات تو‌در‌توی صحیح، تغییرمسیر دائمی ایجاد شد (تغییرمسیرها).
  • رسانه‌ها از /wp-content/uploads/ به /uploads/ منتقل شدند و با یک قانون ۳۰۱ مدیریت شدند؛ یک اجرای موازی sed طی چند دقیقه مسیرها را در ۵۲۸٬۸۵۲ فایل از مجموع ۵۲۸٬۸۵۴ فایل بازنویسی کرد.
  • پس از آن‌که Hugo نقشه سایت، اسکیما، تگ‌های متا و robots.txt را تولید کرد، Yoast حذف شد.
find static-v5 -name '*.html' -print0 \
  | xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'
07

ثبت سرنخ فروش بخشی است که نمی‌توانید از دست بدهید

فرم درخواست قیمت منبع درآمد سایت است، بنابراین بررسی‌های جداگانه‌ای برای آن تعریف شد: محل قرارگیری ابزار باید در HTML ساخته‌شده هر صفحه‌ای که این ابزار را دارد موجود باشد، نام فیلدها باید با چیزی که endpoint دریافت اطلاعات انتظار دارد مطابقت داشته باشد و استقراری که یک پوشه را جایگزین می‌کند نباید صفحه مستقل درخواست قیمت را حذف کند. اگر در زمان انتقال، ثبت سرنخ فروش بی‌سروصدا از کار بیفتد، همه شاخص‌های سئو موفق به نظر می‌رسند، در حالی که کسب‌وکار درخواست‌های مشتریان را از دست می‌دهد.

08

کارهایی که دفعه بعد متفاوت انجام می‌دهیم

  1. Email Obfuscation را پیش از اولین اندازه‌گیری CLS خاموش می‌کنیم.
  2. از همان روز اول، ساخت را بخش‌بندی می‌کنیم.
  3. از همان روز اول، پوشه محتوا را قفل می‌کنیم.
  4. الگوی «تغییر قالب به‌علاوه پردازش کل مجموعه» را پیش از اولین اصلاح مستند می‌کنیم، نه بعد از اصلاح پنجم.
  5. بررسی داده‌های واقعی کاربران (CrUX) را در فهرست بررسی راه‌اندازی قرار می‌دهیم، چون امتیازهای آزمایشگاهی محیط آزمایشی با محیط تولید یکسان نیستند.

نمای کسب‌وکاری همین پروژه، از جمله بخش‌هایی که روی WordPress باقی گذاشتیم، در مطالعه موردی آمده است.

09

منابع و مطالعه بیشتر

سؤالات متداول

آیا این انتقال برای یک مشتری انجام شده است؟

خیر. Unlimited Charters یک سایت خواهر داخلی است که همان مجموعه مالک WordPressEscape آن است. این پروژه، نمونه آزمایشی خودمان بود.

آیا Hugo از نیم‌میلیون صفحه پشتیبانی می‌کند؟

بله، اما بازسازی کامل آن‌قدر کند است که ساخت‌های بخش‌بندی‌شده و مدیریت دقیق فایل‌ها اهمیت زیادی پیدا می‌کنند. بیشتر مشکلات ما مربوط به سیستم فایل و فرایندها بود، نه باگ‌های Hugo.

چه چیزی باعث بدترین جابه‌جایی چیدمان شد؟

قرارگیری ابزار نقل‌قول بدون فضای رزروشده (حدود ۰٫۵۴ CLS در صفحات هاب) و بازنویسی صفحه توسط Cloudflare Email Obfuscation پس از بارگذاری.

آیا این درس‌ها برای سایت‌های کوچک هم کاربرد دارند؟

بله. همین بررسی‌ها (یکسانی URL، ابعاد تصاویر، CSS حیاتی، تصویر اصلی بدون بارگذاری تنبل و ابزارهای بارگذاری‌شده با تأخیر) برای یک سایت ۴۰صفحه‌ای هم کاربرد دارند؛ فقط به‌جای چند ساعت، طی چند دقیقه اجرا می‌شوند.

سایت من را رایگان اسکن کنید

ببینید آیا سایت شما هم شرایط همین بهینه‌سازی را دارد

ممیزی رایگان ۶۰ثانیه‌ای، امتیاز واقعی PageSpeed، تعداد دقیق صفحات، شکاف‌های سئو و قابلیت‌های WordPress که باید جایگزین شوند را نشان می‌دهد. سپس WordPressEscape سایت شما را روی Hugo بازسازی می‌کند، همه URLها را حفظ می‌کند و از همان روز اول کد منبع را در اختیارتان می‌گذارد - درست همان‌طور که UC بازسازی شد.

سایت من را رایگان اسکن کنید
ادامهٔ مطالعه
همه راهنماها33
جست‌وجوهای مرتبطانتقال از wordpress به hugo۵۲۸٬۸۵۴ صفحه (آزمایش داخلی)ساخت بخش‌بندی‌شده hugoرفع cls در cloudflareپاک‌سازی اسکیمایکسانی url