WordPressEscape

होम / गाइड

वर्कबेंच

528,854 WordPress पेजों को Hugo पर माइग्रेट करना: इंजीनियरिंग नोट्स

ये मई 2026 में हमारी इन-हाउस सिस्टर साइट Unlimited Charters को WordPress से Hugo पर ले जाने के दौरान तैयार किए गए कार्य-नोट्स हैं। कारोबारी सारांश केस स्टडी में है; यहाँ उन लोगों के लिए व्यावहारिक विवरण हैं जिन्हें यह काम करना हो: पाँच लाख पेजों पर क्या-क्या टूटा, किन कमांडों ने परेशान किया और अब हम हर साइट पर - चाहे वह बड़ी हो या छोटी - कौन-सी जाँचें चलाते हैं।

पढ़ने में 12 मिनट 9 सेक्शन रैंकिंग के लिए तैयार
इस पेज पर
  1. संदर्भ
  2. कंटेंट से पहले टेम्पलेट इन्वेंटरी
  3. पार्टिशन किए गए बिल्ड और फ़ाइल-सिस्टम की पेचीदगियाँ
  4. प्रदर्शन सुधार: template बदलाव और corpus pass के रूप में लागू
  5. काम आने वाली Cloudflare सेटिंग्स
  6. Schema और SEO से जुड़ी बातें
  7. Lead capture वह हिस्सा है जिसे खोना नहीं चाहिए
  8. हम क्या अलग करते
  9. स्रोत और आगे पढ़ें
  10. अक्सर पूछे जाने वाले सवाल
त्वरित उत्तर

इस स्तर पर समस्याएँ Hugo से ज़्यादा फ़ाइल-सिस्टम और प्रक्रिया से जुड़ी होती हैं: बिल्ड को पार्टिशन करना, अस्थायी रूप से रखी गई सामग्री को Hugo के content mount से बाहर रखना, एक ही डायरेक्टरी पर कभी भी दो mover प्रक्रियाएँ न चलाना और हर सुधार को template बदलाव के साथ पूरे corpus पर चलने वाली scripted pass के रूप में लागू करना। प्रदर्शन में सबसे बड़े सुधार इमेज के dimensions ठीक करने, critical CSS को synchronous बनाने, LCP इमेज को lazy न रखने, quote widget को reserved space के साथ defer करने और Cloudflare Email Obfuscation बंद करने से मिले।

01

संदर्भ

Unlimited Charters का स्वामित्व उसी समूह के पास है जिसके पास WordPressEscape है; यह हमारा अपना परीक्षण माइग्रेशन था, जिसे पूर्ण सर्वर एक्सेस के साथ किया गया। साइट पर पाँच लाख से कुछ अधिक URLs थे - ज़्यादातर टेम्पलेट से बने लोकेशन पेज, साथ में हब, फ़्लीट पेज और एक ब्लॉग। लक्ष्य था Hugo से तैयार static files को Cloudflare के पीछे सर्व करना और मौजूदा हर path को बरकरार रखना।

02

कंटेंट से पहले टेम्पलेट इन्वेंटरी

हमने URLs को URL pattern के आधार पर नहीं, बल्कि उन्हें render करने वाले WordPress template के आधार पर समूहित किया। हर family के लिए एक निर्णय लिया गया: इसे Hugo layout के रूप में दोबारा बनाना है या फिलहाल WordPress output का static snapshot सर्व करना है। ज़्यादा ट्रैफ़िक वाली families को पहले दोबारा बनाना और असामान्य पेजों के snapshots रखना इस तरह किया गया कि custom pages की लंबी tail परियोजना को रोक न सके।

एक उपयोगी सावधानी: WordPress में URL path हमेशा post_name slug नहीं होता। Parent pages, custom rewrite rules और पुराने imports के कारण ऐसे paths बने जो slug से मेल नहीं खाते थे। इसलिए path database से नहीं, crawl से लेना पड़ा।

03

पार्टिशन किए गए बिल्ड और फ़ाइल-सिस्टम की पेचीदगियाँ

