← Cloudflare Pages / pages / framework-guides

Jekyll

Jekyll ↗ je open-source framework pro tvorbu webů založený na Markdownu se šablonami Liquid. V tomto návodu vytvoříte novou aplikaci Jekyll a nasadíte ji pomocí Cloudflare Pages. Použijete jekyll CLI k vytvoření nového webu Jekyll.

Instalace Jekyll

Jekyll je napsán v Ruby, což znamená, že budete potřebovat funkční instalaci Ruby, například rbenv, pro instalaci Jekyllu.

Chcete-li nainstalovat Ruby do počítače, postupujte podle rbenv pokyny k instalaci ↗ a vyberte novější verzi Ruby spuštěním rbenv příkaz v terminálu. Nainstalovaná verze Ruby se použije i pro konfiguraci nasazení Pages pro vaši aplikaci.

rbenv install <RUBY_VERSION> # For example, 3.1.3

Po nainstalování Ruby můžete nainstalovat jekyll Ruby gem:

gem install jekyll

Vytvoření nového projektu

Po nainstalování Jekyll můžete vytvořit nový projekt spuštěním jekyll new ve svém terminálu:

jekyll new my-jekyll-site

Vytvořte základní index.html v nově vytvořené složce, aby váš web získal obsah:

<!doctype html>
<html>
	<head>
		<meta charset="utf-8" />
		<title>Hello from Cloudflare Pages</title>
	</head>
	<body>
		<h1>Hello from Cloudflare Pages</h1>
	</body>
</html>

Volitelně můžete pro svůj nový web Jekyll použít motiv, pokud chcete začít s kvalitním výchozím vzhledem. Například minimal-mistakes ↗ motiv má "Počínaje jekyll new" ↗ sekci, která vám pomůže přidat motiv na váš nový web.

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.

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

Pokud migrujete stávající projekt Jekyll na Pages, ověřte, že váš Gemfile je commitnutý jako součást vaší kódové báze. Pages se podívá do vašeho Gemfile a spustí bundle install a nainstalujte požadované závislosti projektu, včetně jekyll gem.

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í	`jekyll build`
Adresář sestavení	`_site`

Přidejte proměnná prostředí která odpovídá verzi Ruby, kterou používáte lokálně. Nastavte ji jako RUBY_VERSION na vašich náhledových i produkčních nasazeních. Níže 3.1.3 se použije jako příklad:

Proměnná prostředí	Hodnota
`RUBY_VERSION`	`3.1.3`

Po nakonfigurování webu můžete spustit první nasazení. Měli byste vidět, jak Cloudflare Pages instaluje jekyll, závislosti projektu a sestavuje web, než ho nasadí.

Po nasazení webu získáte pro svůj projekt jedinečnou subdoménu na *.pages.dev. Pokaždé, když do svého webu Jekyll 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.

Zjistit více

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