Docusaurus

Dit is een voorbeeld van hoe je een statische site kunt opzetten met Docusaurus op Kinsta’s Statische Site Hosting vanuit een GitHub repository.

Docusaurus is een statische sitegenerator die gespecialiseerd is in het produceren van documentatiewebsites die eenvoudig te bouwen zijn met minimale codeerervaring, zodat je het direct kunt gebruiken. Meer informatie is beschikbaar op de Docusaurus website.

Je kunt deze Quickstart template ook gebruiken op Kinsta’s Applicatie Hosting zonder extra configuratie. Als je Applicatie Hosting gebruikt, kun je het Start commando leeg laten voor het webproces omdat Kinsta automatisch het vereiste commando detecteert tijdens de eerste deployment.

Vereisten

• Kinsta’s Quickstart templates worden opgeslagen en beheerd in GitHub; daarom heb je een GitHub account nodig om ze te openen.
• Je moet een MyKinsta account aanmaken om de applicatie te deployen.

Een Docusaurus statische site deployen

1. Log in op GitHub en maak een nieuwe repository van deze template (Use this template > Create a new repository): Kinsta – Hello World – Docusaurus.
2. Klik in MyKinsta op Statische Sites > Site toevoegen > selecteer GitHub, klik op Verbind git provider > Autoriseren, en log in op je GitHub account.
3. Kies de Hello World Docusaurus repository, klik op Doorgaan, en voer het volgende in bij de Build instellingen:
   • Build commando: npm run build
   • Node versie: 18.16.0
   • Publish directory: build

Tijdens het deploymentproces installeert Kinsta automatisch de dependencies die zijn gedefinieerd in je package.json bestand. De site is beschikbaar zodra de deployment is voltooid en de Docusaurus standaardpagina wordt geladen op de URL van je site.

Deployment levenscyclus

Telkens wanneer een deployment wordt gestart (door een applicatie aan te maken of opnieuw te deployen als gevolg van een inkomende commit), wordt het commando npm build uitgevoerd, gevolgd door het commando npm start.