/thingsboard.github.io

Documentation repository

Primary LanguageCSSApache License 2.0Apache-2.0

Instructions for Contributing to the Docs/Website

Deployment of the site locally

The below commands setup your environment for running GitHub pages locally. Any edits you make will be viewable on a lightweight webserver that runs on your local machine.

Install Ruby 2.2 or higher. If you're on Linux, run these commands:

sudo apt-get install software-properties-common
sudo apt-add-repository ppa:brightbox/ruby-ng
sudo apt-get update
sudo apt-get install ruby2.2
sudo apt-get install ruby2.2-dev
sudo gem install github-pages
sudo gem install jekyll bundler
sudo bundle install
  • If you're on a Mac, follow these instructions.
  • If you're on a Windows machine you can use the Ruby Installer. During the installation make sure to check the option for Add Ruby executables to your PATH.

Install the GitHub Pages package, which includes Jekyll:

gem install github-pages

Clone our site:

git clone https://github.com/thingsboard/thingsboard.github.io.git

Make any changes you want. Then, to see your changes locally:

cd thingsboard.github.io
bundle exec jekyll serve

Your copy of the site will then be viewable at: http://localhost:4000 (or wherever Jekyll tells you).