INTEGRITY Dokumentace

← Cloudflare Workers / workers / framework-guides / web-apps / more-web-frameworks

Docusaurus

Začít z CLI: Vytvořte základ projektu Docusaurus na Workers a vyberte si šablonu.

npm create cloudflare@latest -- my-docusaurus-app --framework=docusaurus

Nebo jen nasaďte: Vytvořte dokumentační web pomocí Docusaurus a nasaďte ho na Cloudflare Workers, včetně předem nastaveného CI/CD a náhledů.

Nasaďte na Workers

Co je Docusaurus?

Docusaurus ↗ je open-source framework pro tvorbu, nasazování a údržbu dokumentačních webů. Je postaven na Reactu a nabízí intuitivní způsob tvorby statických webů zaměřených na dokumentaci.

Docusaurus je navržen tak, aby byl snadno použitelný a přizpůsobitelný, což z něj dělá oblíbenou volbu pro vývojáře a organizace, které chtějí rychle vytvářet dokumentační weby.

Nasaďte nový projekt Docusaurus na Workers

  1. Vytvořte nový projekt pomocí create-cloudflare CLI (C3).

    npm create cloudflare@latest -- my-docusaurus-app --framework=docusaurus --platform=workers

    Co se děje v zákulisí?

    Když spustíte tento příkaz, C3 vytvoří nový adresář projektu, zahájí Oficiální instalační nástroj Docusaurus ↗, a nakonfiguruje projekt pro Cloudflare. Poté nabídne možnost okamžitě nasadit vaši aplikaci na Cloudflare.

  2. Vývoj lokálně.

    Po vytvoření projektu spusťte v adresáři projektu následující příkaz, který spustí lokální vývojový server.

    npm run dev

  3. Nasaďte svůj projekt.

    Váš projekt lze nasadit na subdoména *.workers.dev nebo Custom Domain, z místního počítače nebo libovolného systému CI/CD (včetně Workers Builds).

    K sestavení a nasazení projektu použijte následující příkaz. Pokud používáte službu CI, nezapomeňte odpovídajícím způsobem upravit svůj „deploy command“.

    npm run deploy

Nasaďte existující projekt Docusaurus na Workers

Pokud máte statický web

Pokud je váš projekt Docusaurus celý předrenderovaný (což obvykle bývá), postupujte takto:

  1. Přidejte konfigurační soubor Wrangler.

    V kořenovém adresáři projektu vytvořte konfigurační soubor Wrangler s následujícím obsahem:

    	{
		"name": "my-docusaurus-app",
		// Update to today's date
		// Set this to today's date
		"compatibility_date": "2026-08-28",
		"assets": {
			"directory": "./build"
		}
	}
    name = "my-docusaurus-app"
# Set this to today's date
compatibility_date = "2026-08-28"

[assets]
directory = "./build"

    Co dělá tato konfigurace?

    Klíčovou částí této konfigurace je assets pole, které Wrangleru říká, kde má hledat vaše statická aktiva. V tomto případě Wrangleru říkáme, aby hledal ve složce ./build adresář. Pokud se vaše aktiva nacházejí v jiném adresáři, aktualizujte directory hodnotu podle toho. Podívejte se na další možnosti konfigurace pro assets.

    Všimněte si také, že zde není žádné main pole v této konfiguraci, protože obsluhujete jen statické assety, takže pro rendering na vyžádání (SSR) není kód Workeru potřeba.

  2. Vytvořte a nasaďte svůj projekt.

    Svůj projekt můžete nasadit do *.workers.dev subdoména nebo vlastní doména z vašeho lokálního počítače nebo libovolného systému CI/CD (včetně Workers Builds). Sestavení a nasazení proveďte pomocí následujícího příkazu. Pokud používáte službu CI, nezapomeňte odpovídajícím způsobem upravit svůj "deploy command".

    npx docusaurus build
    npx wrangler@latest deploy

Použijte bindings s Docusaurus

Bindings představují způsob, jak propojit váš projekt Docusaurus s dalšími službami Cloudflare, a umožňují tak ve vaší aplikaci ukládat a načítat data.

Díky bindings lze vaši aplikaci plně integrovat s Cloudflare Developer Platform a získat tak přístup k výpočetnímu výkonu, úložišti, AI a dalším službám.

Bindings

Přístup k výpočetnímu výkonu, úložišti, AI a dalším službám.