Website

This website is built using Docusaurus 2, a modern static website generator.

Installation

yarn install

Local Development

yarn start

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

Build

yarn build

This command generates static content into the build directory and can be served using any static contents hosting service.

Deployment

GIT_USER=<Your GitHub username> USE_SSH=true yarn deploy

If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.

Create a new page

Follow this doc.

Create a new section

Follow this doc.

Three structure

├── babel.config.js          // contains configurations to Babel, a JavaScript compiler
├── blog                     // contains the blog Markdown files.
├── doc                      // contains the Markdown files for the Froggit docs.
├── docs                     // contains the Markdown files for the docs.
├── docusaurus.config.js     // a config file containing the site configuration.
├── package.json             // a Docusaurus website is a React app. You can install and use any npm packages
├── README.md                   
├── sidebars.js              // used to specify the order of documentations in the sidebar
├── src                      // non-documentation files like pages or custom React components
│   ├── components           // contains React reusable Components and it's CSS modules
│   ├── css                  // global CSS
│   └── pages                // pages Components
├── static                   // static directory
│   └── img                  // images folder
│ 

More details on Project structure:

• /blog/ - You can delete the directory if you do not want/need a blog. More details can be found in the blog guide
• /docs/ - Customize the order in sidebars.js. More details can be found in the docs guide
• /src/ - You don't have to strictly put your non-documentation files in here but putting them under a centralized directory makes it easier to specify in case you need to do some sort of linting/processing
  • /src/pages - More details can be found in the pages guide
• /static/ - Any contents inside here will be copied into the root of the final build directory
• /docusaurus.config.js - This is the equivalent of siteConfig.js in Docusaurus v1