| .. | ||
| docs | ||
| src | ||
| static | ||
| .gitignore | ||
| babel.config.js | ||
| build.sh | ||
| docusaurus.config.js | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| sidebars.js | ||
| tsconfig.json | ||
| yarn.lock | ||
BigBlueButton Docs
These docs are automatically built using Docusaurus 2 and GitHub Actions (see deploy-docs.yml).
Local Development
To test build the docs locally you can either use yarn or npm.
$ yarn install # install docusaurus and dependencies
$ yarn start # start local dev server
The last command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
There is also a script build.sh that goes through all branches of the repository
and adds all release branches that have a docusaurus.config.js-file as versions
to the docs.
Note that you can not have uncommited local changes before you run /build.sh,
otherwise git will refuse to change branches.
This step is optional and if you don't run it, docusaurus will only build the
currently checkout out version which is recommended for local development
(building all the versions locally can lead to problems with the live
updates when using yarn start).
Build
If you only want to build the docs you can run:
$ yarn clear # ensure cached content is not interfering with your changes
$ yarn build
This command generates static content into the build directory
and can be served using any static contents hosting service.