सभी पेजों को एक ही run में render करना धीमा था और हर छोटे बदलाव को महँगा बना देता था। हमने बिल्ड को पार्टिशन किया: जिन source files को उस समय build नहीं करना था, उन्हें stash में ले जाना, एक subset build करना, उसे deploy करना और फिर files वापस रखना। चार गलतियों ने हमारा समय लिया:

  1. Stash Hugo के content mount से बाहर होना चाहिए। अगर वह mounted content directory के अंदर कहीं भी हो, तो Hugo फिर भी हर फ़ाइल को scan करता है और partition करने का कोई लाभ नहीं मिलता।
  2. rsync --exclude=index.html हर depth पर मौजूद index.html को exclude करता है, सिर्फ़ सबसे ऊपर वाली फ़ाइल को नहीं। Pattern को anchor करें (--exclude=/index.html)।
  3. एक ही directory पर चलने वाली दो concurrent movers उसे nested बना देती हैं। एक-दूसरे से race कर रहीं दो restore प्रक्रियाओं ने लगभग 367,000 directories को एक स्तर ज़्यादा गहरा बना दिया। Production ठीक था क्योंकि वहाँ built output सर्व हो रहा था; एक scripted move ने उन्हें एक ही स्तर पर ला दिया। Directory का स्वामित्व एक ही process के पास हो और इसे lock के ज़रिए लागू करें।
  4. mv dir/* target/ इस आकार पर विफल हो जाता है (argument list बहुत लंबी हो जाती है)। इसके बजाय find ... -exec mv -t target {} + इस्तेमाल करें।
# सब कुछ दोबारा build किए बिना कुछ पेज render करें
flock /tmp/uc-content.lock bash -c '
  mv content/migrated/* ../stash/            # stash content mount से बाहर
  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

प्रदर्शन सुधार: template बदलाव और corpus pass के रूप में लागू

हर सुधार के दो हिस्से थे: Hugo template को सही करना ताकि भविष्य के builds सही हों, और पहले से बने HTML को patch करना ताकि इसे जारी करने के लिए full rebuild की ज़रूरत न पड़े। सबसे ज़्यादा असर डालने वाले सुधार ये थे:

  • इमेज dimensions। एक template में width="1600" height="700" hard-code था, जबकि CSS में अलग aspect ratio इस्तेमाल हो रहा था। इसे 527,815 पेजों पर ठीक किया गया। Width/height का rendered aspect ratio से मेल खाना ज़रूरी है, वरना browser गलत जगह reserve करता है (CLS को बेहतर करें)।
  • टकराते हुए aspect-ratio नियम एक ही selector पर दो stylesheets में मौजूद थे; उन्हें मिलाकर एक कर दिया गया।
  • Async file में critical CSS। First paint के लिए ज़रूरी mobile rules deferred stylesheet में थे, जिससे देर से re-layout हो रहा था। उन्हें synchronous stylesheet में ले जाया गया।
  • Lazy-loaded hero। Above-the-fold image पर loading="lazy" होने से LCP में देरी हो रही थी; इसे fetchpriority="high" से बदला गया (LCP को बेहतर करें)।
  • बहुत बड़ी LCP images को छोटे variants से बदला गया, जिससे प्रति पेज 50 से 440 KB तक की बचत हुई।
  • Quote widget अब पहली interaction पर load होता है (timeout fallback के साथ), और उसका container 480px (मोबाइल पर 560px) जगह reserve करता है। पहले इसे mount करने पर पेज का CLS लगभग 0.54 तक बढ़ जाता था।
05

काम आने वाली Cloudflare सेटिंग्स

  • Email Obfuscation बंद। इसका decoder load होने के बाद DOM को scan करके email links को फिर से लिखता है, जिससे layout shift दिखाई देता था। यह हमारे सामने आया सबसे लगातार CLS source था।
  • Rocket Loader बंद। यह scripts का क्रम बदल देता था और deferred loading में बाधा डालता था।
  • Deploy के बाद purge। Edge caches में पुराना HTML मौजूद रहता था; हर deploy के बाद path के आधार पर purge करने से stale pages सर्व होने से बच गए (Cloudflare purge docs)।
  • Staging नहीं, production को मापें। समान Cloudflare settings के बिना staging से मिले lab scores production से मेल नहीं खाते थे।
06

Schema और SEO से जुड़ी बातें

  • Search Console ने structured-data errors दिखाए क्योंकि एक Service entity में aggregateRating और review मौजूद थे। उन्हें validate कराने की कोशिश करने के बजाय हटा दिया गया; markup में वही जानकारी होनी चाहिए जिसे उपयोगकर्ता देख सकते हैं (structured data guidelines)।
  • शुरुआत में blog posts को location template से render किया गया था और उनमें गलत schema type आ गया था। अब हर template अपना entity type खुद घोषित करता है।
  • फ़्लीट और service paths में मौजूद 35 असंगत URLs पर सही nested pages के लिए permanent redirects लगाए गए (redirects)।
  • Media को /wp-content/uploads/ से /uploads/ में ले जाया गया और एक single 301 rule लगाया गया; समानांतर sed pass ने कुछ ही मिनटों में 528,854 में से 528,852 files के URLs बदल दिए।
  • Hugo के sitemap, schema, meta tags और robots.txt emit करने के बाद Yoast हटा दिया गया।
find static-v5 -name '*.html' -print0 \
  | xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'
07

Lead capture वह हिस्सा है जिसे खोना नहीं चाहिए

Quote form से साइट की कमाई होती है, इसलिए इसके लिए अलग checks बनाए गए: जिस भी पेज पर widget होना चाहिए, उसके built HTML में widget mount मौजूद हो; field names intake endpoint की अपेक्षाओं से मेल खाएँ; और directory replace करने वाला deploy standalone quote page को delete न करे। अगर cut-over के दौरान lead capture चुपचाप हट जाए, तो SEO के हर metric पर सब कुछ सफल दिखाई दे सकता है, जबकि कारोबार को मिलने वाली enquiries बंद हो जाती हैं।

08

हम क्या अलग करते

  1. पहली CLS measurement से पहले ही Email Obfuscation बंद कर देते।
  2. पहले दिन से build को partition करते।
  3. पहले दिन से content directory पर lock लगाते।
  4. पहले सुधार से पहले ही template-plus-corpus-pass pattern लिख लेते, पाँचवें सुधार के बाद नहीं।
  5. Launch checklist में field-data (CrUX) check शामिल करते, क्योंकि staging के lab scores production का प्रतिनिधित्व नहीं करते।

इसी परियोजना का कारोबारी दृष्टिकोण - जिसमें यह भी शामिल है कि हमने WordPress पर क्या रखा - case study में है।

09

स्रोत और आगे पढ़ें

अक्सर पूछे जाने वाले सवाल

क्या यह किसी ग्राहक की साइट का माइग्रेशन है?

नहीं। Unlimited Charters उसी समूह के स्वामित्व वाली इन-हाउस सिस्टर साइट है जिसके पास WordPressEscape है। यह हमारा अपना परीक्षण मामला है।

क्या Hugo पाँच लाख पेज संभाल सकता है?

हाँ, लेकिन full rebuilds इतने धीमे होते हैं कि partitioned builds और सावधानीपूर्वक file handling महत्वपूर्ण हो जाते हैं। हमारी अधिकांश समस्याएँ Hugo की bugs के बजाय फ़ाइल-सिस्टम और प्रक्रिया से जुड़ी थीं।

सबसे ज़्यादा layout shift किस वजह से हुआ?

Quote widget को reserved space के बिना mount करने से (hub pages पर CLS लगभग 0.54) और Cloudflare Email Obfuscation द्वारा load होने के बाद पेज को rewrite करने से।

क्या ये सीख छोटी साइटों पर भी लागू होती हैं?

हाँ। यही checks (URL समानता, इमेज dimensions, critical CSS, non-lazy hero image और deferred widgets) 40-पेज वाली साइट पर भी लागू होते हैं; अंतर सिर्फ़ इतना है कि वहाँ वे घंटों के बजाय कुछ मिनटों में पूरे हो जाते हैं।

मेरी साइट का मुफ़्त स्कैन करें

देखें कि क्या आपकी साइट भी इसी प्रक्रिया के लिए योग्य है

मुफ़्त 60-सेकंड का ऑडिट आपका वास्तविक PageSpeed स्कोर, पेजों की सटीक संख्या, SEO की कमियाँ और वे WordPress सुविधाएँ दिखाता है जिन्हें बदलना होगा। इसके बाद WordPressEscape आपकी साइट को Hugo पर दोबारा बनाता है, हर URL को बरकरार रखता है और पहले ही दिन आपको सोर्स कोड सौंप देता है - ठीक उसी तरह, जैसे UC को दोबारा बनाया गया था।

मेरी साइट का मुफ़्त स्कैन करें
पढ़ते रहें
सभी गाइड्स33
संबंधित खोजेंWordPress से Hugo माइग्रेशन528,854 पेज (इन-हाउस परीक्षण)Hugo पार्टिशन किया गया बिल्डCloudflare CLS सुधारस्कीमा सफ़ाईURL समानता