mirror of
https://github.com/facebook/docusaurus.git
synced 2025-04-30 18:58:36 +02:00
f18e07343c
* docs: fix typo for `docs` folder * docs: request change for #1484 * Update api-doc-markdown.md
57 lines
2.5 KiB
Markdown
57 lines
2.5 KiB
Markdown
---
|
|
id: site-preparation
|
|
title: Site Preparation
|
|
---
|
|
|
|
After [installing Docusaurus](getting-started-installation.md), you now have a skeleton to work from for your specific website. The following discusses the rest of the Docusaurus structure in order for you to prepare your site.
|
|
|
|
## Directory Structure
|
|
|
|
As shown after you [installed Docusaurus](getting-started-installation.md), the initialization script created a directory structure similar to:
|
|
|
|
```bash
|
|
root-directory
|
|
├── docs
|
|
│ ├── doc1.md
|
|
│ ├── doc2.md
|
|
│ ├── doc3.md
|
|
│ ├── exampledoc4.md
|
|
│ └── exampledoc5.md
|
|
└── website
|
|
├── 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
|
|
├── sidebars.json
|
|
├── siteConfig.js
|
|
└── static
|
|
```
|
|
|
|
### Directory Descriptions
|
|
|
|
* **Documentation Source Files**: The `docs` directory
|
|
contains example documentation files written in Markdown.
|
|
* **Blog**: The `website/blog` directory contains examples of blog posts written in markdown.
|
|
* **Pages**: The `website/pages` directory contains example top-level pages for the site.
|
|
* **Static files and images**: The `website/static` directory contains static assets used by the example site.
|
|
|
|
### Key Files
|
|
|
|
* **Footer**: The `website/core/Footer.js` file is a React component that acts
|
|
as the footer for the site generated by Docusaurus and should be customized by the user.
|
|
* **Configuration file**: The `website/siteConfig.js` file is the main
|
|
configuration file used by Docusaurus.
|
|
* **Sidebars**: The `sidebars.json` file contains the structure and order
|
|
of the documentation files.
|
|
|
|
## Preparation Notes
|
|
|
|
You will need to keep the `website/siteConfig.js` and `website/core/Footer.js` files but may edit them as you wish. The value of the `customDocsPath` key in `website/siteConfig.js` can be modified if you wish to use a different directory name or path. The `website` directory can also be renamed to anything you want it to be.
|
|
|
|
However, you should keep the `website/pages` and `website/static` directories. You may change the content inside them as you wish. At the bare minimum, you should have an `en/index.js` or `en/index.html` file inside `website/pages` and an image to use as your header icon inside `website/static`.
|