JBCNConf Website

This repository holds the public website for the JBCNConf, the Java conference is organized by the Barcelona JUG every summer.

Building the website

The site is build with the Jekyll and published with GitHub pages. To run it you need to setup a basic Ruby (up to 2.4.x) environment.

For Linux and MacOS, the recommended way to install Ruby is with RVM. For Windows you can use RubyInstaller or the chocolately package.

Once Ruby is installed, install the required gems with the following command.

bundler install

❗	The required `ffi` gem is not yet fully supported in Ruby 2.5.x. If you want to build the site with Ruby 2.5.x, skip `bundler` and install the gems manually with: gem install ffi --force -v 1.9.18 gem install jekyll

Some pages use Asciidoctor to generate the HTML. adoc sources can be found under tools directory.

To convert them:

Install Asciidoctor Ruby gem gem install asciidoctor
Render each file with the --no-header-footer option (-s in short) specifying the source and target path.

Here is the list of the current generated files and their commands:

$ asciidoctor tools/diversity.adoc -aidprefix -aidseparator=- -s -o 2019/_includes/diversity/diversity-terms.html

❗	Note that a real line break required two line-breaks, single ones are ignored. Files are not converted automatically. If changes in the sources are made, remember converting them and adding the generated html in the commit.

Just fork the repo, open a shell, place yourself in the root and run

$ bundle exec jekyll serve

of just

$ jekyll serve

This will start a local embedded server on http://localhost:4000. The server will stay up and self-update automatically.

You can publish the site in your cloned repo to see the result of your changes.

First, enable GitHub pages in your forked repository and set it to publish to the gh-pages branch.