← Cloudflare Pages / pages / framework-guides

VitePress

VitePress ↗ je generátor statických webů ↗ (SSG) určený pro tvorbu rychlých webů zaměřených na obsah. VitePress vezme váš zdrojový obsah napsaný v Markdown ↗, aplikuje na něj šablonu a generuje statické stránky HTML, které lze snadno nasadit kdekoli.

V tomto průvodci vytvoříte nový projekt VitePress a nasadíte ho pomocí Cloudflare Pages.

Součástí VitePress je průvodce nastavením v příkazovém řádku, který vám pomůže vytvořit základní projekt.

Chcete-li vytvořit nový projekt VitePress, spusťte v terminálu následující příkaz:

npx vitepress@latest init

Průvodce nastavením se mimo jiné zeptá, do kterého adresáře chcete uložit nový projekt. Ujistěte se, že jste v adresáři projektu, a poté nainstalujte vitepress závislost pomocí následujícího příkazu:

npm i -D vitepress@latest

Nakonec vytvořte .gitignore soubor následujícím obsahem:

node_modules
.vitepress/cache
.vitepress/dist

Tento krok zajistí, že se do git repozitáře projektu (který nastavíme v dalším kroku) nedostanou zbytečné soubory.

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 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í sekci vyberte VitePress jako Přednastavení frameworku. Váš výběr poskytne následující informace:

Po nakonfigurování webu můžete spustit první nasazení. Cloudflare Pages nainstaluje vitepress, závislosti projektu a sestaví 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 projektu VitePress committnete a pushnete 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.

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