Source for the Debezium website at http://debezium.io Please log issues in our JIRA at https://issues.jboss.org/projects/DBZ/issues
Switch branches/tags
Nothing to show
Clone or download
Permalink
Failed to load latest commit information.
_config Changelog for 0.8.3.Final Sep 19, 2018
_ext DBZ-841 Keep https ing static.jboss and www.redhat.com resources Jul 30, 2018
_fonts Bootstrap-Community migration to Bootstrap 3.2 Sep 29, 2014
_layouts DBZ-841 Keep https ing static.jboss and www.redhat.com resources Jul 30, 2018
_partials DBZ-841 Keep https ing static.jboss and www.redhat.com resources Jul 30, 2018
blog Adding 0.8.3.Final release announcement Sep 19, 2018
docs Adding note on deprecated option to release log Sep 19, 2018
images [kinesis] Adding architecture overview Aug 30, 2018
javascripts DBZ-841 Keep https ing static.jboss and www.redhat.com resources Jul 30, 2018
stylesheets DBZ-841 Keep https ing static.jboss and www.redhat.com resources Jul 30, 2018
.awestruct_ignore DBZ-35 Final tweaks to content Apr 13, 2016
.gitignore add some extra house cleaning and some notes for running on docker (#10) May 31, 2016
.htaccess Use a custom 404 page (#8) Apr 15, 2016
.nojekyll DBZ-35 Added .nojekyll file Apr 13, 2016
.travis.yml Upgrade to awestruct 0.5.7 Mar 22, 2018
404.html.haml Use a custom 404 page (#8) Apr 15, 2016
CNAME DBZ-35 Added CNAME file for GitHub Pages Apr 13, 2016
CONTRIBUTING.md Support doc testing with accented chars Jul 26, 2018
Gemfile Upgrade to awestruct 0.5.7 Mar 22, 2018
Gemfile.lock AsciiDoctor upgrade Mar 22, 2018
LICENSE.txt [ORG-1732] Adding OSS license. Aug 13, 2013
README.md Adding required encoding options to README.md Sep 3, 2018
Rakefile Upgrade to awestruct 0.5.7 Mar 22, 2018
community.html.haml DBZ-119 USe proper link for user chat room Sep 9, 2016
debezium-metadata.properties DBZ-841 Using https for a few more links Sep 19, 2018
index.html.haml Adding latest Debezium version to landing page Jul 12, 2018
license.asciidoc Update documentation for 0.2.0 and 0.2.1 releases. Added blog post fo… Jun 13, 2016

README.md

Build Status License Developer chat Google Group

Introduction

This is the source code for the Debezium website. This is based on templates created by the JBoss Community using Awestruct and Bootstrap.

License

Contents of this repository are available as open source software under Apache License Version 2.0.

System Requirements

We use Docker to build the site. Be sure you have a recent version of the Docker Engine or Docker Machine.

Getting Started

1. Get the site source code

Use Git to clone the Debezium website Git repository and change into that directory:

$ git clone https://github.com/debezium/debezium.io.git
$ cd debezium.io

If you plan to submit changes, fork the Git repository on GitHub and then add your fork as a remote:

$ git remote rename origin upstream
$ git remote add origin https://github.com/<you>/debezium.io.git

Then check out the develop branch and get the latest. If you're going to make changes, create a topic branch and make the changes there.

2. Start the development webserver

In a new terminal initialized with the Docker host environment, start a Docker container that has the build environment for our website:

$ docker run -it --rm -p 4242:4242 -e LC_ALL=C.UTF-8 -e LANG=C.UTF-8 -v $(pwd):/site debezium/awestruct bash

This command tells Docker to start a container using the debezium/awestruct image (downloading it if necessary) with an interactive terminal (via -it flag) to the container so that you will see the output of the process running in the container. The --rm flag will remove the container when it stops, while the -p 4242 flag maps the container's 4242 port to the same port on the Docker host (which is the local machine on Linux or the virtual machine if running Boot2Docker or Docker Machine on OS X and Windows). The -v $(pwd):/site option mounts your current working directory (where the website's code is located) into the /site directory within the container (where Awestruct expects to find it). The bash command tells the container to start a bash shell.

Next, in the shell in the container, run the following commands to remove and then (re)install all of the Ruby libraries required by the website:

awestruct@49d06009e1fa:/site$ rm -rf ./.bundle/
awestruct@49d06009e1fa:/site$ bundle install

This should only need to be performed once. After the libraries are installed, we can then build the site from the code so you can preview it in a browser:

awestruct@49d06009e1fa:/site$ rake clean preview

4. View the site

Point your browser to http://localhost:4242 to view the site. You may notice some delay during development, since the site is generated somewhat lazily.

5. Edit the site

Use any development tools on your local machine to edit the source files for the site. For very minor modifications, Awestruct will detect the changes and may regenerate the corresponding static file(s). However, we generally recommend that you use CNTRL-C in the container shell to stop the preview server, re-run the rake clean preview command, and refresh your browser.

If you have to change the Gemfile to use different libraries, you will need to let the container download the new versions. The simplest way to do this is to stop the container (using CTRL-C), use rm -rf bundler to remove the directory where the gem files are stored, and then restart the container. This ensures that you're always using the exact files that are specified in the Gemfile.lock file.

6. Commit changes

Use Git on your local machine to commit the changes to the site's codebase to your topic branch, and then create a pull request.

7. Publish the website

Review the pull request and merge onto the develop branch. The Travis-CI build will then build the develop branch and, if successful, store the generated site in the master branch and publish to the GitHub Pages.