This site was built using Middleman.
To get started, clone the repo, cd into it, and run the setup script.
# Run the development server with Gulp $ bundle exec middleman server # Build the site (also invokes Gulp) $ bundle exec middleman build
Middleman has two default environments:
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:
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
Testing is done with Rspec. Run the tests like so:
$ bin/rspec spec/
Consider adding the following to your
mm='bundle exec middleman' mmb='bundle exec middleman build --clean' mmc='bundle exec middleman console -e console' mms='bundle exec middleman server'
cmoproject.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!
I got started with Middleman thanks to Chris Toomey of thoughtbot. His excellent introductory video on building static sites with Middleman and the accompanying sample application provided much of the inspiration for building this site.
Upgrading this site to v4 of Middleman was made much easier thanks to Craig Dennis. His YouTube video and accompanying GitHub repo clearly illustrate how to use Middleman with Gulp Starter as the asset pipeline.
The Carpathian Mountain Outreach logo is a trademark of Euro Team Outreach, Inc.
Copyright © 2021 Euro Team Outreach, Inc. Software is licensed under MIT.