Find me on GitHub


Fix font loading over https Aug 9, 2016

Unfortunately, several of the Morea "cerulean" style themes (i.e. cerulean_green, cerulean_red, etc.) were loading the Open Sans font using the http: protocol. Now that GitHub uses https: by default, sites built using those themes were not displaying the Open Sans font correctly when retrieved from a domain. (Instead, the Open Sans font fails to load and the site falls back to the use of the Times Roman font.)

We just published a fix to these themes in the core repo so that Open Sans will be loaded correctly regardless of the protocol (http: or https:) used.

To get the fix, cd into your Morea top-level directory, then invoke the script to incorporate the corrected code into your local copy of these themes.

Then republish your site and all should be well.

Other themes (SuperHero, SpaceLab, etc.) did not have this bug and so you should not have noticed this problem if you were using them.

Our apologies for the inconvenience!

Gallery refresh Mar 4, 2016

We've neglected the Gallery page for quite a while, so we spent a few minutes today updating it with links to additional sites using Morea---some in quite interesting ways! Take a look and let us know if you'd like your site included.

Breadcrumbs! Oct 23, 2015

The Morea team is delighted to announce the addition of breadcrumbs as a standard feature of Morea sites.

Breadcrumbs are located just below the navbar and provide an indication of where you are in the site. For example, this page shows you are at the page "WODs: An athletic approach to software engineering", inside the "Introduction" module, which is inside the "Modules" page, which is below the "Home" page.

Upgrade instructions

To update your current Morea site to support breadcrumbs with minimal hassle, please do the following:

  1. Inspect your current master/src/_layouts/default.html. Do you add any navbar items (or anything else) to that file? If so, copy the added lines to a text buffer someplace and remember where they were located in your default.html file. If you didn't add anything, great.

  2. Invoke You will get a merge conflict in default.html. Don't panic.

  3. Edit your master/src/_layouts/default.html file. Make it identical to this default.html file.

  4. If you had added navbar links or something to your original default.html file, then edit the master/src/_layouts/core.html file to put them back in. This will look almost exactly like your old default.html file. Add back in whatever customizations you saved to your text buffer in Step 1.

  5. There is a slight chance your master/_config.html file also has a merge conflict. If so, just edit it back to your original version. (the changes are just the addition of comments.)

That's it. Now invoke and see if everything looks OK. If not, fix it. If you can't fix it, send me an email.

Now invoke to publish your cool new breadcrumbs to the world!

morea-watch.rb Oct 10, 2015

The Morea team is delighted to announce the release of morea-watch.rb, a ruby script you can use instead of and which will automatically stop and restart whenever files in the morea directory change.

Morea-watch.rb was developed by Dan Port. Please check it out and let us know what you think!

Morea Lintui Sep 22, 2015

The Morea team is delighted to announce the release of morea-lintui, which combines "lint" content validation with a refreshingly retro terminal user interface (tui) for manipulating the structure of Morea sites.

Morea-lintui was developed by Henri Casanova. Please check it out and let us know what you think!

Morea Version 2.0 release Jun 18, 2015

The Morea team is delighted to announce the 2.0 release. Enhancements include:

  • Improved user interface
  • Improved calendar integration
  • Module meta-data
  • Google analytics
  • LaTeX equations
  • Eliminate dependency on Python
  • Page overviews
  • ... and much more!

Please see the release notes for details and a migration guide for current users.

Morea: Now with Google Analytics! Apr 1, 2015

Cam Moore has contributed an include file that makes it easy for you to track the use of pages in Morea sites with Google Analytics. To learn more, see the documentation.

Release 1.1.0: New themes for the new year Jan 6, 2015

The Morea team is happy to inform you of several updates to the user interface:

  • The themes have been updated to use the latest release of Bootstrap (3.3.1).

  • Morea themes are based on Bootswatch. We have incorporated two new Bootswatch themes into Morea: paper and sandstone.

  • In response to user request, we have created four new themes based upon cerulean: cerulean_green, cerulean_brown, cerulean_purple, and cerulean_red. If you like cerulean, but are tired of blue, try one of these!

  • To save space in the NavBar for additional menu items, we have removed the "Home" link and made the site title in the NavBar into a link.

  • Also in response to user request, we have made the icons in the module page into links to their corresponding module. Apparently everyone wants to click on them, so we might as well let them.

To use these features, set the basic-template as an upstream repository and merge into your master branch. You can do this using the morea-merge-upstream script.

Note that you may well get merge conflicts, but these should be easy to address.

If the merge conflict involves changes to the "Qux" module that you've deleted in your site, do the following to re-delete the directory:

% cd master/src/morea
% git rm -r qux

If the merge conflict involves changes to your master/src/css/style.css file, or master/src/_layouts/default.html file, then simply view those files in your editor, edit to resolve the conflict and remove the conflict indicator lines, and save your changes.

Happy course design in 2015 and don't hesitate to let us know if you encounter problems with these enhancements.

Morea Framework on Stack Overflow Aug 15, 2014

The Morea Framework now has its own tag (morea-framework) on StackOverflow.

Please use StackOverflow for technical support questions, and the Morea Framework GitHub Issues to post bug reports and enhancement requests.

The morea-framework tag is monitored, so you should get a response to your query within a day.

Virtual Box and Vagrant for Morea Jul 16, 2014

Users have reported problems installing Ruby and Jekyll under Windows 8. We have created a Vagrant "box" that simplifies the process of running a virtual Unix environment on Windows with Python, Ruby, git, and Jekyll pre-installed.

For details on how to run Morea using Vagrant, see the Vagrant QuickStart page.

Non-Morea markdown files Jun 25, 2014

The Morea generator now allows you to create markdown files inside the morea/ directory with the extension .markdown. These files are processed into HTML by Jekyll, but will not appear as a module, outcome, reading, experience, or assessment. This is useful for creating (for example) quizzes in markdown format that are kept with other module files.

For more details, see the non-morea markdown section of the user guide.

To obtain this update, run the script.

Ignore directories Jun 21, 2014

The latest version of basic-template contains an update to the MoreaGenerator.rb file which now ignores any directories inside the morea/ directory named _ignore. This allows you to store private data inside the morea/ directory if you (for example) which to associate tests or other files with the module.

For more details, see the private data section of the user guide.

To obtain this update, run the script.

QuickStart process redesigned Jun 17, 2014

The original QuickStart procedure directed you to fork the basic-template repository in order to initialize your own course website.

Unfortunately, GitHub does not allow forks of public repositories (like basic-template) to be made private.

The QuickStart page has now been modified to avoid the use of forking. Course repositories created using the new procedure can be made private.

Morea Version 1.0 release May 22, 2014

The Morea team is delighted to announce the 1.0 release. This release constitutes a "minimum viable product" with sufficient functionality and documentation for users to begin building their own course websites using the framework.

To use these features, set the basic-template as an upstream repository and merge into your master branch.

Subscribe to news via RSS