This repository contains the documentation for BigBlueButton located at docs.bigbluebutton.org.

This repository uses Jekyll to build the documentation site. When making changes to the docs, you should setup Jekyll to build it locally. That way, you can preview any changes before creating pull requests.

An easy way to generate the BigBlueButton documentation locally and see the effect of your changes before committing is to use Docker to run Jekyll.

docker run --rm -p 127.0.0.1:4000:4000/tcp --volume="$PWD:/srv/jekyll" -it jekyll/jekyll:3.4 jekyll serve --incremental

And you can now view the site using the URL http://localhost:4000/. If the Docker approach does not work, you can setup Jekyll using the steps below.

Note: If you're having troubles with page changes (especially page categories) not being correctly updated and symptoms similar to cached files, try to remove _site/* and re-run the docker command. The entire _site/ directory will be recreated using the local files.

To install Ruby, we suggest the use of rbenv.

But you have other options:

• Using RVM: see this page.
• Using apt packages.
• From source.

From now on, we will assume you will use rbenv, so if you decide for another method you might have to adapt some of commands in the rest of this guide.

The commands below will show you how to install rbenv. In short, this is what you will be doing:

• Install rbenv
• Install the plugin ruby-build plugin, that will actually be used to install ruby
• Install the target ruby
• Install bundler

Important: if you have RVM installed, you should remove it first!

# Install rbenv
$ git clone https://github.com/rbenv/rbenv.git ~/.rbenv
$ echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bash_profile
$ echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
$ source ~/.bash_profile

# install ruby build
$ git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

# clone this repo
$ git clone https://github.com/bigbluebutton/bigbluebutton.github.io.git

# install the targeted version of ruby
$ cd bigbluebutton.github.io
$ rbenv install
$ rbenv rehash
$ rbenv version
> 2.2.1 (set by (...)/bigbluebutton.github.io/.ruby-version)

# install bundler
$ gem install bundler
$ rbenv rehash

At this point you have the correct version of Ruby installed, now you have to install the site dependencies. Enter the directory bigbluebutton.github.io and type

bundle install

This will install all the Jekyll components. Next, type

bundle exec jekyll serve --host=0.0.0.0

Jekyll will run a server on port 4000 that lets you see a live update of the site after you make a save of any file.

 Freds-Air:bigbluebutton.github.io ffdixon$ jekyll serve
Configuration file: /Users/ffdixon/bigbluebutton.github.io/_config.yml
            Source: /Users/ffdixon/bigbluebutton.github.io
       Destination: /Users/ffdixon/bigbluebutton.github.io/_site
      Generating...
                    done.
 Auto-regeneration: enabled for '/Users/ffdixon/bigbluebutton.github.io'
Configuration file: /Users/ffdixon/bigbluebutton.github.io/_config.yml
    Server address: http://0.0.0.0:4000/
  Server running... press ctrl-c to stop.

You can now edit files locally, review changes locally, and push commits to GitHub.