- Make sure all the dependencies are installed (use you fav package manager)
# Install dependencies
$ npm install
- Run your dev server:
# Start the site
$ npm start
Edit docs by navigating to docs/
and editing the corresponding document:
docs/gitstart.md
---
id: page-needs-edit
title: This Doc Needs To Be Edited
---
Edit me...
For more information about docs, click here
Edit blog posts by navigating to blog
and editing the corresponding post:
blog/gitstart.md
---
id: post-needs-edit
title: This Blog Post Needs To Be Edited
---
Edit me...
For more information about blog posts, click here
- Create the doc as a new markdown file in
/docs
, exampledocs/gitstart.md
:
---
id: newly-created-doc
title: This Doc Needs To Be Edited
---
My new content here..
Note: Ensure the file name and the id value do not include non-url safe characters i.e. '*'.
- Refer to that doc's ID in an existing sidebar in
sidebar.json
:
// Add newly-created-doc to the Getting Started category of docs
{
"docs": {
"Getting Started": [
"quick-start",
"newly-created-doc" // new doc here
],
...
},
...
}
For more information about adding new docs, click here
- Everything is managed via
docusaurus.config.ts
- Index are managed via
_category_.json
in each folder