The official web site for Euro Team Outreach, Inc.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
data
environments
helpers
source
spec
.eslintrc.json
.gitignore
.haml-lint.yml
.rspec
.rubocop.yml
.scss-lint.yml
.tool-versions
.travis.yml
Gemfile
Gemfile.lock
LICENSE
README.md
article-template.erb
config.rb
gulpfile.js
package.json
redirect-rules.xml
yarn.lock

README.md

euroteamoutreach.org

Build Status

euroteamoutreach.org is the official web site for Euro Team Outreach, Inc., a Christian organization dedicated to the advancement of the Gospel of Jesus Christ.

This site was built using Middleman.

euroteamoutreach.org screenshot

Requirements

Setup

To get started, clone the repo, cd into it, and run the setup script.

$ bin/setup

Development

This project uses Gulp with Middleman's new external_pipeline feature introduced in v4.

# Run the development server with Gulp
$ bundle exec middleman server

# Build the site (also invokes Gulp)
$ bundle exec middleman build

Environments

Middleman has two default environments: development and production. This app is configured to run the external pipeline (Gulp in our case) in both. There are times, however, when the external pipeline should not run. Two good examples are tests and the console. We therefore define two additional environments: test and console.

Custom environments can be invoked on the command line with -e flag like so:

# Start the console in the console enviroment
$ bundle exec middleman console -e console

Code for custom environments is stored in environments/<your-custom-env>.rb. Note that custom environments can be invoked without the existence of a corresponding file in the environments/ directory. If, for example, you merely wanted to start a server without the default development configs, you could run middleman server -e <anything-here>.

For completeness, all four environments used in this app have corresponding files:

environments/
├── console.rb
├── development.rb
├── production.rb
└── test.rb

Tests

Testing is done with Rspec. Run the tests like so:

$ bin/rspec spec/

Aliases

Consider adding the following to your .bashrc or .zshrc file:

mm='bundle exec middleman'
mmb='bundle exec middleman build --clean'
mmc='bundle exec middleman console -e console'
mms='bundle exec middleman server'

Deployment

euroteamoutreach.org is currently deployed on Amazon S3. Detailed instructions are available from Amazon.

BONUS: If you deploy with Amazon, you can get a free ssl certificate for your site!

Legal

Copyright © 2018 Euro Team Outreach, Inc. Software is licensed under MIT.