WordPressEscape

Beranda / Panduan

Workbench

Memigrasikan 528.854 Halaman WordPress ke Hugo: Catatan Teknis

Berikut catatan kerja dari proses pemindahan Unlimited Charters, situs saudari internal kami, dari WordPress ke Hugo pada Mei 2026. Ringkasan bisnisnya tersedia dalam studi kasus; bagian ini ditujukan bagi siapa pun yang harus mengerjakannya: apa yang rusak saat menangani setengah juta halaman, perintah yang sempat menyulitkan kami, dan pemeriksaan yang kini kami jalankan di setiap situs, baik besar maupun kecil.

Waktu baca 5 menit 9 bagian Dirancang untuk meraih peringkat tinggi
Di halaman ini
  1. Konteks
  2. Inventarisasi template sebelum konten
  3. Build terpartisi dan jebakan sistem file
  4. Perbaikan performa, diterapkan sebagai perubahan template dan proses di seluruh korpus
  5. Pengaturan Cloudflare yang berpengaruh
  6. Detail schema dan SEO
  7. Lead capture adalah bagian yang tidak boleh hilang
  8. Apa yang akan kami lakukan secara berbeda
  9. Sumber dan bacaan lanjutan
  10. Pertanyaan yang sering diajukan
Jawaban cepat

Dalam skala sebesar ini, masalahnya lebih banyak terkait sistem file dan proses daripada Hugo: mempartisi build, menyimpan konten sementara di luar mount konten Hugo, tidak pernah menjalankan dua proses pemindahan pada direktori yang sama, serta memperlakukan setiap perbaikan sebagai perubahan template yang diikuti proses skrip di seluruh korpus. Peningkatan performa terbesar berasal dari dimensi gambar, critical CSS sinkron, gambar LCP yang tidak lazy-load, widget kutipan yang ditunda dengan ruang yang sudah dicadangkan, serta menonaktifkan Cloudflare Email Obfuscation.

01

Konteks

Unlimited Charters dimiliki oleh grup yang sama dengan WordPressEscape; ini adalah migrasi uji internal kami sendiri, yang dilakukan dengan akses server penuh. Situs tersebut memiliki sedikit lebih dari setengah juta URL, terutama halaman lokasi berbasis template, ditambah hub, halaman armada, dan blog. Targetnya adalah build Hugo yang disajikan sebagai file statis di balik Cloudflare, dengan mempertahankan setiap path yang sudah ada.

02

Inventarisasi template sebelum konten

Kami memulai dengan mengelompokkan URL berdasarkan template WordPress yang merendernya, bukan berdasarkan pola URL. Setiap kelompok mendapat satu keputusan: dibangun ulang sebagai layout Hugo, atau untuk sementara disajikan sebagai snapshot statis dari output WordPress. Membangun ulang kelompok dengan trafik tinggi terlebih dahulu dan membuat snapshot untuk halaman yang tidak lazim memungkinkan proyek terus berjalan tanpa terhambat oleh ekor panjang halaman kustom.

Ada satu hal yang perlu diperhatikan: di WordPress, path URL tidak selalu sama dengan slug post_name. Halaman induk, aturan rewrite kustom, dan impor lama menghasilkan path yang tidak cocok dengan slug, sehingga path harus diambil dari hasil crawl, bukan dari database.

03

Build terpartisi dan jebakan sistem file

