← Cloudflare Pages / pages / framework-guides

Zola

Zola ↗ je rychlý generátor statických webů v podobě jediného binárního souboru se vším potřebným rovnou zabudovaným. V tomto návodu vytvoříte novou aplikaci Zola a nasadíte ji pomocí Cloudflare Pages. Použijete zola CLI k vytvoření nového webu Zola.

Nejprve nainstalovat ↗ zola CLI podle konkrétních pokynů pro váš operační systém uvedených níže:

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

brew install zola

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

choco install zola

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

scoop install zola

Správce balíčků vaší linuxové distribuce může Zola obsahovat. V takovém případě jej můžete nainstalovat přímo pomocí správce balíčků své distribuce, například pomocí pkg, spusťte v terminálu následující příkaz:

pkg install zola

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

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

Další pokyny k instalaci těchto verzí najdete v Instalační příručka Zola ↗.

Po nainstalování Zola vytvořte nový projekt spuštěním zola init příkaz v terminálu s výchozí šablonou:

zola init my-zola-project

Po spuštění zola init, budete vyzváni ke zodpovězení tří otázek:

1. Jaká je URL adresa vašeho webu? (https://example.com ↗): Toto pole zatím můžete nechat prázdné.

2. Chcete povolit kompilaci Sass? [Y/n]: Y

3. Chcete povolit zvýrazňování syntaxe? [y/N]: y

4. Chcete vytvořit vyhledávací index obsahu? [y/N]: y

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.

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

Zola je v sestavovacím prostředí Cloudflare Pages předinstalována, takže není nutná žádná další konfigurace. Volitelně můžete nastavit ZOLA_VERSION proměnnou prostředí v sekci Environment Variables (advanced) a připněte konkrétní verzi.

Například ZOLA_VERSION: 0.19.2.

Po nakonfigurování webu můžete spustit první nasazení. Měli byste vidět, jak Cloudflare Pages sestavuje váš web pomocí Zola a poté ho nasazuje.

Po nasazení webu získáte pro svůj projekt jedinečnou subdoménu na *.pages.dev.

Tuto subdoménu nyní můžete přidat jako base_url ve vašem config.toml .

Například:

# The URL the site will be built for
base_url = "https://my-zola-project.pages.dev"

Pokaždé, když do svého webu Zola odešlete commit s novým kódem, Cloudflare Pages automaticky znovu sestaví a nasadí váš projekt. 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.

Při práci s Cloudflare Pages můžete náhledová nasazení používat k testování změn před sloučením do hlavní větve. Tato náhledová nasazení ale používají odlišné URL adresy (například https://your-branch-name.my-zola-project.pages.dev), což může způsobit problémy s načítáním assetů, pokud váš base_url je pevně zadaný.

Chcete-li problém vyřešit, upravte v konfiguraci Cloudflare Pages příkaz sestavení tak, aby dynamicky nastavoval základní URL podle prostředí:

if [ "$CF_PAGES_BRANCH" = "main" ]; then zola build; else zola build --base-url $CF_PAGES_URL; fi

Tento příkaz používá:

• base_url nastavené v config.toml při sestavování z main větev
• URL adresa náhledového nasazení (automaticky poskytnutá Cloudflare Pages jako $CF_PAGES_URL) pro všechny ostatní větve

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