Browse files

Merge branch 'master' into documentation-configuration-chapter

  • Loading branch information...
M4LuZ committed Jun 11, 2018
2 parents 167dec7 + 3fe49aa commit 2f3a6b1010cd30060ea7cbdfedca7fcdc2491c8a
Showing with 77 additions and 7 deletions.
  1. +77 −7 docs/
@@ -3,13 +3,83 @@ id: documentation
title: Documentation
The documentation is build with [Docusaurus](
Please check out their *Getting Started* guide for installation.
The documentation is built with [Docusaurus](
Please check out their [*Getting Started* guide for installation](
### Building the site
This page assumes that you have [yarn]( installed.
Docusaurus is also able to operate with [npm](
For the related npm commands, please check out the documentation of Docusaurus.
Switch to the *website* folder via `cd website`.
Then run the *local* webserver via `yarn start` or `npm start`.
## Writing a new documentation article
This depends on what you prefer or what you have installed.
See [npm]( and [yarn]( for reference.
1. Add your documentation to the `/docs` folder as `.md` files, ensuring you have the proper [header]( in each file.
The most straightforward header would be the following, where `id` is the link name (e.g., `docs/intro.html`) and the `title`, is, of course, the title of the browser page.
id: intro
title: Getting Started
My new content here..
2. If your new documentation article should appear in the sidebar add it to the `website/sidebars.json` file so that your documentation is rendered in a sidebar.
> If you do not add your documentation to the `sidebars.json` file, the docs will be rendered, but they can only be linked to from other documentation and visited with the known URL.
3. Place assets, such as images, in the `website/static/` folder.
4. Run the site to see the results of your changes.
cd website/
yarn install
yarn start
# Navigate to http://localhost:3000
## Writing a new blog post
To publish a new post on the blog, create a file within the blog folder with a formatted name of ``.
The post date is extracted from the file name.
For example, at `website/blog/`:
author: Frank Li
title: Introducing Docusaurus
Lorem Ipsum...
## Building the documentation site
The website is located in the `website/` folder and depends on various dependencies.
For this we go into the `website/` folder, install the dependencies and start the local web server:
cd website/
yarn install
yarn start
After the `start` command, your browser should open the address [http://localhost:3000/](http://localhost:3000/) and show you the website.
## Publishing the documentation site
If you are ready, we should publish your new work.
While publishing we generate static HTML and push it to the [LANSuite repositories `gh-pages` branch](
This branch is responsible for the content behind [](
Now let's publish:
USE_SSH=true \
yarn run publish-gh-pages
> The specified `GIT_USER` must have push access to the repository of LANSuite.

0 comments on commit 2f3a6b1

Please sign in to comment.