marceluphd / thingsboard.github.io

Documentation repository

Instructions for Contributing to the Docs/Website

• Fork this repository
• Deploy the site locally
• Add your changes
• Create Pull Request

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 Ubuntu 18.04.2 LTS, 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 ruby
sudo apt-get install ruby-dev
sudo apt-get install libffi-dev
sudo apt-get install g++
sudo apt-get install zlib1g-dev 
sudo gem install github-pages
sudo gem install jekyll bundler

• 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.

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 install
bundle exec jekyll serve

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