← Cloudflare Pages / pages / framework-guides

Hugo

Hugo ↗ je nástroj pro generování statických webů napsaný v Go. Je neuvěřitelně rychlý a nabízí skvělé vysokoúrovňové a flexibilní primitivy pro správu obsahu pomocí různých formáty obsahu ↗.

V tomto průvodci vytvoříte novou aplikaci Hugo a nasadíte ji pomocí Cloudflare Pages. Použijete hugo CLI k vytvoření nového webu Hugo.

Než budete pokračovat

Všechny průvodce frameworky předpokládají, že již máte základní znalosti Git ↗. Pokud s Gitem začínáte, podívejte se na tento shrnutá příručka ke Gitu ↗ jak nastavit Git na svém lokálním počítači.

Pokud klonujete přes SSH, musíte vygenerujte SSH klíče ↗ na každém počítači, který používáte pro push nebo pull z GitHubu.

Viz dokumentace GitHub ↗ a Dokumentace Git ↗ s dalšími informacemi.

Přejděte na Nasadit pomocí Cloudflare Pages pokud již máte web Hugo hostovaný u svého Poskytovatel Git.

Nainstalujte Hugo

Nainstalujte Hugo CLI podle konkrétních pokynů pro váš operační systém.

Pokud používáte správce balíčků Homebrew ↗, spusťte brew install příkaz v terminálu k instalaci Hugo:

brew install hugo

Pokud používáte správce balíčků Chocolatey ↗, spusťte choco install příkaz v terminálu k instalaci Hugo:

choco install hugo --confirm

Pokud používáte správce balíčků Scoop ↗, spusťte scoop install příkaz v terminálu k instalaci Hugo:

scoop install hugo

Správce balíčků vaší linuxové distribuce může obsahovat Hugo. Pokud tomu tak je, nainstalujte Hugo přímo pomocí správce balíčků dané distribuce. Například v Ubuntu spusťte tento příkaz:

sudo apt-get install hugo

Pokud váš správce balíčků neobsahuje Hugo nebo chcete stáhnout verzi přímo, přejděte na Ruční sekce.

Ruční instalace

Repozitář Hugo na GitHubu obsahuje předpřipravené verze příkazového nástroje Hugo pro různé operační systémy, které najdete na stránka Releases ↗.

Další pokyny k instalaci těchto verzí najdete v dokumentace Hugo ↗.

Vytvořte nový projekt

Po nainstalování Hugo se podívejte na rychlý start Hugo ↗ a vytvořte projekt, nebo vytvořte nový projekt spuštěním hugo new příkaz v terminálu:

hugo new site my-hugo-site

Weby Hugo využívají motivy k přizpůsobení vzhledu a stylu staticky sestaveného HTML webu. K dispozici je řada motivů na themes.gohugo.io ↗ : prozatím použijte Motiv Ananke ↗ spuštěním následujících příkazů v terminálu:

cd my-hugo-site
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
echo "theme = 'ananke'" >> hugo.toml

Vytvořte příspěvek

Vytvořte nový příspěvek, aby váš web Hugo měl nějaký počáteční obsah. Spusťte hugo new příkaz v terminálu pro vygenerování nového příspěvku:

hugo new content posts/hello-world.md

Uvnitř hello-world.md, přidejte nějaký úvodní obsah a vytvořte svůj příspěvek. Odstraňte draft řádek ve frontmatteru svého příspěvku ve chvíli, kdy je připravený ke zveřejnění. Všechny příspěvky s draft: true sada bude sestavovacím procesem Hugo přeskočena.

Vytvořte repozitář GitHub

Vytvořte nový repozitář GitHub na repo.new ↗. Po vytvoření nového repozitáře přejděte do adresáře nově vytvořeného projektu a v terminálu spusťte následující příkazy, kterými připravíte a odešlete svou místní aplikaci na GitHub:

git remote add origin https://github.com/<your-gh-username>/<repository-name>
git branch -M main
git push -u origin main

Nasadit pomocí Cloudflare Pages

Chcete-li nasadit svůj web do Pages:

V dashboardu Cloudflare přejděte na Workers & Pages stránce.
Přejděte na Workers & Pages ↗
Vyberte Vytvoření aplikace.
Vyberte Pages kartě.
Vyberte Importujte existující repozitář Git.
Vyberte nově vytvořený repozitář GitHub a poté vyberte Zahájit nastavení.
V Nastavení sestavení a nasazení sekci uveďte následující informace:

Konfigurační možnost	Hodnota
Produkční větev	`main`
Příkaz sestavení	`hugo`
Adresář sestavení	`public`

Zatímco public je výchozí build directory pro weby Hugo, toto nastavení lze změnit pomocí publishDir nastavení ↗.

Konfigurace základní URL adresy

Hugo umožňuje nakonfigurovat baseURL vaší aplikace. To vám umožní využít absURL pomocníka k sestavení úplných kanonických URL adres. Chcete-li to provést v Pages, musíte zadat -b nebo --baseURL příznaky spolu s CF_PAGES_URL proměnnou prostředí do hugo build command.

Váš konečný příkaz sestavení může vypadat takto:

hugo -b $CF_PAGES_URL

Po dokončení konfigurace nasazení vyberte Save and Deploy. Měli byste vidět, jak Cloudflare Pages instaluje hugo a závislostí vašeho projektu a sestavením webu před jeho nasazením.

Po nasazení webu získáte pro svůj projekt jedinečnou subdoménu na *.pages.dev. Pokaždé, když do svého webu Hugo committnete nový kód, Cloudflare Pages automaticky znovu sestaví váš projekt a nasadí ho. Získáte také přístup k náhledová nasazení u nových pull requestů, takže si můžete prohlédnout, jak změny na vašem webu vypadají, než je nasadíte do produkce.

Použití konkrétní nebo novější verze Hugo

Chcete-li použít konkrétní nebo novější verzi Hugo ↗, vytvořte HUGO_VERSION proměnnou prostředí ve vašem projektu Pages > Nastavení > Proměnné prostředí. Jako hodnotu nastavte verzi Hugo, kterou chcete určit (viz Předpoklady ↗ pro minimální doporučenou verzi).

Například HUGO_VERSION: 0.128.0.

Zjistit více

Dokončením tohoto návodu jste úspěšně nasadili svůj web Hugo na Cloudflare Pages. Chcete-li začít s dalšími frameworky, podívejte se na seznam návodů pro frameworky.