RandomSec/docs
Florian Giroud 4b6106a386
Run UI tests in continuous integration (#3393)
* Fixed flaky tests

* Refactored ui_test commans-line, added documentation

* Attempt to build a workflow with cypress

* Fixed CI UX tests build

* Changed cyprss actions for pull-request

* Merged Cypress workflow into the regular PR target workflow

* Refactored Github workflows to include Cypress Tests

* Revert Ci build to pull_request_target
2020-12-15 20:34:15 +01:00
..
docs Run UI tests in continuous integration (#3393) 2020-12-15 20:34:15 +01:00
src Style modifications in docusaurus docs to fix #3329 (#3365) 2020-11-29 16:25:58 +01:00
static Normalize case of documentation image extensions 2020-12-04 09:01:09 +01:00
.gitignore begin Docusaurus 2 migration (#2799) 2020-06-29 08:45:24 +02:00
docusaurus.config.js Update to docusaurus-2.0.0-alpha.64 to fix security vuln in dependency (#3261) 2020-10-16 20:49:57 +02:00
package.json Update to docusaurus-2.0.0-alpha.64 to fix security vuln in dependency (#3261) 2020-10-16 20:49:57 +02:00
README.md begin Docusaurus 2 migration (#2799) 2020-06-29 08:45:24 +02:00
sidebars.js Docs > Expressions (#3264) 2020-12-02 13:08:00 +01:00
yarn.lock Update to docusaurus-2.0.0-alpha.64 to fix security vuln in dependency (#3261) 2020-10-16 20:49:57 +02:00

How to build these docs

We use Docusaurus 2 for our docs, a modern static website generator.

Requirements

Assuming you have Node.js installed (which includes npm), you can install Docusaurus with:

You will need to install Yarn before you can build the site.

npm install -g yarn

Installation

Once you have installed yarn, navigate to docs directory & set-up the dependencies.

cd docs
yarn

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.