Merender semua halaman dalam satu proses berjalan lambat dan membuat setiap perubahan kecil menjadi mahal. Kami mempartisinya: memindahkan file sumber yang tidak sedang dibangun ke penyimpanan sementara, membangun sebagian konten, melakukan deploy, lalu mengembalikannya. Empat jebakan berikut menghabiskan waktu kami:

  1. Penyimpanan sementara harus berada di luar mount konten Hugo. Jika diletakkan di mana pun di bawah direktori konten yang di-mount, Hugo tetap akan memindai setiap file dan partisi tidak memberikan manfaat apa pun.
  2. rsync --exclude=index.html mengecualikan setiap index.html di semua tingkat direktori, bukan hanya yang teratas. Tambahkan anchor pada polanya (--exclude=/index.html).
  3. Dua proses pemindahan bersamaan pada direktori yang sama akan membuat direktori bertingkat. Dua proses pemulihan yang berjalan bersamaan menghasilkan sekitar 367.000 direktori yang berada satu tingkat terlalu dalam. Produksi tetap berjalan baik karena menyajikan output hasil build; satu proses pemindahan yang dijalankan dengan skrip berhasil meratakannya. Satu proses harus memiliki kendali atas direktori tersebut, yang dipastikan dengan lock.
  4. mv dir/* target/ gagal pada ukuran seperti ini (daftar argumen terlalu panjang). Gunakan find ... -exec mv -t target {} +.
# merender sejumlah kecil halaman tanpa membangun ulang semuanya
flock /tmp/uc-content.lock bash -c '
  mv content/migrated/* ../stash/            # stash OUTSIDE the 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

Perbaikan performa, diterapkan sebagai perubahan template dan proses di seluruh korpus

Setiap perbaikan memiliki dua bagian: memperbaiki template Hugo agar build berikutnya sudah benar, lalu menambal HTML yang sudah terbangun sehingga kami tidak perlu melakukan build ulang penuh untuk menerapkannya. Perbaikan yang paling berdampak adalah:

  • Dimensi gambar. Sebuah template menetapkan width="1600" height="700" secara hard-code, sementara CSS menggunakan rasio aspek yang berbeda. Kami memperbaikinya pada 527.815 halaman. Nilai width/height harus sesuai dengan rasio aspek hasil render; jika tidak, browser akan mencadangkan ruang yang salah (mengoptimalkan CLS).
  • Aturan aspect-ratio yang saling bertentangan pada selector yang sama di dua stylesheet; kami menggabungkannya menjadi satu.
  • Critical CSS berada dalam file asinkron. Aturan mobile yang diperlukan untuk tampilan pertama berada di stylesheet yang ditunda, sehingga menyebabkan tata letak berubah ulang terlambat. Kami memindahkannya ke stylesheet sinkron.
  • Hero image dimuat secara lazy. loading="lazy" pada gambar di area atas halaman menunda LCP; kami menggantinya dengan fetchpriority="high" (mengoptimalkan LCP).
  • Gambar LCP berukuran terlalu besar diganti dengan varian yang lebih kecil, menghemat 50 hingga 440 KB per halaman.
  • Widget kutipan dimuat saat interaksi pertama (dengan fallback berbasis timeout), dan containernya mencadangkan ruang sebesar 480px (560px di perangkat mobile). Sebelumnya, saat widget dipasang, halaman bergeser dengan CLS sekitar 0,54.
05

Pengaturan Cloudflare yang berpengaruh

  • Email Obfuscation dinonaktifkan. Decoder-nya memindai DOM setelah halaman dimuat lalu menulis ulang tautan email, yang terlihat sebagai pergeseran tata letak. Inilah sumber CLS paling konsisten yang kami temukan.
  • Rocket Loader dinonaktifkan. Fitur ini mengurutkan ulang skrip dan mengganggu pemuatan yang ditunda.
  • Lakukan purge setelah deploy. Cache edge masih menyimpan HTML lama; melakukan purge berdasarkan path setelah setiap deploy mencegah halaman usang ditayangkan (dokumentasi purge Cloudflare).
  • Ukur lingkungan produksi, bukan staging. Staging yang tidak menggunakan pengaturan Cloudflare yang sama menghasilkan skor lab yang tidak sesuai dengan produksi.
06

Detail schema dan SEO

  • Search Console melaporkan kesalahan structured data karena entitas Service memiliki aggregateRating dan review. Kami menghapus keduanya alih-alih berusaha membuatnya lolos validasi; markup harus mencerminkan konten yang dapat dilihat pengguna (panduan structured data).
  • Postingan blog awalnya dirender menggunakan template lokasi dan mewarisi tipe schema yang salah. Kini setiap template mendeklarasikan entitasnya sendiri.
  • 35 path armada dan layanan yang tidak konsisten dialihkan secara permanen ke halaman bertingkat yang benar (redirect).
  • Media dipindahkan dari /wp-content/uploads/ ke /uploads/ menggunakan satu aturan 301; proses sed paralel menulis ulang 528.852 dari 528.854 file hanya dalam beberapa menit.
  • Yoast dihapus setelah Hugo menghasilkan sitemap, schema, meta tag, dan robots.txt.
find static-v5 -name '*.html' -print0 \
  | xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'
07

Lead capture adalah bagian yang tidak boleh hilang

Formulir permintaan penawaran adalah sumber pendapatan situs, jadi formulir ini memiliki pemeriksaan tersendiri: mount widget harus ada dalam HTML hasil build di setiap halaman yang memilikinya, nama field harus sesuai dengan yang diharapkan endpoint intake, dan deploy yang mengganti sebuah direktori tidak boleh menghapus halaman permintaan penawaran yang berdiri sendiri. Cut-over yang menghilangkan lead capture secara diam-diam dapat terlihat sukses di semua metrik SEO, sementara bisnis kehilangan permintaan dari calon pelanggan.

08

Apa yang akan kami lakukan secara berbeda

  1. Nonaktifkan Email Obfuscation sebelum pengukuran CLS pertama.
  2. Partisi build sejak hari pertama.
  3. Kunci direktori konten sejak hari pertama.
  4. Dokumentasikan pola perubahan template dan proses di seluruh korpus sebelum perbaikan pertama, bukan setelah perbaikan kelima.
  5. Masukkan pemeriksaan data lapangan (CrUX) ke dalam checklist peluncuran, karena skor lab di staging bukanlah gambaran produksi.

Pandangan bisnis dari proyek yang sama, termasuk bagian yang tetap kami pertahankan di WordPress, tersedia dalam studi kasus.

09

Sumber dan bacaan lanjutan

Pertanyaan yang sering diajukan

Apakah ini migrasi pelanggan?

Bukan. Unlimited Charters adalah situs saudari internal yang dimiliki oleh grup yang sama dengan WordPressEscape. Ini adalah kasus uji internal kami sendiri.

Apakah Hugo mampu menangani setengah juta halaman?

Ya, tetapi build penuh cukup lambat sehingga build terpartisi dan pengelolaan file yang cermat sangat penting. Sebagian besar masalah kami berkaitan dengan sistem file dan proses, bukan bug Hugo.

Apa yang menyebabkan pergeseran tata letak terburuk?

Widget kutipan yang dipasang tanpa ruang cadangan (sekitar 0,54 CLS pada halaman hub) serta Cloudflare Email Obfuscation yang menulis ulang halaman setelah dimuat.

Apakah pelajaran ini juga berlaku untuk situs kecil?

Ya. Pemeriksaan yang sama (kesetaraan URL, dimensi gambar, critical CSS, hero image tanpa lazy-load, dan widget yang ditunda) berlaku untuk situs dengan 40 halaman; prosesnya hanya selesai dalam hitungan menit, bukan jam.

Pindai situs saya gratis

Lihat apakah situs Anda memenuhi syarat untuk perlakuan yang sama

Audit gratis selama 60 detik menampilkan skor PageSpeed aktual, jumlah halaman yang tepat, celah SEO, serta fitur WordPress yang perlu digantikan. Setelah itu, WordPressEscape membangun ulang situs Anda dengan Hugo, mempertahankan semua URL, dan menyerahkan source code kepada Anda sejak hari pertama - dengan cara yang sama seperti UC dibangun ulang.

Pindai situs saya gratis
Lanjutkan membaca
Semua panduan33
Pencarian terkaitmigrasi wordpress ke hugo528.854 halaman (uji internal)build Hugo terpartisiperbaikan CLS Cloudflarepembersihan schemakesetaraan URL