docusaurus/website-1.x/docs/tutorial-create-new-site.md
Sébastien Lorber 41ff9a9fd0
chore(v1): move v1 docs inside website-1.x (#3504)
* move v1 docs in website-1.x

* fix editUrl after moving v1 docs

* update crowdin source for v1 docs

* fix test after v1 config change

* migration cli should support customDocsPath (fix v1->v2 integration tests)

* fix migrationConfig.test.ts
2020-10-01 17:16:24 +02:00

2 KiB

id title
tutorial-create-new-site 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. cd to the directory of your local repository.
cd docusaurus-tutorial
  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.