Git Product home page Git Product logo

bigbluebutton.github.io's Introduction

BigBlueButton Documentation

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.

The easy way to preview (using Docker)

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.

Ruby

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.

bigbluebutton.github.io's People

Contributors

antobinary avatar basisbit avatar bkmgit avatar capilkey avatar daronco avatar farhatahmad avatar fcecagno avatar ffdixon avatar ghazitriki avatar guileme avatar gustavotrott avatar hajar1 avatar hiroshisuga avatar jfederico avatar jiama843 avatar joshua-arts avatar kdsbrowne avatar kepstin avatar mabras avatar matiasilva avatar maximkhlobystov avatar ozhurbenko avatar pedrobmarin avatar perroned avatar prlanzarin avatar ramonlsouza avatar ritzalam avatar samuelwei avatar sualko avatar zach-chai avatar

Watchers

 avatar

Forkers

antobinary

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.