This is a Jekyll site configured to be build and served through GitHub Pages.

Because we let GitHub Pages do the Jekyll builds the website will be updated automatically after pushing commits or merging pull requests.

• The homepage for the site is index.html.
• The guides are a Jekyll collection in the _guides folder.
• To archive (or draft) a guide move it to _archives/*/.
• Use the main file of each guide for the intro.
• Use the sections front matter to include additional content from files relative to the guide, preferably in a subfolder with the same name. Make sure to start these files with _ to prevent Jekyll for outputting them as stand-alone pages.
• Store guide assets in the same folder as the markdown you need it in and include them by their filename. You can also use relative paths to re-use images from other guides.
• Start links to other guides with / and the /docs baseurl will be prepended for you.
• Start links to site assets with /assets and the /docs baseurl will be prepended for you.
• Use blockquotes (>) to create callouts for important notes.
• If you do a lot of edits please use a local build to preview.

1. Install Ruby 2.0.0 or higher

2. Install Bundler:

   $ gem install bundler

3. Install Jekyll using Bundler:

   $ bundle install

4. Install Node.js and NPM.

5. Install front-end and development dependencies:

$ npm install

4. Run Webpack, build the local Jekyll site and watch for changes:

   $ npm run dev

NOTE: Running npm install will overwrite the git pre-commit hook to execute npm run webpack and append the production version of js/bundle.js it produces.

• Require and use any JS libraries you need in _app/main.js.
• Import any Sass files you need in css/main.scss.
• Override Bootstrap variables in _sass/_variables.scss.
• Edit styles in _sass/_base.scss or break out to additional Sass files to keep it organized.
• Store layout assets in assets folder.
• Edit layouts in the _layouts folder.
• All layouts should inherit the default layout.
• Any meta data should be stored in the _data folder, not _config.yml.

Some content we source directly from elsewhere, e.g. the MQTT API Reference.

1. Follow the previous section to install NPM and dependencies.

2. Install Gulp:

   sudo npm i --global gulp

3. Run the pull task:

   gulp pull

To source more content from elsewhere edit gulpfile.js.