Version: 1.14.6

Create a New Site

In this section, we'll get our Docusaurus site up and running for local development. The process only takes a few minutes.

Docusaurus browser

Scaffold the Site#

  1. Execute the docusaurus-init command in your terminal.
docusaurus-init

The Linking dependencies... step might take a while, but it will finish eventually.

The following contents will be created in your current directory. Some example documentation pages (under docs) and blog posts (under website/blog) are included.

โ”œโ”€โ”€ Dockerfile
โ”œโ”€โ”€ docker-compose.yml
โ”œโ”€โ”€ docs
โ”‚ โ”œโ”€โ”€ doc1.md
โ”‚ โ”œโ”€โ”€ doc2.md
โ”‚ โ”œโ”€โ”€ doc3.md
โ”‚ โ”œโ”€โ”€ exampledoc4.md
โ”‚ โ””โ”€โ”€ exampledoc5.md
โ””โ”€โ”€ website
โ”œโ”€โ”€ README.md
โ”œโ”€โ”€ blog
โ”‚ โ”œโ”€โ”€ 2016-03-11-blog-post.md
โ”‚ โ”œโ”€โ”€ 2017-04-10-blog-post-two.md
โ”‚ โ”œโ”€โ”€ 2017-09-25-testing-rss.md
โ”‚ โ”œโ”€โ”€ 2017-09-26-adding-rss.md
โ”‚ โ””โ”€โ”€ 2017-10-24-new-version-1.0.0.md
โ”œโ”€โ”€ core
โ”‚ โ””โ”€โ”€ Footer.js
โ”œโ”€โ”€ package.json
โ”œโ”€โ”€ pages
โ”‚ โ””โ”€โ”€ en
โ”‚ โ”œโ”€โ”€ help.js
โ”‚ โ”œโ”€โ”€ index.js
โ”‚ โ””โ”€โ”€ users.js
โ”œโ”€โ”€ sidebars.json
โ”œโ”€โ”€ siteConfig.js
โ”œโ”€โ”€ static
โ”‚ โ”œโ”€โ”€ css
โ”‚ โ”‚ โ””โ”€โ”€ custom.css
โ”‚ โ””โ”€โ”€ img
โ”‚ โ”œโ”€โ”€ docusaurus.svg
โ”‚ โ”œโ”€โ”€ favicon
โ”‚ โ”‚ โ””โ”€โ”€ favicon.ico
โ”‚ โ”œโ”€โ”€ favicon.png
โ”‚ โ””โ”€โ”€ oss_logo.png
โ””โ”€โ”€ yarn.lock
  1. Run cd website to go into the website directory.
  2. Run npm start or yarn start.

A browser window will open up at http://localhost:3000.

Congratulations, you have just made your first Docusaurus site! Click around the pages to get a feel for it.