← Cloudflare Pages / pages / framework-guides

Hexo

Hexo ↗ je nástroj pro generování statických webů postavený na Node.js. Mezi výhody Hexo patří rychlost, jednoduchost a flexibilita, díky nimž dokáže převádět soubory Markdown na statické webové stránky prostřednictvím Node.js.

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

Nejprve nainstalujte Hexo CLI pomocí npm nebo yarn spuštěním jednoho z následujících příkazů v terminálu:

npm install hexo-cli -g
# or
yarn global add hexo-cli

V systémech macOS a Linux můžete nainstalovat pomocí brew ↗:

brew install hexo

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.

Po nainstalování Hexo CLI vytvořte nový projekt spuštěním hexo init příkaz v terminálu:

hexo init my-hexo-site
cd my-hexo-site

Weby Hexo využívají motivy k přizpůsobení vzhledu staticky sestavených HTML webů. Hexo má automaticky nainstalovaný výchozí motiv, který najdete na stránka s motivy Hexo ↗.

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

hexo new "hello hexo"

Uvnitř hello-hexo.md, napište obsah článku v Markdownu. Štítky, kategorie a další proměnné v článku si můžete upravit podle potřeby. Podrobnosti najdete v Sekce Front Matter ↗ dokumentace Hexo ↗ 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 init
git remote add origin https://github.com/<your-gh-username>/<repository-name>
git add .
git commit -m "Initial commit"
git branch -M main
git push -u origin main

Chcete-li nasadit svůj web do Pages:

1. V dashboardu Cloudflare přejděte na Workers & Pages stránce.

   Přejděte na Workers & Pages ↗

2. Vyberte Vytvoření aplikace.

3. Vyberte Pages kartě.

4. Vyberte Importujte existující repozitář Git.

5. Vyberte nově vytvořený repozitář GitHub a poté vyberte Zahájit nastavení.

6. V Nastavení sestavení a nasazení sekci uveďte následující informace:

Po dokončení konfigurace klikněte na Save and Deploy tlačítko. Měli byste vidět, jak Cloudflare Pages instaluje hexo 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 Hexo 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.

Některá témata nebo pluginy pro Hexo mají další požadavky na konkrétní verze Node.js. Chcete-li pro Hexo použít konkrétní verzi Node.js:

1. Přejděte do svého projektu Pages.
2. Přejděte na Nastavení > Proměnné prostředí.
3. Nastavte proměnnou prostředí NODE_VERSION a hodnotu požadované verze Node.js (například 14.3).

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