На цій сторінці
- Контекст
- Інвентаризація шаблонів до роботи з контентом
- Розподілені збірки та пастки файлової системи
- Виправлення швидкодії: зміна шаблону плюс опрацювання всього корпусу
- Налаштування Cloudflare, які мали значення
- Деталі схеми та SEO
- Збір заявок - це те, що не можна втратити
- Що ми зробили б інакше
- Джерела та додаткові матеріали
- Поширені запитання
У такому масштабі проблеми більше пов’язані з файловою системою та процесами, ніж із Hugo: потрібно розподіляти складання, зберігати відкладений контент за межами монтування content у Hugo, ніколи не запускати два процеси переміщення для одного каталогу та розглядати кожне виправлення як зміну шаблону плюс скриптове опрацювання всього корпусу сторінок. Найбільший приріст швидкодії дали правильні розміри зображень, синхронне критичне CSS, незавантажуване ліниво LCP-зображення, відкладений віджет цитати із зарезервованим місцем і вимкнення Cloudflare Email Obfuscation.
Контекст
Unlimited Charters належить тій самій групі, що й WordPressEscape; це була наша власна тестова міграція з повним доступом до сервера. На сайті було трохи більше ніж пів мільйона URL-адрес - переважно шаблонні сторінки локацій, а також хаби, сторінки флоту та блог. Ми прагнули отримати збірку Hugo зі статичними файлами, яку обслуговує Cloudflare, зі збереженням усіх наявних шляхів.
Інвентаризація шаблонів до роботи з контентом
Спочатку ми згрупували URL-адреси за шаблоном WordPress, який їх відображав, а не за структурою URL. Для кожної групи ухвалювали одне рішення: перебудувати її як layout у Hugo або тимчасово використовувати статичний знімок результату роботи WordPress. Перебудова найвідвідуваніших груп на першому етапі та створення знімків для нетипових сторінок допомогли рухатися вперед, не блокуючи проєкт через довгий хвіст спеціальних сторінок.
Варто знати про одну особливість: у WordPress шлях URL не завжди збігається зі slug post_name. Батьківські сторінки, власні правила перезапису та старі імпорти створювали шляхи, які не відповідали slug, тому шлях доводилося отримувати зі сканування, а не з бази даних.
Розподілені збірки та пастки файлової системи
Рендеринг усіх сторінок за один запуск був повільним, а кожна невелика зміна ставала дорогою. Ми розділили процес: переносили вихідні файли, які не збирали, до тимчасового сховища, збирали підмножину, розгортали її, а потім повертали файли назад. Чотири пастки забрали в нас час:
- Тимчасове сховище має розташовуватися за межами монтування content у Hugo. Якщо воно міститься десь у змонтованому каталозі content, Hugo все одно обходитиме кожен файл, і розподіл не дасть жодної користі.
rsync --exclude=index.htmlвиключає всі index.html на всіх рівнях вкладеності, а не лише верхній файл. Зафіксуйте шаблон відносно кореня (--exclude=/index.html).- Два одночасні процеси переміщення для одного каталогу вкладають його один в один. Два процеси відновлення, які працювали одночасно, створили близько 367 000 каталогів на один рівень глибше. У продакшені все працювало, оскільки він обслуговував уже зібраний результат; один скрипт переміщення вирівняв структуру. Каталог має контролювати лише один процес - це забезпечується блокуванням.
mv dir/* target/не працює в такому масштабі (список аргументів надто довгий). Використовуйтеfind ... -exec mv -t target {} +.
# відрендерити кілька сторінок без повної перебудови
flock /tmp/uc-content.lock bash -c '
mv content/migrated/* ../stash/ # сховище ЗА МЕЖАМИ монтування content
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/ {} +
'Виправлення швидкодії: зміна шаблону плюс опрацювання всього корпусу
Кожне виправлення складалося з двох частин: ми коригували шаблон Hugo, щоб майбутні збірки були правильними, і виправляли вже зібраний HTML, щоб не чекати повної перебудови для випуску змін. Найбільше значення мали такі зміни:
- Розміри зображень. У шаблоні були жорстко задані
width="1600" height="700", хоча CSS використовував інше співвідношення сторін. Виправлення застосували до 527 815 сторінок. Значення width/height мають відповідати фактичному співвідношенню сторін, інакше браузер зарезервує неправильний простір (оптимізація CLS). - Конфліктні правила aspect-ratio для одного селектора у двох таблицях стилів; ми об’єднали їх в одне правило.
- Критичний CSS в асинхронному файлі. Мобільні правила, потрібні для першого відображення, містилися у відкладеній таблиці стилів, що спричиняло пізнє повторне компонування. Ми перенесли їх у синхронну таблицю стилів.
- Ліниво завантажуваний hero-блок. Атрибут
loading="lazy"для зображення у видимій частині сторінки затримував LCP; ми замінили його наfetchpriority="high"(оптимізація LCP). - Завеликі LCP-зображення замінили на менші варіанти, заощадивши від 50 до 440 КБ на сторінку.
- Віджет цитати завантажується після першої взаємодії (із резервним запуском за тайм-аутом), а його контейнер резервує 480 px (560 px на мобільних пристроях). Раніше його монтування зміщувало сторінку, створюючи CLS близько 0,54.
Налаштування Cloudflare, які мали значення
- Email Obfuscation вимкнено. Його декодер після завантаження обходить DOM і переписує посилання на електронні адреси, що спричиняло зміщення макета. Це було найстійкішим джерелом CLS, яке ми виявили.
- Rocket Loader вимкнено. Він змінював порядок виконання скриптів і заважав відкладеному завантаженню.
- Очищення кешу після розгортання. Граничні кеші зберігали старий HTML; очищення за шляхом після кожного розгортання запобігало показу застарілих сторінок (документація Cloudflare щодо очищення кешу).
- Вимірюйте продакшен, а не staging. Staging без таких самих налаштувань Cloudflare давав лабораторні показники, які не відповідали продакшену.
Деталі схеми та SEO
- Search Console повідомляла про помилки структурованих даних, оскільки сутність Service містила
aggregateRatingіreview. Ми видалили їх, а не намагалися домогтися проходження перевірки: розмітка має відповідати контенту, який бачать користувачі (рекомендації щодо структурованих даних). - Спочатку записи блогу рендерилися за шаблоном локацій і успадковували неправильний тип схеми. Тепер кожен шаблон оголошує власну сутність.
- 35 непослідовних шляхів флоту та послуг отримали постійні перенаправлення на правильні вкладені сторінки (перенаправлення).
- Медіафайли перемістили з
/wp-content/uploads/до/uploads/за одним правилом 301; паралельний прохідsedза кілька хвилин переписав шляхи у 528 852 із 528 854 файлів. - Yoast видалили після того, як Hugo почав генерувати sitemap, схему, метатеги та robots.txt.
find static-v5 -name '*.html' -print0 \
| xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'Збір заявок - це те, що не можна втратити
Форма запиту - джерело доходу сайту, тому для неї ми створили окремі перевірки: контейнер віджета має бути присутнім у зібраному HTML кожної сторінки, де він використовувався; назви полів мають відповідати вимогам кінцевої точки приймання; а розгортання, яке замінює каталог, не повинно видаляти окрему сторінку запиту. Перехід, під час якого непомітно зникає збір заявок, може виглядати успішним за всіма SEO-показниками, тоді як бізнес втрачає звернення.
Що ми зробили б інакше
- Вимкнули б Email Obfuscation ще до першого вимірювання CLS.
- Розділили б збірку вже в перший день.
- Заблокували б каталог content уже в перший день.
- Зафіксували б підхід «шаблон плюс опрацювання всього корпусу» ще до першого виправлення, а не після п’ятого.
- Додали б перевірку польових даних (CrUX) до контрольного списку запуску, адже лабораторні показники на staging не відображають продакшен.
Бізнесовий погляд на цей самий проєкт, зокрема інформація про те, що ми залишили на WordPress, - у кейсі.
Джерела та додаткові матеріали
Основна документація, на яку ми спиралися під час підготовки цього матеріалу. Посилання перевірено 11 листопада 2026 року.
- Документація Hugo: швидкий старт
- Документація Hugo: керування URL (постійні посилання та псевдоніми)
- web.dev: оптимізація сукупного зміщення макета
- web.dev: оптимізація Largest Contentful Paint
- web.dev: сукупне зміщення макета (CLS)
- Документація Cloudflare: очищення кешу
- Документація Cloudflare: кеш
- Google Search Central: вступ до структурованих даних
- Google Search Central: перенаправлення та Google Search
- Google Search Central: перенесення сайту зі зміною URL
- Документація Chrome UX Report (CrUX)
Поширені запитання
Це міграція клієнтського сайту?
Ні. Unlimited Charters - внутрішній дочірній сайт, що належить тій самій групі, що й WordPressEscape. Це наш власний тестовий кейс.
Чи впорається Hugo із пів мільйона сторінок?
Так, але повні перебудови достатньо повільні, тому розподілені збірки та уважна робота з файлами мають значення. Більшість наших проблем була пов’язана з файловою системою та процесами, а не з помилками Hugo.
Що спричинило найбільше зміщення макета?
Віджет цитати монтувався без зарезервованого місця (близько 0,54 CLS на сторінках-хабах), а Cloudflare Email Obfuscation переписував сторінку після завантаження.
Чи застосовні ці висновки до невеликих сайтів?
Так. Ті самі перевірки - відповідність URL, розміри зображень, критичний CSS, hero-зображення без lazy loading і відкладені віджети - застосовні до сайту на 40 сторінок; просто вони виконуються за хвилини, а не за години.
Перевірте, чи підходить ваш сайт для такого самого рішення
Безкоштовний аудит за 60 секунд покаже ваш реальний показник PageSpeed, точну кількість сторінок, SEO-проблеми та функції WordPress, які потрібно замінити. Потім WordPressEscape перебудує сайт на Hugo, збереже всі URL-адреси й передасть вам вихідний код уже в перший день - так само, як ми перебудували UC.
Безкоштовно просканувати мій сайт

