Skip to content

agileiowa/dsmagile-web

Repository files navigation

dsmagile web site

Build Status

Public website for dsmAgile conference

Local Dev

Install rbenv to to use the version of ruby defined in .ruby-version.

Run: bundle exec rake will start the jekyll server in watch mode.

Update Library

Run bundle update to update all the gems to the latest version.

How to publish

Run bundle exec rake site:publish This will generate the site locally and overwrite the gh-pages branch.

We use a git submodule for the _site folder. If you build it and experience problems, run git submodule update --init to reset the _site/ folder.

Issue: New commits in _site folder

If you see this when you run git status:

On branch master
Your branch is ahead of 'origin/master' by 1 commit.
  (use "git push" to publish your local commits)
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

	modified:   _site (new commits)

no changes added to commit (use "git add" and/or "git commit -a")

This means somebody else has published to the gh-page branch. You need to update your submodule.

Run this command from the root directory: git submodule update _site/

Issue: Upgrade Ruby

*** Pre-condition:*** You are using rbenv

  • Update the version for the project in .ruby-version
  • See list of available Ruby distributions: rbenv install -l
  • Install the version of Ruby you need (e.g. 2.3.7): rbenv install 2.3.7
  • Install Bundler: gem install bundler
  • Update gems: bundle install

Tips for debugging

Show collections by jsonify and escaping them within a <pre> tag.

     <pre>
        site: {{ site | jsonify | escape }}
        page: {{ page | jsonify | escape }}
        layout: {{ layout | jsonify | escape }}
        content: {{ content | jsonify | escape }}
        paginator: {{ paginator | jsonify | escape }}
        sessions: {{ sessions | jsonify | escape }}
        speakers: {{speakers_new | jsonify | escape }}
    </pre>

About

Public website for dsmAgile conference

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •