{"canonical_url":"https://engineer.company/uk/glossary/ssg/","content_markdown":"# Генератор статичних сайтів\n\n## Що це таке\n\nГенератор статичних сайтів — це інструмент збірки, який бере теку з вихідними\nфайлами, зазвичай сторінками, написаними в Markdown, і набір шаблонів та\nперетворює їх на готовий вебсайт, що складається лише з файлів: HTML, таблиць\nстилів, скриптів і зображень, які вебсервер віддає точно такими, якими вони є.\nНазву часто скорочують до SSG, а слово «статичний» описує те, як результат\nвіддається, — ті самі байти кожному, хто запитує адресу, — а не те, як сторінка\nповодиться, коли вже потрапила в браузер.\n\nПротилежність йому — динамічний підхід системи керування вмістом чи\nвебзастосунку, де програма на сервері збирає кожну сторінку в момент запиту,\nзазвичай звертаючись до бази даних і заповнюючи шаблони. Генератор проганяє такі\nсамі шаблони по такому самому вмісту, але раз на кожну зміну, а не раз на кожен\nвізит, і залишає результат у теці, яку звичайний вебсервер, об'єктне сховище чи\nмережа доставки вмісту може віддавати, не знаючи, як ці сторінки зроблено.\n\nHugo — один із таких генераторів статичних сайтів. Його документація представляє\nйого як генератор, написаний на Go, оптимізований для швидкості й розроблений\nдля гнучкості, що збирає цілий сайт за секунди, а часто й швидше. Звичайний цикл\n— писати із запущеним вбудованим вебсервером Hugo, який перезбирає сайт після\nкожної зміни й перезавантажує відкриті сторінки в браузері, а потім зібрати сайт\nі розгорнути його на хостингу:\n\n```sh\nhugo server     # збирає, віддає й перезбирає після кожного збереження\nhugo --minify   # записує готовий сайт у public/\n```\n\n## Чому це важливо\n\nЦей вибір — про те, коли виконується робота. Генератор переносить її з моменту\nзапиту на етап збірки, і майже все інше випливає саме з цього.\n\nВіддати файл — чи не найдешевше, що робить вебсервер, тож згенерований сайт\nвідповідає швидко й може працювати на дуже малій машині, а оскільки кожен\nвідвідувач адреси отримує ті самі байти, кешування просте. Коли за сторінками\nнемає коду застосунку чи бази даних, захищати й оновлювати доводиться набагато\nменше. Результат — це тека, тож переїзд на інший хостинг зводиться до копіювання\nфайлів, а вихідні файли лежать у системі контролю версій, де кожну зміну кожної\nсторінки можна переглянути й простежити.\n\nВитрати походять звідти ж. Кожна зміна, навіть виправлена одруківка, означає\nнову збірку й нове розгортання, тож швидкість збірки важить тим більше, чим\nбільше сторінок. Усе, що залежить від того, хто запитує, як-от пошук, коментарі,\nвхід до облікового запису чи форма, що зберігає отримане, потребує коду в\nбраузері, окремого сервісу або способу вирішити це під час збірки, бо на сервері\nнемає програми, яка б це зробила. Між збірками час стоїть на місці: Hugo за\nзамовчуванням пропускає сторінку з датою в майбутньому, тож сторінка,\nзапланована на понеділок, з'являється з першою збіркою в понеділок або пізніше.\nНавіть переспрямування змінюють форму. Коли немає програми, яка надіслала б\nHTTP-переспрямування, Hugo для переміщеної сторінки типово кладе за старою\nадресою невеликий HTML-файл, що відправляє браузер далі, — підхід, який\nдокументація називає переносним між усіма хостинг-провайдерами.\n\n## Як це виглядає на практиці\n\nЦей сайт зібрано за допомогою генератора статичних сайтів. [Сторінка\nподяк](/uk/credits/) називає Hugo генератором статичних сайтів і приписує йому\nшаблони, таксономії, усі мови та стрічки. Про те, що потрапляє в браузер, вона\nкаже, що HTML повністю готовий ще до того, як хтось його попросить: кожна\nсторінка лежить на диску файлом, а не складається з шаблону під кожен запит.\nНавіть вигляд визначається під час збірки: світла тема отримує одну зі своїх\nстін, коли збирається сторінка, тож з кожною публікацією сайт виглядає інакше.\nЗбірку не віддано на сторонній сервіс: обов'язкові перевірки якості запускаються\nна машині, де пишеться сайт, будь-яке зауваження інструмента там рахується як\nпомилка, а в жовтні 2026 року збиралося 2 268 сторінок. Їх віддає одноядерний\nсервер з 512 МБ пам'яті, де вебсервер ділить ту саму теку з файлами з трьома\nіншими сервісами, що відповідають за сайт, тож одне розгортання доходить до всіх\nчотирьох.\n\n[Запис у портфоліо про те, як цей сайт збудовано на Hugo](/uk/portfolio/built-a-multilingual-hugo-site-in-3-languages/)\nдокументує етап реалізації в серпні 2026 року й пояснює причини. Три мови, відсутність окремо оплачуваного сервісу застосунку й відвідувачі, яких не\nпередають третім сторонам, відсіяли майже всі системи керування вмістом, бо\nзапущений бекенд вимагає захисту, оновлень і грошей, а ще пояснень на сторінці\nконфіденційності. Сайт тоді мав 108 файлів шаблонів, 53 з них — часткові шаблони,\nпублікував кожну сторінку в чотирьох поданнях з одного дерева вмісту й збирав це\nдерево ще сім разів для тематичних субдоменів, вказуючи генераторові іншу теку з\nвмістом. Запис описує компроміс, пов'язаний із додаванням можливостей під час збірки, а не в браузері: за винятком зафіксованого вузького застосування JavaScript для фільтра портфоліо, інтерактивні можливості треба було реалізувати під час збірки або не додавати, тому пошуковий індекс прорахували й відклали, замість того щоб\nвипустити.\n\n## Де виникають проблеми\n\n**Видалена сторінка лишається в мережі.** Сторінку, прибрану з вихідних файлів,\nдосі віддають за старою адресою, і пошукові системи й далі її знаходять. Hugo не\nочищає теку з результатом перед збіркою: наявні файли перезаписуються, але\nніколи не видаляються, тож у `public/` можуть лишатися сторінки з попередніх\nзбірок, зокрема чернетки й сторінки з минулим терміном дії, і все, що копіює цю\nтеку на сервер, копіює і їх. Кеш `resources/` у Hugo має споріднену проблему:\nправила дизайну цього сайту попереджають, що він може віддати застарілий\nCSS-бандл, коли змінився лише вихідний CSS. Збирайте в чисту теку, з прапорцем\nHugo `--cleanDestinationDir` або власним кроком видалення; збірка цього сайту\nприбирає і `public/`, і `resources/`, перш ніж почати.\n\n**Готова сторінка так і не з'являється.** Допис написано, закомічено й\nрозгорнуто, збірка повідомляє про успіх, а сторінки для нього на сайті немає. За\nзамовчуванням Hugo пропускає вміст, позначений як чернетка, вміст, дата або дата\nпублікації якого в майбутньому, і вміст, термін дії якого минув, і все це не\nвважається помилкою. Досить дати, набраної на день наперед. Спершу перевірте ці\nчотири поля, лишіть `--buildDrafts`, `--buildFuture` і `--buildExpired` для\nпопередніх переглядів, а для запланованої сторінки подбайте про збірку після її\nдати.\n\n**Кожна сторінка заявляє, що змінилася водночас.** Карта сайту дає майже кожній\nадресі той самий час останньої зміни, а це каже пошуковому роботові, що змінився\nвесь сайт, і мовчить про те, які сторінки змінилися насправді. Генератор мусить\nдесь брати дату зміни кожної сторінки, і власна позначка часу файлу — хибне\nджерело, коли якийсь крок перезаписує файли, вміст яких лишається тим самим.\nКонфігурація цього сайту фіксує, що крок синхронізації перезаписує всі 189\nфайлів вмісту під час кожного запуску, тож 172 зі 176 адрес у карті сайту мали\nодну позначку часу. Беріть дату із системи контролю версій: Hugo читає дату\nостанньої Git-ревізії файлу, коли ввімкнено `enableGitInfo`, а повторна\nсинхронізація, яка дає ідентичні байти, не створює коміту, тож синхронізація\nпісля місяця правок зачепила 8 із 186 файлів.\n\n**Назовні потрапляють файли, які ніхто не збирався публікувати.** Будь-хто, хто\nвгадає назву, може завантажити файл, що перелічує інші файли. Генератор публікує\nвсе, що лежить у теках, які він читає, за винятком того, що прибирає правило\nвиключення, а правило, яке сягає не кожної теки, лишає решту відкритою.\nКонфігурація цього сайту фіксує, що загальний список ігнорування сайту не діяв\nна змонтовану теку модуля: збірка опублікувала всі шість файлів `.DS_Store`, які\nFinder у macOS залишив в icons/, images/ і webmanifest/, на кожному хості, і\nкожен перелічував назви поруч із собою, тож той, що в images/, назвав теку, яку\nсайт приховує. Фільтр, якому бракувало одного пробілу після `!`, одного разу\nнатомість виключив усі зображення в монтуванні. Задавайте виключення на кожному\nмонтуванні, що публікує, а потім перевіряйте зібраний результат на файли, яким\nтам не місце; дві перевірки цього сайту зупиняють збірку, що віддає такий файл.\n\n## Що почитати далі\n\n- [Hugo: Introduction](https://gohugo.io/about/introduction/) — що таке Hugo,\n  для чого його використовують і як проходить цикл від написання до збірки й\n  розгортання.\n- [Hugo: Basic usage](https://gohugo.io/getting-started/usage/) — як зібрати\n  сайт і запустити сервер, чому `public/` зберігає старі файли і який вміст\n  збірка пропускає.\n- [Hugo: Configure front matter](https://gohugo.io/configuration/front-matter/)\n  — як Hugo вибирає дати сторінки, зокрема токени `:git` і `:fileModTime`.\n- [Hugo: Configure modules](https://gohugo.io/configuration/module/) —\n  монтування, фільтр `files` для кожного з них і правило, за яким оголошене\n  монтування прибирає типове.\n- [Hugo: URL management](https://gohugo.io/content-management/urls/) —\n  псевдоніми й файли переспрямування, які статичний хостинг віддає замість\n  серверного переспрямування.\n\n\u003chttps://engineer.company/uk/glossary/ssg/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як генератор статичних сайтів заздалегідь перетворює текст і шаблони на файли, що це дає, чого коштує і які пастки збірки публікують не ті сторінки.","formats":{"gemtext":"https://engineer.company/uk/glossary/ssg/index.gmi","gopher":"https://engineer.company/uk/glossary/ssg/gophermap","html":"https://engineer.company/uk/glossary/ssg/","json":"https://engineer.company/uk/glossary/ssg/index.json","markdown":"https://engineer.company/uk/glossary/ssg/index.md","pdf":"https://engineer.company/uk/glossary/ssg/index.pdf"},"kind":"page","language":"uk","title":"Що таке генератор статичних сайтів?","url":"https://engineer.company/uk/glossary/ssg/","version":1}