Dartino main website
CSS Ruby HTML
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_includes
_layouts
codelab
getting-started
guides
images
samples
stylesheets
.gitignore
.travis.yml
AUTHORS
Gemfile
Gemfile.lock
LICENSE
README.md
_config.yml
codereview.settings
faq.old
favicon.ico
firebase.json
index.md
why.old

README.md

This repo contains the source code for the main Dartino website available at https://dartino.org.

Configuration instructions needed to make and verify edits

  1. Check that you have Ruby (Mac’s already have this):
    ruby --version

  2. We will be running everything inside bundler -- install it:
    sudo gem install bundler

  3. Initialize bundler:
    bundle install

  4. Install the Firebase CLI:
    npm install -g firebase-tools (details)

Making changes

Editing pages

The site source code is in markdown, from which the site html is generated. Edit the .md files to make changes (e.g., edit index.md to make a change to index.html).

Note that URLs are automatically prettified so that foo.md becomes /foo/, and /guides/compile.md becomes /guides/compile/.

Validating changes

Ask Jekyll to generate the site and host it locally: bundle exec jekyll serve

View the site in the browser: http://localhost:4000

Run automatic validation to check that all links etc. work:

bundle exec jekyll build
bundle exec htmlproofer _site

Publishing changes

The site is automatically deployed to Firebase hosting whenever new files are pushed to Github in the master branch. If you want to edit but not deploy, push your changes to a branch, and then merge to master when you are ready to deploy.

The Travis CI job performs the following tasks:

  1. Builds the site:
    bundle exec jekyll build

  2. Checks links (openweathermap is skipped as it fails due to throttling when called from Travis):
    bundle exec htmlproofer _site --url-ignore http://openweathermap.org/api

  3. Deploys to Firebase:
    firebase deploy

Deployment status -

You can check the Firebase deployment status on the Firebase admin page: http://go/dartino-firebase-admin