Skip to content

QutEcoacoustics/research-blog

Repository files navigation

research.ecosounds.org (QutBioacoustics/research-blog)

This is the backing repository for the https://research.ecosounds.org website.

This repository is a Jekyll blog that is currently hosted by Netlify

Feedback

If there is a problem with any of the content on the ecosounds website you can:

Conventions & Changes

All changes made, especially to content, should be done via pull request. All pull requests should be proofed.

We prefer the use of Markdown source files.

Images may be stored in the repo. Videos should be hosted on YouTube. Audio can be hosted on soundcloud.

Large sets of images should be stored on another provider (e.g. DropBox, ownCloud, onedrive, etc...)

Brand guidelines

  • Ecosounds: use when referring to our website
  • www.ecosounds.org: use when referring to our website. Never use ecosounds.org, or Ecosounds.org.
  • Use QUT Ecoacoustics or QUT Ecoacoustics Research Group when referring to our research group

Test locally

Local testing needs a working install of ruby (version 2.3 or greater).

  • For Windows environments the Ruby Installer project is a great project; install Ruby 2.3.1 (x64) and DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe.
  • Mac comes with ruby installed, but it might not be a recent version. Test the version with ruby --version. If it is too old, use rvm to install the new version. This command will install rvm and use it to install the latest ruby \curl -sSL https://get.rvm.io | bash -s stable --ruby. For details see How to Install Ruby on Mac OS X with RVM.

As of 2018 you may need to install MSYS2 as well for Windows environments: https://msys2.github.io/

  1. Open a prompt and cd to the checkout directory.

  2. Then to update dependencies:

    $ bundle install
    $ bundle update
  3. Then start the server:

    $ bundle exec jekyll serve --watch
  4. In your browser, go to: http://127.0.0.1:4000/

  5. Use ctrl+c in your prompt to kill the server