- Fork this repository
- Deploy the site locally
- Add your changes
- Create Pull Request
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).